Cancela a ferramenta a bordo ou as chamadas LLM para uma execução sem cancelar a sessão, para que o agente continue. Enviar step_number para interromper uma única chamada nomeada; omita o corpo para interromper todas as chamadas atualmente em andamento. O resultado da resposta relata exatamente o que aconteceu: "aborted" (algo no voo foi parado), "armado" (nada na fuga; armada para a próxima chamada da execução, pending=true), "already_armed" (já existia um braço não expirado; o TTL não foi estendido), "noop_termal" (a execução já é terminal, possivelmente em outra réplica), "in_flight_elsewhere" (o registro de etapa durável mostra a chamada em andamento, mas não nessa réplica do OE; nada foi abortado aqui, e um backstop com escopo para as etapas marcadas interrompe a chamada no despacho se esse despacho for concluído nessa réplica — ele nunca poderá capturar uma chamada posterior ), ou "noop" (um step_number nomeado não corresponde a nada no voo). Idempotente: solicitações repetidas são seguras.
parâmetros de query
-
ID do espaço de trabalho proprietário da execução, necessário para direcionar a interrupção para o OE desse espaço de trabalho
Respostas
-
Versão de API não permitida ou malformada, uma operação indisponível no contrato publicado selecionado ou uma representação inaceitável (incluindo parâmetros de tipo de mídia não suportados ou SSE excluído). Falhas existentes de autenticação, autorização e limite de taxa têm precedência.
-
OK
Propriedades adicionais são permitidas.
Propriedades adicionais são permitidas.
-
Solicitação inválida
-
Não autorizado
-
Não encontrado
Propriedades adicionais são permitidas.
Propriedades adicionais são permitidas.
-
Entidade solicitante muito grande
-
Gateway incorreto
Propriedades adicionais são permitidas.
Propriedades adicionais são permitidas.
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
}{}{}