Begriff

Agent-Harness: was es ist und woraus es besteht

Aktualisiert: · Skillaria.Top

Das Agent-Harness ist alles, was das Sprachmodell in einem KI-Agenten umgibt und es zu einem funktionierenden Werkzeug macht: Anweisungen, Werkzeuge, Ausführungsumgebung, Zustand zwischen Sitzungen und Rückkopplungsschleifen. Agent = Modell + Harness: Das Modell denkt, das Harness gibt ihm Regeln, Hände, Gedächtnis und eine Prüfung des Ergebnisses.

Definition

Ein Agent-Harness ist die Software-Hülle um ein Sprachmodell: alles, was nicht das Modell selbst ist, aber beeinflusst, wie der Agent arbeitet. Die Formel lautet Agent = Modell + Harness. Das Modell kann schlussfolgern und Code schreiben, das Harness bestimmt, was es sieht, welche Aktionen es ausführen kann, wo Befehle laufen, was zwischen Sitzungen erhalten bleibt und wie der Agent von seinen Fehlern erfährt.

Fünf Bestandteile des Harness

  • Anweisungen — der Systemprompt und Projektdateien wie CLAUDE.md und AGENTS.md, Themendokumente und Skills.
  • Werkzeuge — Shell-Befehle, Dateibearbeitung, ein Browser, Anbindungen über MCP.
  • Umgebung — eine Sandbox oder ein Container, in dem der Agent Code ausführt, ohne die Produktion zu gefährden.
  • Zustand — Planungs- und Fortschrittsdateien, Git-Historie: ein Gedächtnis, das das Schließen der Sitzung übersteht.
  • Rückmeldung — Tests, Linter, Typprüfung, Hooks, die dem Agenten ein Fehlersignal zurückgeben.

Das Harness ist nicht eine einzelne Prompt-Datei. Eine lange AGENTS.md hilft nicht, wenn der Agent keinen Zugriff auf die Tests hat oder die Umgebung nicht startet. Die Zuverlässigkeit bestimmt der schwächste der fünf Teile.

Beispiel

Der Agent behebt in der dritten Sitzung in Folge denselben Fehler: Nach jedem Neustart erinnert er sich nicht daran, was er bereits versucht hat. Es sieht aus, als wäre das Modell schuld. Tatsächlich ist das Teilsystem Zustand defekt. Die Lösung ist eine Datei PROGRESS.md, in die der Agent am Ende jeder Sitzung die Hypothesen notiert, die nicht funktioniert haben, sowie den nächsten Schritt:

## Fehler: doppelte Abbuchung bei Wiederholung der Anfrage
Geprüft und verworfen:
- Timeout des HTTP-Clients — ohne Einfluss
- Race Condition im Webhook-Handler — nicht reproduzierbar
Nächster Schritt: Idempotenzschlüssel in payments/service.py prüfen

Eine neue Sitzung liest die Datei und setzt sofort an der richtigen Stelle fort. Das Modell hat sich nicht verändert — das Harness schon.

Fazit

Das Agent-Harness sind die Anweisungen, Werkzeuge, Umgebung, der Zustand und die Rückmeldung um das Modell herum. Es bestimmt, ob derselbe Agent zuverlässig arbeitet oder scheitert. Wie man jeden Teil aufbaut, wird im Kurs zum Harness Engineering praktisch behandelt.

Häufige Fragen

Worin unterscheidet sich ein Agent-Harness von einem Agenten-Framework?

Ein Framework ist eine Bibliothek, mit der Sie einen Agenten bauen. Ein Harness ist eine konkrete Konfiguration um das Modell für Ihr Projekt: Regeln, Zugriffe, Umgebung, Tests und Zustandsdateien. Ein fertiger Agent wie Claude Code enthält bereits ein Grund-Harness, das Sie erweitern.

Sind Harness und Prompt dasselbe?

Nein. Ein Prompt ist nur ein Teil des Teilsystems Anweisungen. Zum Harness gehören außerdem Werkzeuge, Umgebung, das Gedächtnis zwischen Sitzungen und die Prüfung des Ergebnisses.

Mit welchem Teil des Harness sollte man anfangen?

Mit der Rückmeldung: Geben Sie dem Agenten Befehle, mit denen er seine eigene Arbeit prüfen kann. So sinkt am schnellsten die Zahl der Fehler, die einen Menschen erreichen.

Das Thema im Video lernen

Dieses Thema wird im Kurs „Harness Engineering: инженерия надёжности AI-агентов“ ausführlich mit Praxis behandelt.

Zum Kurs