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.

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