Aborta las llamadas de herramientas o LLM en curso para una ejecución sin cancelar la sesión, por lo que el agente continúa. Envíe step_number para interrumpir una sola llamada con nombre; omita el cuerpo para interrumpir todas las llamadas actualmente en curso. El resultado de la respuesta informa exactamente lo que sucedió: &"aborted" (algo en curso se detuvo), &"armed" (nada en curso; armado para la siguiente llamada de la ejecución, pending=true), &"already_armed" (ya existía un armado no caducado; el TTL no se extendió), &"noop_terminal" (la ejecución ya es terminal, posiblemente en otra réplica), &"in_flight_elsewhere" (el registro de paso duradero muestra la llamada en curso pero no en esta réplica OE; aquí no se abortó nada, y un backstop con alcance a los pasos estampados detiene la llamada en el despacho si ese despacho se completa en esta réplica; nunca puede interceptar una llamada posterior), o &"noop" (un número de paso con nombre no coincidió con nada en vuelo). Idempotente: las solicitudes repetidas son seguras.
Parámetros de query
-
ID del espacio de trabajo propietario de la ejecución, necesario para enrutar la interrupción al OE de ese espacio de trabajo.
Respuestas
-
Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.
-
OK
Se permiten propiedades adicionales.
Se permiten propiedades adicionales.
-
Solicitud incorrecta
-
No autorizado
-
No encontrado
Se permiten propiedades adicionales.
Se permiten propiedades adicionales.
-
Entidad de solicitud demasiado grande
-
Puerta de enlace incorrecta
Se permiten propiedades adicionales.
Se permiten propiedades adicionales.
curl \
--request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/executions/{execution_id}/interrupt' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"step_number": 42
}'
{
"step_number": 42
}
{
"detail": "This operation is not available in API version 2026-09-20-preview.",
"error": 406,
"errorCode": "OPERATION_NOT_IN_API_VERSION",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}
{
"detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
"error": 406,
"errorCode": "UNACCEPTABLE_MEDIA_TYPE",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}
{
"detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
"error": 406,
"errorCode": "UNSUPPORTED_API_VERSION",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}
{
"detail": "This operation is not available in API version 2026-09-20-preview.",
"error": 406,
"errorCode": "OPERATION_NOT_IN_API_VERSION",
"parameters": [
"Accept"
],
"reason": "Not Acceptable"
}
{}
{}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{}
{}
{
"code": "string",
"error": "string",
"success": true
}
{
"code": "string",
"error": "string",
"success": true
}
{}
{}