Agentic AI Notebook
Phase 19

Trajectory Evaluation

~2 min read

Concept & How It Works

  • Key points are in the visual diagram above.

Why Does It Exist?

Two agents may reach the same answer via different paths; one may have hallucinated intermediate steps or taken 10x more API calls. Trajectory eval catches inefficient or unsafe paths.

Real-World Analogy

Trajectory eval reviews game replay move-by-move — winning isn't enough if you sacrificed all your pieces to do it.
Loading diagram...

Visual Workflows

What is Trajectory Evaluation?

Loading diagram...

Example

Scenario

Gold trajectory: search → read_doc → answer. Agent does search → search → search (redundant) → answer. Trajectory eval flags inefficiency despite correct final answer.

Solution

In Eval Engineering & Observability, apply Trajectory Evaluation to this scenario: Gold trajectory: search → read_doc → answer. Identify the inputs, run the technique, validate the output, and note one thing you would monitor in production.

Practice Task

Do this before moving to the next module — reading alone is not enough.

Open the Code Walkthrough below and run it locally. Change one parameter related to Trajectory Evaluation (e.g. model, temperature, top_k, or tool name), observe the difference in output, and write 2–3 sentences explaining what changed.

Code Walkthrough

Highlighted lines show where Trajectory Evaluation happens in the code.

Trajectory Evaluation
1def step_efficiency(trajectory, gold_min_steps):  # define a reusable function2    tool_steps = [s for s in trajectory if s["type"] == "tool"]  # key line for Trajectory Evaluation3    return len(tool_steps) <= gold_min_steps * 1.5  # return the result

Commands to Remember

Commands to Remember

  • pip install langsmith # trace and evaluate LLM runs
  • pip install arize-phoenix # open-source LLM observability
  • pip install opentelemetry-api opentelemetry-sdk # distributed tracing

Common Mistakes

  • Treating Trajectory Evaluation as a black box without evaluation
  • Ignoring cost and latency in production
  • Skipping error handling for trajectory evaluation

Cheat Sheet

Quick recap — the most important points from this module.

Cheat Sheet

quick ref
  • Trajectory Evaluation
  • Edit Distance
  • Step Efficiency
  • Gold Trajectory