Cancelar una ejecución de agente guardado
Cancela una ejecución en cola localmente antes de despacharla, o reenvía la cancelación a su respuesta enlazada de gateway. Las ejecuciones enlazadas fallidas localmente con una instantánea de gateway activa o ausente se comprueban aguas arriba antes de la cancelación; el trabajo terminal genuino nunca se vuelve a etiquetar como cancelado. Las instantáneas de gateway incompletas recientes se presentan como incompletas en lecturas posteriores, preservando el error del conector y la marca de tiempo de finalización, incluso si cancel devuelve 409. La cancelación repetida es idempotente. Devuelve 409 si la solicitud aún no tiene una respuesta enlazada o si ya ha prevalecido un resultado terminal genuino. Usa el ámbito de mutación de organización, equipo y usuario delegado de la ejecución; el acceso de lectura del operador no concede acceso de cancelación. Los llamadores con clave de API también necesitan write:responses para la cancelación enlazada y read:responses para inspeccionar ejecuciones fallidas localmente o reconciliar una carrera de finalización.
Autorizaciones
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
Optional external end-user identifier forwarded by the API gateway.
Respuesta
La ejecución del agente cancelada. La ejecución de Gateway se detiene asíncronamente después de que se acepta la cancelación.
agent.run 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.
x >= 1Los resultados terminales siguen siendo distintos: cancelado significa que lo solicitó el llamador; incompleto significa que un límite o una interrupción detuvo la ejecución. gateway_response.incomplete_details registra la razón, incluyendo max_tokens o max_tool_calls. Las filas fallidas almacenadas con uno de estos resultados de gateway se serializan con el resultado de gateway, conservando cualquier error del conector y la marca de tiempo de finalización.
queued, submitting, completed, failed, cancelled, incomplete Valor JSON arbitrario.
Valor JSON arbitrario.
Valor JSON arbitrario.
Valor JSON arbitrario.