---
type: Comparison
title: "WorkflowAgent vs. HarnessAgent (AI SDK 7): Ausfallsichere Agenten-Schleifen vs. fertige Harness-Laufzeiten"
description: "WorkflowAgent vs. HarnessAgent im Vercel AI SDK 7: ausfallsichere, wiederaufnehmbare Schleifen, die Ihnen gehören (@ai-sdk/workflow), gegenüber dem Einbinden einer fertigen Coding-Agent-Laufzeit wie Claude Code oder Codex (@ai-sdk/harness). Vergleich von Ausfallsicherheit, Sandbox, Reife, API-Oberfläche und wann sich was lohnt."
resource: "https://www.contextstudios.ai/de/vergleich/workflowagent-vs-harnessagent"
category: approach
language: de
timestamp: "2026-06-26T11:09:12.050Z"
---

# WorkflowAgent vs. HarnessAgent (AI SDK 7): Ausfallsichere Agenten-Schleifen vs. fertige Harness-Laufzeiten

AI SDK 7 erschien am 25. Juni 2026 mit zwei zentralen Agenten-Primitiven, die Entwicklerinnen und Entwickler immer wieder verwechseln: WorkflowAgent und HarnessAgent. In der Dokumentation sehen sie ähnlich aus und liefern beide AI-SDK-kompatible Streams, doch sie beantworten zwei sehr unterschiedliche Fragen. WorkflowAgent aus @ai-sdk/workflow nimmt eine Agenten-Schleife, die Ihnen gehört — dieselbe Schleife wie der speicherinterne ToolLoopAgent — und macht sie ausfallsicher: Jeder Tool-Aufruf wird zu einem eigenen Workflow-Schritt mit automatischen Wiederholungen, der Zustand bleibt über Prozessgrenzen hinweg erhalten, und ein abgestürzter Lauf setzt am letzten Prüfpunkt wieder an, statt von vorn zu beginnen. HarnessAgent aus @ai-sdk/harness leistet etwas völlig anderes: Es kapselt eine vollständige, fertige Agenten-Laufzeit — Claude Code, Codex, Deep Agents, OpenCode oder Pi — hinter einer einzigen AI-SDK-Oberfläche, stets innerhalb einer Sandbox, sodass Sie deren Arbeitsbereich-Zugriff, integrierte Coding-Werkzeuge, Verdichtung und Berechtigungsabläufe erben. Kurz gesagt: Bei WorkflowAgent geht es darum, die eigene Schleife Ausfälle überleben zu lassen; bei HarnessAgent darum, eine bewährte fremde Laufzeit sicher zu nutzen. Dieser Vergleich bewertet beide nach dem, was sie orchestrieren, nach Ausfallsicherheit, Sandbox, integrierten Werkzeugen, Reife, API-Oberfläche, menschlichen Freigaben und passendem Einsatz — damit Sie sie nicht länger als Rivalen behandeln, sondern jedes dort einsetzen, wo es hingehört.

## Comparison Factors

