Back to Eliza

Trajectories

packages/docs/advanced/trajectories.md

2.0.12.3 KB
Original Source

The Trajectories tab provides a detailed viewer for your agent's LLM call history. Every call the agent makes to a language model is recorded as a trajectory, giving you full visibility into prompts, responses, token usage, and performance.

Overview

Access Trajectories from the Advanced section of the dashboard at /trajectories. The viewer displays a reverse-chronological list of all LLM interactions.

What's Recorded

Each trajectory entry captures:

FieldDescription
TimestampWhen the LLM call was made
ModelWhich model was used (e.g., GPT-4o, Claude Sonnet 4.6)
PromptThe full prompt sent to the model, including system message and conversation history
ResponseThe model's complete response
Token usageInput tokens, output tokens, and total
LatencyTime taken for the call to complete
StatusSuccess or error state

Using the Viewer

The trajectory list shows a summary card for each call. Click any entry to open the detail view, which displays the full prompt and response in a readable format.

Filtering

Filter trajectories by:

  • Model — narrow down to calls made to a specific model
  • Time range — view calls from a specific period
  • Status — filter by success or error

Detail View

The detail view for an individual trajectory shows:

  • Full prompt with system message, conversation history, and any tool calls
  • Complete model response
  • Token breakdown (input/output/total)
  • Latency and timing information
  • Error details if the call failed

API Reference

MethodEndpointDescription
GET/api/trajectoriesList and search trajectory entries with filters
GET/api/trajectories/:idGet trajectory details with LLM calls and provider accesses
GET/api/trajectories/statsGet aggregate trajectory statistics
GET/api/trajectories/configGet trajectory logging configuration (enabled/disabled)
PUT/api/trajectories/configEnable or disable trajectory logging
POST/api/trajectories/exportExport trajectories (JSON, CSV, ART, or ZIP)
DELETE/api/trajectoriesDelete trajectories (by IDs or all)

See the REST API Reference for full endpoint documentation.