Saltar para o conteúdo principal
GET
Obter Orquestração
Retorna o estado de execução completo de uma orquestração, incluindo seu status atual, cada etapa executada, a saída final, custo acumulado e o recibo do log de transparência uma vez concluído. Sonde este endpoint para acompanhar o progresso da orquestração. Para atualizações em tempo real, configure um webhook para eventos orchestration.completed e orchestration.failed.

Resposta

string
Identificador de orquestração.
string
O agente que executou a orquestração.
string
O identificador da definição do fluxo de trabalho, se aplicável.
string
Status atual: running, completed, failed, ou timeout.
array
Array ordenado de etapas de execução. Cada etapa contém: - step_number (inteiro) — Índice sequencial da etapa (base 1) - action (string) — Ação executado (por exemplo, llm_inference, tool_call, decision, guardrail_check) - result (string) — Resumo do resultado da etapa - duration_ms (inteiro) — Etapa tempo de execução em milissegundos
object
Saída final da orquestração. Presente apenas quando o status é completed.
number
Custo total acumulado de todas as inferências LLM e chamadas de ferramentas em centavos de dólar americano.
string
Recibo do log de transparência ancorando a orquestração concluída. Presente apenas quando o status é completed.
string
Carimbo de data/hora ISO 8601 quando a execução começou.
string
Carimbo de data/hora ISO 8601 quando a execução terminou. Presente apenas para estados terminais.
object
Detalhes do erro se o status for failed. Contém code e message.

Autorizações

X-API-Key
string
header
obrigatório

Chave de API para autenticação máquina a máquina

Parâmetros de caminho

orchestrationId
string<uuid>
obrigatório

Identificador de orquestração

Resposta

Detalhes da orquestração

orchestration_id
string<uuid>
workflow_id
string<uuid>
agents
string<uuid>[]
parameters
object
status
enum<string>
Opções disponíveis:
pending,
running,
completed,
failed,
cancelled
steps
object[]
results
object
receipts
string<uuid>[]
created_at
string<date-time>