Obter Orquestração
curl --request GET \
--url https://api.truthlocks.com/v1/orchestrate/executions/{orchestrationId} \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/orchestrate/executions/{orchestrationId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/orchestrate/executions/{orchestrationId}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/orchestrate/executions/{orchestrationId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"orchestration_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agents": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"parameters": {},
"status": "pending",
"steps": [
{
"step_id": "<string>",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"action": "<string>",
"status": "<string>",
"result": {},
"started_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z"
}
],
"results": {},
"receipts": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Orquestrações e Fluxos de Trabalho
Obter Orquestração
Recupere o resultado completo da execução de uma orquestração, incluindo detalhes em nível de etapa e rastreamento de custos.
GET
/
v1
/
orchestrate
/
executions
/
{orchestrationId}
Obter Orquestração
curl --request GET \
--url https://api.truthlocks.com/v1/orchestrate/executions/{orchestrationId} \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/orchestrate/executions/{orchestrationId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/orchestrate/executions/{orchestrationId}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/orchestrate/executions/{orchestrationId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"orchestration_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"workflow_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agents": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"parameters": {},
"status": "pending",
"steps": [
{
"step_id": "<string>",
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"action": "<string>",
"status": "<string>",
"result": {},
"started_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z"
}
],
"results": {},
"receipts": [
"3c90c3cc-0d44-4b50-8888-8dd25736052a"
],
"created_at": "2023-11-07T05:31:56Z"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}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
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 milissegundosCusto total acumulado de todas as inferências LLM e chamadas de ferramentas em centavos de dólar americano.
Recibo do log de transparência ancorando a orquestração concluída. Presente apenas
quando o status é
completed.Carimbo de data/hora ISO 8601 quando a execução terminou. Presente apenas para estados terminais.
Resposta
Detalhes da orquestração

