Awesome Testing

Evaluation lesson 03 · Specify oracles and traces

What must be observable for a verdict to be trustworthy?

Shared evaluation case · deterministic fictional data

Northstar Support Copilot. A fictional ecommerce support copilot retrieves versioned policies and synthetic customer records, drafts replies, and proposes sandboxed account actions. It cannot send or mutate anything without current authorization and exact human approval.

01 · Smallest useful mechanism

Observe the final state and the path that produced it.

Exact fields and database state can use deterministic assertions. Open-ended qualities need rubrics. Tool proposals, policy decisions, effects, observations, retries, and approvals belong in an inspectable trace so a correct-looking answer cannot hide an unauthorized action.

The evaluator should inspect system events and state transitions, not private chain-of-thought.

02 · Experiment

Test the prediction

Deterministic fictional fixture

The specify oracles and traces workbench uses versioned, inspectable teaching data. It does not claim to reproduce live customer traffic or model behavior.

Evidence workbench

Build the evaluation argument

Select the evidence needed to distinguish two identical replies produced by different trajectories.

Fixture northstar-traces-v1

03 · Decision artifact

Write the evaluation argument another reviewer can audit

Use synthetic or properly governed data. Keep critical failures visible instead of compressing them into one score.

  1. Claim

    State which success and safety claims need deterministic or rubric-based oracles.

  2. Evaluation design

    Specify final-state predicates and an event schema with stable operation IDs.

  3. Release evidence

    Provide three golden traces, expected effects, permitted sequences, and failure labels.

Your learning artifact

Write the argument you would defend

Stored only in this browser. No account required; course reset does not delete it.

04 · Check your understanding

Which evidence best detects an unauthorized refund that was later reversed?

Theory notes and sources

Optional referenceDeep dive / reference chapterOpen the complete essay, diagrams, mathematics, exercises, glossary, and sources when you want more depth.

Next: With system observability in place, we can isolate whether retrieval found authoritative evidence and whether the answer actually used it.