Agenten für Fortgeschrittene · Kapitel 9 von 10
Ein Deep-Agent-Harness
Ein Deep Agent plant mit einer Todo-Liste, hält Notizen in virtuellen Dateien fest, gibt Teile einer Aufgabe an Subagenten mit frischem Kontext ab und hält vor den Tools an, die du nennst.
Ziele
- Starte den Auftrag und sieh zu, wie der Agent seine Todo-Liste schreibt und aktualisiert.Offen
- Genehmige das Schreiben der Notizen und sieh zu, wie der Dateibaum wächst.Offen
- Lass drei Subagenten parallel laufen und vergleich ihre Kontextgrößen.Offen
- Besteh den Check.Offen
Schritt 1 von 4: Der Text
Ein Harness für lange Aufträge
Ein Harness ist der Code rund um die Modellschleife: der Prompt, die Tools und was jeder Aufruf sieht. LangChains Open-Source-Paket deepagents ist einer, gebaut auf LangGraph. Seine Ankündigung von 2025 nannte vier Teile: einen ausführlichen Prompt, ein Planungstool, Subagenten und ein Dateisystem.
Todos und Dateien
write_todos({ todos }) nimmt jedes Mal die ganze Liste, jeden Eintrag pending, in_progress oder completed, und speichert sie in state.todos. Mehr tut es nicht: Der Gewinn ist, dass das Modell seinen Plan bei jedem Aufruf neu liest. Zwei Aufrufe in einem Zug werden abgelehnt. Eingeschaltet wird es, indem du LangChains todoListMiddleware() zu middleware hinzufügst.
Die Datei-Tools (ls, read_file, write_file, edit_file, glob, grep) arbeiten auf state.files, einem virtuellen Dateisystem im State des Graphen. Subagenten können die Notizen dort lesen, und sie überdauern eine Zusammenfassung alter Nachrichten.
Subagenten
task({ description, subagent_type }) startet einen Subagenten mit frischem Kontext: sein eigener System-Prompt und die Beschreibung, keine der Nachrichten des Aufrufers. Er startet mit den Dateien des Aufrufers, die Dateien, die er schreibt, werden zurückgeführt, und nur seine letzte Nachricht kommt zurück, als Tool-Ergebnis. Aufrufe in einem Zug laufen parallel. Ein Allzweck-Subagent mit den Tools des Aufrufers ist standardmäßig dabei.
Skills, Gedächtnis und Genehmigungen
Ein Skill ist ein Ordner mit einer Datei SKILL.md. Mit skills: ['/skills/'] listet der Prompt Namen und Beschreibung jedes Skills, und der Agent liest die Datei erst, wenn eine Aufgabe sie braucht. Die Option memory lädt AGENTS.md-Dateien in den Prompt. interruptOn nennt, zusammen mit einem Checkpointer, Tools, die den Lauf anhalten, bis eine Person jeden Aufruf genehmigt, bearbeitet oder ablehnt. Diese Seite hält an einem Breakpoint an (interruptBefore), weil interrupt() AsyncLocalStorage braucht.
Weniger Gerüst
Jeder Teil kostet bei jedem Aufruf Tokens. deepagents 1.12 (2026-07-29) machte die Todo-Liste optional und ließ seinen generischen System-Prompt leer: Aktuelle Modelle brauchen weniger Anleitung. Anthropics Beitrag zum Harness-Design (2026-03-24) sieht es genauso: Entferne mit jedem neuen Modell die Teile, die es nicht mehr braucht.
In diesem Lab
Ein nachgebauter Harness schreibt ein Briefing zu Erstattungsbeschwerden bei Halden, einem erfundenen Shop. Anders als deepagents 1.16 schaltet er die Liste mit todos: true ein, zeigt dem Researcher die Skills ohne eigene Skill-Liste, behält die alte generische Prompt-Zeile und hat kein AGENTS.md-Gedächtnis. Der Lead hält vor write_file und task an, damit du ihm folgen kannst; in deinem eigenen Agenten halte vor Tools an, die etwas außerhalb von ihm ändern.
Schritt 2 von 4: Probier es aus: Ein Rechercheauftrag, ein Teil nach dem anderen
Ein Rechercheauftrag, ein Teil nach dem anderen
Starte den Auftrag und beobachte die Todo-Liste, lass den Lead seine Notizen schreiben, genehmige dann drei Subagenten und vergleich ihre Kontextgrößen.
Modus:EchtNachgebautSimuliertEcht: LangGraph.js 1.5.1 führt die Schleife auf dieser Seite aus, mit seinem MemorySaver und dem interruptBefore-Breakpoint. Nachgebaut: der deepagents-1.16-Harness, neu gebaut auf LangGraph.js 1.5.1, mit seinen Tool-Namen, Standardwerten und Meldungen, weil sich das echte Paket nicht neben LangSmith 0.11 dieser Seite installieren lässt; das AGENTS.md-Gedächtnis ist nicht nachgebaut, und Tokens werden als Zeichen / 4 geschätzt. Simuliert: Die Entscheidungen des Modells sind geskriptet, und die Tickets von Halden sind erfunden.
Schritt 3 von 4: Check
Check
const lead = createDeepAgent({
systemPrompt: 'You write briefs.',
subagents: [{
name: 'researcher',
description: 'Researches a cause.',
systemPrompt: 'Edit the note, then report.',
}],
});
// The lead's model asks for:
task({
subagent_type: 'researcher',
description:
'Late refunds: /notes/late-refund.md',
})Schritt 4 von 4: Was du jetzt kannst
Was du jetzt kannst
- Die Todo-Liste eines Deep Agents einschalten, indem du todoListMiddleware() zu seiner middleware hinzufügst, und den Plan aus state.todos lesen.
- Notizen und Entwürfe mit ls, read_file, write_file, edit_file, glob und grep in state.files ablegen.
- In sich geschlossene Arbeit an task-Subagenten abgeben und die Berichte und Dateien nutzen, die zurückkommen.
- Einen Deep Agent mit interruptOn und einem Checkpointer vor ausgewählten Tools anhalten und Gerüst entfernen, das ein neueres Modell nicht mehr braucht.