Execução
Ler uma execução
Devolve uma execução do alcance do chamador, com a resposta do agente, os tokens gastos e as ferramentas chamadas. É por aqui que se recupera a resposta de uma execução cujo cliente perdeu a conexão. Fora do alcance responde 404, igual a uma que não existe.
Autorização
bearer runs:readAutorizaçãoBearer <token>
Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: runs:read
Parâmetros de caminho
run_id*string
Id da execução
Corpo da resposta
application/json
application/json
curl -X GET "https://example.com/runs/string"{ "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978", "completed_at": "2019-08-24T14:15:22Z", "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407", "error": null, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "input_message_id": "4761b30e-fe7a-4d53-b53b-ed5be1e65a17", "latency_ms": 0, "model": "string", "origin": "api", "persisted": true, "reply": { "content": "string", "message_id": "d7d9d9fd-478f-40e6-b651-49b7f19878a2" }, "started_at": "2019-08-24T14:15:22Z", "status": "running", "tenant_id": 0, "tool_calls": [ { "arguments": {}, "call_id": "string", "is_error": true, "name": "string", "result": "string", "status": "started" } ], "usage": { "cached_tokens": 0, "input_tokens": 0, "output_tokens": 0, "total_tokens": 0 }}