/pattern/integration-tests/

04 · ProductionObservability & EvaluationAgent Integration TestsScenario TestsEnd-to-End Agent Tests

Integration Tests for Agents.
Wiederholbare End-to-End-Szenarien – Fixtures, Traces, Evals.

Agenten werden über realistische Szenarien, Tools, Speicher und Kontrollflüsse getestet. Da die Ausgabe nicht-deterministisch ist, prüfen Assertionen Verhaltenseigenschaften ('das Rückerstattungs-Tool höchstens einmal aufgerufen', 'im Budget geblieben', 'die außerhalb des Umfangs liegende Anfrage abgelehnt') statt exakter Zeichenketten, und skalieren im größeren Maßstab zu einer Simulationsumgebung, die Tausende synthetischer Szenarien wiedergibt.

In der PraxisEin Kundenservice-Agent wird nächtlich mit 500 synthetischen Gesprächsszenarien getestet; jeder Durchlauf wird gegen Assertionen wie 'das Rückerstattungs-Tool höchstens einmal aufgerufen' und 'keine PII preisgegeben' bewertet, und Fehler blockieren den Release.

Ohne esOhne Integrationstests bleiben Verhaltensregressionen, die durch eine Prompt-Änderung oder ein Modell-Upgrade eingeführt wurden, unentdeckt, bis ein Produktionsvorfall das fehlerhafte Muster aufdeckt.

Wann man dazu greift

  • Agenten produktionsnah agieren.
  • Tool- und Workflow-Grenzen verifiziert werden müssen.
  • Regressionen über Versionen hinweg sichtbar werden müssen.

Wann es nach hinten losgeht

  • Nur ein isolierter Prompt erkundet wird.
  • Tests nicht deterministisch genug bewertet werden können.
  • Die Testumgebung externe Systeme gefährdet.

Die Abwägung

Höhere operative Sicherheit wird auf Kosten teurer Testdaten, Mocks und Evaluationslogik gewonnen.

Die Wirkung

Was es tatsächlich tut.

End-to-End-Läufe werden gegen Erwartungen geprüft.

runtestpass/fail
Fallstricke

Zwei Wege, wie dieses Pattern Probleme verursachen kann.

Tests bestehen, weil sie zu nachsichtig sind

Der Test prüft nur, dass die Antwort nicht leer ist. Der Agent fällt auf ein generisches 'Dabei kann ich nicht helfen' zurück und alle Tests bleiben grün.

Lösung · Gegen typisierte Zustandsinvarianten und explizite Inhaltsprüfungen assertieren, nicht nur auf Lebendigkeit. Strukturelle Assertionen mit LLM-as-Judge für semantische Qualität kombinieren.

Flaky-Nichtdeterminismus wird stummgeschaltet statt behoben

Eine Verhaltens-Assertion besteht bei den meisten Durchläufen und schlägt bei einigen fehl. Unter Release-Druck wiederholt das Team bis grün oder löscht den Test — und eine echte sporadische Regression geht nun still in Produktion.

Lösung · Jedes Szenario N-mal ausführen und eine Bestehensquote assertieren, nicht einen einzelnen Durchlauf. Fixtures seeden und aufzeichnen, damit Fehler deterministisch reproduzierbar sind; einen Flaky-Fall in Quarantäne stellen, niemals löschen.

Framework-Unterstützung

Wo Integration Tests for Agents nativ ist.

LangSmithEval-Datensätze + CINativ
OpenAI EvalsSzenario-GraderNativ
Microsoft Agent FrameworkEvaluations-HarnessNativ
Google ADKAgenten-Eval-SuitesNativ
CrewAITest PatternsNativ
AutoGen / AG2Agenten-TestwerkzeugeNativ

Suche

Patterns, Frameworks und Seiten durchsuchen.