| Factor | WorkflowAgent | HarnessAgent | Winner |
|--------|------|------|--------|
| Was es orchestriert | Ihre eigene Agenten-Schleife — dieselbe wie beim ToolLoopAgent, für Ausfallsicherheit in einem Workflow gekapselt, den Sie steuern | Eine vollständige fremde Agenten-Laufzeit (Claude Code, Codex, Deep Agents, OpenCode, Pi), gekapselt hinter einer SDK-Oberfläche | tie |
| Ausfallsicherheit & Absturz-Wiederherstellung | Automatische Zustandssicherung: Jeder Tool-Aufruf ist ein ausfallsicherer Schritt mit Wiederholungen, ein abgestürzter Lauf setzt am letzten Prüfpunkt wieder an | Ausfallsicherheit ist nicht ihre Hauptzusage — sie stützt sich auf den nativen Sitzungszustand und den Sandbox-Lebenszyklus der zugrunde liegenden Harness | a |
| Sandbox & Host-Isolation | Fügt keine eigene Sandbox hinzu; die Schleife läuft in Ihrer Workflow-Laufzeit, die Isolation liegt also in Ihrer Verantwortung | Läuft konstruktionsbedingt stets in einer Sandbox; brückenbasierte Laufzeiten wie Claude Code und Codex verlangen eine echte Netzwerk-Sandbox und halten den Host sicher | b |
| Integrierte Coding-Werkzeuge & Arbeitsbereich | Sie liefern die Werkzeuge; die ausfallsichere Schleife steuert Verlässlichkeit bei, keine fertige Coding-Umgebung | Erbt von Haus aus den Arbeitsbereich-Zugriff, integrierte Coding-Werkzeuge, Verdichtung und Berechtigungsabläufe der Harness | b |
| Reife & Stabilität zum Start | Erscheint als Teil der Ausfallsicherheits-Säule von AI SDK 7, gebaut auf derselben bewährten Schleife wie der ToolLoopAgent | Mächtig, doch die Harness-Pakete sind beim v7-Start ausdrücklich als experimentell gekennzeichnet | a |
| API-Oberfläche | Nur stream() — kein generate() — und schreibt über einen writable-Parameter mit ModelCallStreamPart | Bietet sowohl generate() als auch stream() und liefert AI-SDK-kompatible Ergebnisse, die sich nahtlos in useChat und bestehende Oberflächen einfügen | b |
| Menschliche Freigaben (Human-in-the-Loop) | Integrierte Werkzeug-Freigaben, die den Agenten anhalten und eine Workflow-Schritt-Unterbrechung überstehen, sodass ein Lauf Stunden auf die Bestätigung warten und dann fortsetzen kann | Nutzt die eigenen Berechtigungsabläufe der Harness-Laufzeit — mächtig, aber an deren Sitzung gebunden statt an einen ausfallsicheren Prüfpunkt | a |
| Passender Einsatz | Langlaufende, geschäftskritische Schleifen, die Ihnen gehören und Serverless-Grenzen, Neustarts und Deploys überstehen müssen | Das Einbetten eines fertigen Coding-Agenten hinter einer kontrollierten, in einer Sandbox laufenden SDK-Oberfläche, ohne dessen Laufzeit neu zu bauen | tie |

## Key Statistics

- Über 16 Mio. Downloads pro Woche — das AI SDK ist das TypeScript-SDK, in dem beide Primitive ausgeliefert werden, und die Schicht, auf der Vercels quelloffenes eve-Agenten-Framework aufbaut
- AI SDK 7 erschien am 25. Juni 2026 und gliedert die Agentenarbeit in fünf Säulen; WorkflowAgent ist die Ausfallsicherheits-Säule und HarnessAgent die Säule „beliebige Harness einbinden“
- WorkflowAgent führt jeden Tool-Aufruf als eigenen ausfallsicheren Workflow-Schritt mit automatischen Wiederholungen aus; der Fortschritt übersteht einen Prozessabsturz und setzt am letzten Prüfpunkt wieder an
- HarnessAgent betreibt etablierte Laufzeiten — Claude Code, Codex, Deep Agents, OpenCode, Pi — über eine Oberfläche, stets innerhalb einer Sandbox, damit die Host-Umgebung sicher bleibt
- Die speicherinterne Basis, der ToolLoopAgent, verliert bei einem Absturz den gesamten Fortschritt — genau diese Lücke schließt WorkflowAgent für langlaufende Serverless-Agenten
- AI SDK 7 hebt die Mindestversion von Node.js auf 22 an (unterstützt: 22, 24, 26), und die Harness-Pakete sind zum Start weiterhin als experimentell gekennzeichnet

## Choose WorkflowAgent When

- Ihnen gehört die Agenten-Schleife, Sie rufen Ihr eigenes Modell und Ihre eigenen Werkzeuge auf, und der Lauf muss Serverless-Timeouts, Neustarts und Deploys überstehen
- Sie brauchen automatische Wiederholungen und das Wiederaufsetzen am Prüfpunkt, ohne selbst eine Zustandsmaschine zu schreiben
- Sie möchten jeden Tool-Aufruf als eigenen, beobachtbaren Workflow-Schritt in Ihren Dashboards sehen
- Sie brauchen menschliche Freigaben, die den Agenten anhalten und Stunden später fortsetzen können und eine Unterbrechung überstehen

## Choose HarnessAgent When

- Sie möchten einen vollständigen, fertigen Coding-Agenten — Claude Code, Codex, Deep Agents, OpenCode oder Pi — hinter einer AI-SDK-Oberfläche einbetten
- Sie brauchen Arbeitsbereich-Zugriff, Coding-Werkzeuge, Verdichtung und Berechtigungsabläufe von Haus aus, ohne sie selbst zu bauen
- Die Sandbox-Isolation der Agenten-Laufzeit ist eine harte, nicht verhandelbare Anforderung
- Sie möchten sowohl generate() als auch stream() und eine saubere Einbindung in useChat und bestehende AI-SDK-Oberflächen

