0
Phase 11

Trajectory Evaluation

~2 min read

Concept & How It Works

    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 Agent Evaluation & 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