What trace format and grader hooks make intake runs easy to score?
Log each run as an event trace, then grade final state, required checks and handover content with separate hooks against the answer key, with reset between tasks.
Score runs from two artefacts: the final case state and the event trace.
**Trace record (JSONL, one event per line):** `run_id`, `task_id`, `case_id`, `step`, `actor`, `action`, `args`, `result`, `at`. Include read actions such as `lookup_party` and `search_cases`, since missed lookups are a process signal.
**Graders as separate functions:**
- `grade_outcome(final_state, key)`: compares status, queue and outstanding items. Returns pass or fail, with a reason code such as `wrong_queue` or `false_complete`. - `grade_process(trace, key)`: checks that each entry in `expected_checks` appears before `route_case`, and flags forbidden actions. - `grade_links(final_state, key)`: checks duplicate and prior-case links the agent was expected to set. - `grade_note(note, record)`: checks handover claims against record fields. This can be rule-based first, with model-based grading only for open text, and a human audit of a subset.
**Reset.** Restore `cases` and `events` from a snapshot identified by a `snapshot_id` and a seed, then verify a hash of the starting tables before each task. Store the hash in the run record.
**Splits.** Request a development split with keys visible and a held-out split with keys withheld, so tuning does not contaminate the test.
Ask a pilot to supply reference grader code, so your harness and the provider's keys agree on reason codes from the first run.
Separate graders for outcome, process and notes give diagnostic scores, and a deterministic reset makes results comparable across agents and versions.
- Audience:
- Evaluation teams
- Content type:
- Integration
- Buyer question:
- How to evaluate it
Content release: r-a220eb6e099b243b
Related questions
- What should you check when you receive an intake sample?
- What evaluation hooks should a simulated intake environment expose?
- What failure modes should an intake evaluation measure?
- How can a buyer judge the quality of generated intake data?
- How does a graded run expose a skipped completeness check?
- How can a buyer inspect the quality of a generated intake environment?