Cancelar a execução de um agente salvo
Cancela uma execução em fila localmente antes do envio, ou encaminha o cancelamento para a resposta do gateway vinculada a ela. Execuções vinculadas com falha localmente e com um snapshot do gateway ativo ou ausente são verificadas upstream antes do cancelamento; trabalho terminal genuíno nunca é relabelado como cancelado. Snapshots frescos de gateway incompletos são apresentados como incompletos em leituras subsequentes, preservando o erro do conector e o timestamp de conclusão, mesmo se o cancelamento retornar 409. Cancelamentos repetidos são idempotentes. Retorna 409 se a submissão ainda não tiver uma resposta vinculada ou se um resultado terminal genuíno já tiver prevalecido. Usa o escopo de mutação da organização, equipe e usuário delegado da execução; acesso de leitura do operador não concede acesso ao cancelamento. Chamadores com chave de API também precisam de write:responses para cancelamento vinculado e de read:responses para inspecionar execuções com falha local ou reconciliar uma corrida de conclusão.
Autorizações
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>.
Cabeçalhos
Optional external end-user identifier forwarded by the API gateway.
Resposta
A execução do agente foi cancelada. A execução do gateway para assíncrona após o cancelamento ser aceito.
agent.run A versão da configuração do agente que esta execução foi executada. Nulo para execuções criadas antes da versionação.
x >= 1Os resultados terminais permanecem distintos: cancelled é solicitado pelo chamador; incomplete significa que um limite ou interrupção interrompeu a execução. gateway_response.incomplete_details registra o motivo, incluindo max_tokens ou max_tool_calls. Linhas falhadas armazenadas com um desses resultados de gateway são serializadas com o resultado de gateway, preservando qualquer erro do conector e o timestamp de conclusão.
queued, submitting, completed, failed, cancelled, incomplete Valor JSON arbitrário.
Valor JSON arbitrário.
Valor JSON arbitrário.
Valor JSON arbitrário.