Skip to main content

ToolTraceCallSummary

Lightweight summary of one client-tools backend tool invocation.

call_iduuidrequired

UUID of the tool invocation. This is the same id used by the async call-result callback.

run_iduuidrequired

UUID of the agent thinking loop that produced the tool call.

clientClientrequired

Client namespace handled by the tool backend.

toolToolrequired

Tool name invoked by the agent.

statusStatusrequired

Current or final call status.

Possible values: [running, succeeded, failed]

result_statusResult Statusrequired

Tool-specific result status; empty while the call is still running.

deliveryDeliveryrequired

Whether the async result was delivered back to the main backend; empty while running.

Possible values: [``, delivered, delivery_failed]

agent_idAgent Idrequired

ID of the agent (a configured AI assistant / bot persona) this record belongs to.

log_req_idLog Req Idrequired

Request-log correlation id from the tool backend, if available.

started_atdate-timerequired
finished_at objectrequired

Finish time in UTC, or null while the call is still running.

anyOf
date-time
duration_msDuration Msrequired

Total call duration in milliseconds; zero while running.

ToolTraceCallSummary
{
  "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "run_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "client": "string",
  "tool": "string",
  "status": "running",
  "result_status": "string",
  "delivery": "",
  "agent_id": 0,
  "log_req_id": "string",
  "started_at": "2024-07-29T15:51:28.071Z",
  "finished_at": "2024-07-29T15:51:28.071Z",
  "duration_ms": 0
}