Skip to main content
POST
Python (SDK)

Autorizaciones

Authorization
string
header
requerido

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Encabezados

X-On-Behalf-Of
string

Optional external end-user identifier forwarded by the API gateway.

Parámetros de ruta

agent_id
string
requerido

Cuerpo

application/json
input
requerido
Required string length: 1 - 20000
conversation
any

Valor JSON arbitrario.

previous_response_id
string
context_management
object[]

Estrategias de gestión del contexto a aplicar durante la generación de respuestas por el agente. Soporta la compactación, que resume el historial de conversación anterior cuando el contexto excede un umbral de tokens.

stream
boolean
predeterminado:false

Cuando es true, la pasarela genera eventos delta por token para esta ejecución, de modo que el endpoint de eventos transmite salida incremental en lugar de solo elementos y límites de ciclo de vida. La ejecución sigue ejecutándose en segundo plano y este endpoint sigue devolviendo el registro de ejecución en cola.

metadata
object

Respuesta

Ejecución en cola.

object
enum<string>
requerido
Opciones disponibles:
agent.run
id
string
requerido
agent_id
string
requerido
agent_version
integer | null
requerido

La versión de configuración del agente contra la que se ejecutó esta ejecución. Nulo para ejecuciones creadas antes de la versionación.

Rango requerido: x >= 1
status
enum<string>
requerido
Opciones disponibles:
queued,
submitting,
completed,
failed
input
any
requerido

Valor JSON arbitrario.

conversation
any | null
requerido

Valor JSON arbitrario.

previous_response_id
string | null
requerido
metadata
object | null
requerido
gateway_response_id
string | null
requerido
gateway_response
any | null
requerido

Valor JSON arbitrario.

error
any | null
requerido

Valor JSON arbitrario.

created_at
string<date-time>
requerido
completed_at
string<date-time> | null
requerido