Repository navigation
π§ͺ Agent Testing Goes Mainstream
v0.4.0 made it possible to test an agent in 30 seconds. v0.5.0 teaches you how to test well.
π Agent Testing Pyramid
The definitive mental model for testing AI agents β 3 layers, 3 cadences, 1 framework.
βββββββββββββββ
β Quality β Nightly / Release
β Assertions β LLM-as-Judge
βββββββββββββββ€
β Flow β Push to Main
β Assertions β Multi-step Replay
βββββββββββββββ€
β Single-Step β Every PR
β Assertions β Tool / Output / Token
βββββββββββββββ
π« 8 Agent Testing Anti-Patterns
| # | Anti-Pattern | What It Misses |
|---|---|---|
| 1 | εͺθ΅°ι³ε ι (Happy Path Only) | Edge cases silently break |
| 2 | εͺη―θΎεΊδΈηε·₯ε · (Output-Only) | Wrong tool, right words |
| 3 | ζΉδΊ Prompt ε°±η₯η₯· (Prompt-and-Pray) | No regression guard |
| 4 | ε樑εεΉ»θ§ (Single Model Fallacy) | Works on GPT, fails on Claude |
| 5 | Token η²η (Token Blindness) | Budget blown in production |
| 6 | εΏ«η §ε€±εΏη (Snapshot Amnesia) | Can't reproduce failures |
| 7 | δΊΊθ CI (Manual QA) | Slow, inconsistent, skipped |
| 8 | θ¦ηηθ‘¨ζΌ (Coverage Theater) | Tests that assert nothing |
π Ecosystem Integrations
| Platform | Guide |
|---|---|
| Vercel AI SDK | 12-line integration |
| Claude Code | Custom agent testing |
| LangChain / CrewAI | Zero-refactor integration |
ποΈ Dashboard: Guided Failure Triage
No more staring at a red FAIL badge wondering what to do.
- What failed β clear summary
- Why β plain-language explanation
- How to fix β assertion-type-specific suggestions (26 types)
- Expected vs Actual β side-by-side diff
π Dashboard: Quality Trends
SVG-based line chart on the main dashboard. Track correctness, faithfulness, safety, and more across 7 / 14 / 30 days.
π GitHub Marketplace Action
One YAML block. Zero config.
- uses: agentbench/action@v0.5
with:
api-key: ${{ secrets.OPENAI_API_KEY }}- Inline PR annotations for every failed assertion
- Outputs:
score,pass-rate,has-regression - Uploads test report as artifact
action.yml Β· Example workflow
π¦ Cumulative: v0.4.0 + v0.5.0
| Feature | v0.4.0 | v0.5.0 |
|---|---|---|
agentbench init --quick |
β | β |
| Agent Testing Pyramid | β | β |
| 8 Anti-Patterns | β | β |
| Ecosystem Guides (3) | β | β |
| Failure Guidance UI | β | β |
| Quality Trends Chart | β | β |
| GitHub Marketplace Action | β | β |
| 462 Tests Β· 0 TS Errors | β | β |