trustmodel_trace_start
Initiate a new agent-trace capture session, returning a trace ID for logging steps and finalizing to create an evaluation run.
Instructions
Open a new agent-trace capture session. Returns a trace_id that must be passed to every trustmodel_trace_step and the final trustmodel_trace_finalize. Capture steps (thoughts, tool calls, tool results, responses) as your agent executes; finalize when done to upload + auto-create an evaluation run.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | What the agent is trying to achieve. Required; feeds the evaluation run. | |
| name | Yes | Display name for the evaluation run (shown in TrustModel UI). | |
| metadata | No | Free-form passthrough metadata stored inside the trace file. | |
| user_query | No | Original user prompt that triggered the run, if different from `goal`. | |
| agent_model | No | Underlying LLM the agent is using (e.g. 'gpt-4o', 'claude-sonnet-4-5'). | |
| agent_framework | Yes | Framework the agent is built with (e.g. 'langchain', 'crewai', 'claude-code', 'custom'). | |
| expected_outcome | No | Optional description of the expected outcome. |