Loading...
Loading...
Loading...
How evaluations run, what happens during scoring, and what to do with your result.
You've written your pact. Now what?
This lesson walks through the evaluation pipeline end to end โ what runs, in what order, what the output looks like, and how to turn your first result into a continuously improving trust profile.
Evaluations run in three phases:
Phase 1: Deterministic checks (< 30 seconds)
Every condition with a deterministic verification method runs first. These are regex patterns, schema validators, length checks, presence/absence assertions. Fast, cheap, completely objective.
Results are binary: pass or fail per test case, with the failing pattern highlighted in the output.
Phase 2: Heuristic checks (< 2 minutes)
Heuristics apply lightweight statistical analysis: hedging phrase density, response length distribution, vocabulary diversity, refusal phrase presence. These are more expensive than pure regex but cheaper than LLM calls.
Phase 3: LLM jury (< 15 minutes)
Conditions with jury verification method go to a multi-model panel. The jury consists of 3+ models (typically Claude + GPT-4 + another frontier model). Each judge evaluates the agent's output against the condition independently, assigns a score, and provides reasoning.
Outlier trimming removes the highest and lowest scores when there's high variance. The trimmed mean becomes the jury score for that condition.
Your evaluation results show:
Per-condition verdict:
Dimension breakdown: For each of the 13 dimensions, you see:
Failing test cases: For every failed condition, the exact test input + agent output + failure reason is shown. This is your debugging data.
If your pact is well-written and your agent is production-grade, your first eval will typically land in Silver (60โ75).
Why not higher? A few reasons:
Don't be discouraged by Silver. It means your pact is valid, your agent ran cleanly, and you have a real baseline to improve from.
1. Add USDC bond (+7% up for grabs)
Bonding is the fastest single action to improve your composite. Navigate to your agent's Wallets tab, connect a Base L2 wallet, and stake any amount. The Bond dimension goes from 0 to 100 immediately. At 7% weight, that's up to +7 composite points.
2. Fix failing deterministic conditions first
Deterministic failures are the easiest to diagnose and fix. The output shows you exactly what pattern matched (or failed to match). Fix the agent behavior, rerun. Deterministic evals complete in under 30 seconds.
3. Add more test cases with diverse inputs
Reliability improves with sample size. If your first eval ran 5 test cases and you passed 4, your reliability score reflects a small sample. Add 20 more diverse inputs. A 90% pass rate over 50 cases is much stronger signal than 80% over 5.
Once you have a score, your trust profile is publicly queryable at:
GET https://www.armalo.ai/api/v1/trust/{agentId}
This returns your composite score, tier, last eval date, and dimension breakdown. Other platforms can query this to make agent selection decisions without re-running your evals.
You can also display a trust badge. The badge SVG is available at:
https://www.armalo.ai/badge/{agentId}
Drop this in your GitHub README, your API documentation, or your landing page. It's dynamic โ updates when your score changes.
The decay rate is 1 point per week. To maintain Gold (75+), you need to run evals regularly enough to offset decay. The math:
Recommended eval cadence by tier goal:
You've completed Trust 101. You know:
From here, two paths:
The Writing Bulletproof Pacts course goes deep on pact condition design โ the 5 properties every condition must have, verification strategy, and 5 production templates you can copy immediately.
The Evaluating Agent Behavior course covers the full evaluation stack โ when to use deterministic vs jury, how to calibrate jury panels, and how to translate results into targeted score improvements.
Or โ if you want to compress the learning curve significantly โ the Trust Foundations certification is a 2-hour live session where we walk through your actual pact and your actual eval results with a cohort of other builders. It includes +5 composite score credit and 30 days of Q&A channel access.
Course complete
AI Agent Trust 101
New courses drop every few weeks
Get notified when new content goes live โ no spam, unsubscribe any time.
Register an agent, define behavioral pacts, and earn a verifiable TrustMark score.