What reset, trace and scoring hooks does an intake evaluation pack need?
Describes environment reset by seed, a fixed tool set, JSONL trace output with state hashes and a component scorer, so agent runs can be repeated and compared.
For evaluation, an intake pack needs hooks that let a buyer run an agent, score it and repeat the run. A scoped pack can provide:
- **Reset.** `reset(task_id, seed)` restores the environment to the task's `initial_state_ref`: queue contents, document store, policy version and any scripted customer replies. - **Tool actions.** A fixed set such as `get_case`, `open_item`, `run_check`, `request_information`, `route_case`, `escalate` and `add_note`. Each call is logged with arguments and the resulting state change. - **Trace output.** JSONL with `task_id`, `step`, `tool`, `args`, `state_before_hash` and `state_after_hash`. - **Scorer.** A function taking the trace and the final state and returning component scores such as `classification_correct`, `missing_items_f1`, `queue_correct`, `reason_code_match`, `unnecessary_requests` and `ordering_violations`. - **Success criteria.** Defined per task in the pack, for instance that the case reaches `routed` with the correct queue and no request is raised for an item already supplied.
Because state hashes are logged, a reseller can check that two runs from the same seed produce the same starting state. That tells you the environment is deterministic enough to compare agents. Ask for the scorer source or a documented specification so your customers can audit how scores are computed.
Keep the scorer version in your manifest. If the scorer changes, earlier results are not comparable.
Seeded resets, logged state hashes and a documented scorer let you confirm that two agent runs start from the same state.
- Audience:
- Licensed resellers
- 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?