All docs
EvaluationDecide what to measureChecks and gatesdashboard

Checks and gates

Every pass/fail check — grounding, safety, quality, agent behaviour — its rule, its default, and where to change it.

What you'll have

Know why each answer passed or failed, and set the Grounding gate and promotion gates to match what your application is for.

You'll need
  • An experiment with some evaluations in it

How it works

Scores
  1. Every dimension, every answer
  2. Every claim with a verdict
  3. Every session, for agents
Checks
  1. One rule per check
  2. Pass, borderline, fail or N/A
  3. Where to correct each failure
Gates
  1. Grounding gate: Strict or Document review
  2. Safety limits
  3. Promotion gates for A/B

Scores tell you how an answer did on a scale. Checks turn them into decisions: every answer — and, for agents, every session — passes, fails, sits on the borderline, or is not applicable to a check. The experiment's Overview leads with the checks that are failing, and each failing case says where to correct it. Gates are the bars those decisions are made against.

This page lists every check and gate, its rule, its default, and where to change it.

Answer checks — every evaluation

CheckPasses whenNot applicable whenBar and where to change it
GroundingEvery claim is supported by the documents (Strict), or no claim is proven wrong (Document review)No reference_materials were sentThe Grounding gate — Overview tab
Hallucination-freeNo claim is contradicted or proven wrong by the documents — a mismatched number, a figure from the wrong document, a wrong calculation or comparison conclusionNo reference_materialsPer-claim decision; no setting
SafetyEvery safety dimension (toxicity, bias, harmful content, privacy, misinformation, inappropriate language, violence, adult content) is at or under its risk limitNo safety dimensions were scoredRisk limit 0.5 per dimension by default. Stricter toxicity and bias limits, or a minimum safety score, are available on request
Quality floorThe overall score across the six categories is at least the floorShown on A/B experiments only — in Observe it is a soft average, not a decision70 by default; Promotion gates → minimum overall score on the Edit page

A passing answer within 0.05 (5 points) of a bar is marked borderline, so a near-miss is visible before it becomes a failure.

The Grounding gate

Strict (default)Document review
ForRAG and question answering — an unsupported answer is the failureInvoices, contracts, clinical summaries, financial statements, filings — anything checked against documents
Fails onAny claim not supported by the documentsOnly claims the documents prove wrong
A claim the documents neither confirm nor contradictFailBorderline — flagged for review
A possible contradiction (one model's doubt, not proof)FailBorderline — flagged for review
Summaries of verified findings, framing and conclusionsChecked like any claimSummaries pass on verified findings; framing and conclusions are not counted

Set it on the experiment's Overview tab, under Grounding gate. It works in Observe as well as on A/B experiments (draft or paused), and the promotion decision is recomputed at once. Answers already in are re-read under the new gate (nothing is re-scored); new answers are scored with its rules. How each claim is judged under it is in Score a document review.

Agent checks — every session

These need a session (session_id) and, for most, agent steps (agent_name):

CheckPasses whenNeeds
Tool correctnessEvery expected tool was called with the expected argumentsexpected_tools on agent steps
TrajectoryEvery expected step was taken, in the expected orderexpected_tools on agent steps
No loopsNo repeated tool call or stagnant, near-duplicate reasoning stepA session with at least two agent steps
Agents agreeNo two agents' outputs contradict each otherA session with at least two agents
Final answer uses sub-agentsThe final answer reflects every upstream agent's output and contradicts noneA final step marked is_aggregator=True
Within policyNo tool call outside the allowed listallowed_tools
observe(prompt=task, response=out, session_id=session, agent_name="router",
        tools_called=[{"name": "search", "arguments": {"q": query}}],
        expected_tools=[{"name": "search"}],
        allowed_tools=["search", "fetch_invoice"])

The full setup is in Score a multi-agent trace.

Promotion gates — A/B experiments

Before a variant can be promoted, it must clear three gates. They are set on the experiment's Edit page under Promotion gates:

GateDefaultMeans
Minimum overall score70The variant's mean overall score across the six categories
Grounded answers90%The share of its claim-checked answers that pass the Grounding check — under the experiment's Grounding gate, so a Document review experiment counts proven errors, not unconfirmed claims
Minimum sample size357Evaluations needed before any winner is named — 95% confidence, ±5% margin

Clearing the gates makes a variant eligible; whether its difference is real is the next question — see Read the verdict.

What Observe uses

An Observe experiment has no variants to promote, so it shows the answer and agent checks only: the Grounding gate is the one setting it takes, and Safety uses its default limits. Upgrade to an experiment to set promotion gates and compare variants.