## Verdict

Die beiden sind keine Konkurrenten, sondern zwei verschiedene Schichten derselben Veröffentlichung — und die ehrliche Antwort lautet: Es kommt darauf an, was Ihnen gehört. Greifen Sie zu WorkflowAgent, wenn Sie die Agenten-Schleife selbst bauen: Sie rufen Ihr eigenes Modell und Ihre eigenen Werkzeuge auf, der Lauf dauert länger als ein Serverless-Timeout oder ein Deploy, und Sie brauchen automatische Wiederholungen, das Wiederaufsetzen am Prüfpunkt sowie Freigaben, die eine Unterbrechung überstehen — ohne selbst eine Zustandsmaschine zu schreiben. Greifen Sie zu HarnessAgent, wenn Sie die Schleife gar nicht bauen wollen: Sie möchten einen bewährten Coding-Agenten wie Claude Code oder Codex hinter einer SDK-Oberfläche einbetten, dessen Arbeitsbereich-Werkzeuge, Verdichtung und Berechtigungsabläufe geschenkt bekommen und ihn in einer Sandbox laufen lassen, damit der Host sicher bleibt — und nehmen dabei in Kauf, dass die Harness-Pakete zum Start ausdrücklich als experimentell gekennzeichnet sind. Beide lassen sich sogar kombinieren: Ein HarnessAgent kann innerhalb ausfallsicherer Workflow-Infrastruktur laufen, wenn auch die Läufe eines fertigen Agenten Neustarts überstehen müssen. Context Studios rät Kundinnen und Kunden zu einem governance-orientierten Vorgehen: jede fremde Laufzeit in einer Sandbox kapseln und freigeben (die Voreinstellung von HarnessAgent) und jede langlaufende, geschäftskritische Schleife, die Ihnen gehört, ausfallsicher und beobachtbar machen (WorkflowAgent). Entscheiden Sie nach Verantwortung und Risiko, nicht danach, welcher Name zuerst im Changelog stand.

## FAQ

**Q: Sind WorkflowAgent und HarnessAgent Konkurrenten?**
A: Nein. Es sind zwei verschiedene Säulen von AI SDK 7. WorkflowAgent macht eine Agenten-Schleife, die Ihnen gehört, ausfallsicher und wiederaufnehmbar; HarnessAgent kapselt eine vollständige fremde Laufzeit wie Claude Code oder Codex hinter einer SDK-Oberfläche. Sie lösen unterschiedliche Probleme und lassen sich sogar kombinieren.

**Q: Welcher übersteht einen Server-Absturz?**
A: WorkflowAgent. Er sichert den Zustand, wiederholt Tool-Aufrufe automatisch und setzt am letzten Prüfpunkt wieder an, während der speicherinterne ToolLoopAgent bei einem Absturz den gesamten Fortschritt verliert. HarnessAgent stützt sich auf den nativen Sitzungszustand und die Sandbox der zugrunde liegenden Harness statt auf ausfallsichere Prüfpunkte.

**Q: Brauche ich eine Sandbox, um sie zu nutzen?**
A: HarnessAgent läuft stets innerhalb einer Sandbox; brückenbasierte Laufzeiten wie Claude Code und Codex verlangen eine echte Netzwerk-Sandbox wie @ai-sdk/sandbox-vercel. WorkflowAgent läuft in Ihrer eigenen Workflow-Laufzeit und bringt keine eigene Sandbox mit — die Isolation liegt in Ihrer Verantwortung.

**Q: Kann ich WorkflowAgent und HarnessAgent zusammen verwenden?**
A: Ja. Ein verbreitetes Produktionsmuster ist, einen fertigen Coding-Agenten über HarnessAgent zu steuern und die längere, mehrstufige Orchestrierung in ausfallsichere Workflow-Infrastruktur zu kapseln, damit der Lauf Neustarts übersteht. Die beiden Abstraktionen sind entkoppelt, aber auf kompatiblen Primitiven aufgebaut.

Keywords: WorkflowAgent vs HarnessAgent, AI SDK 7 Agenten, @ai-sdk/workflow, @ai-sdk/harness, ausfallsichere Agenten-Schleife, HarnessAgent Claude Code, Vercel AI SDK Ausfallsicherheit