FR
Réserver un appel

Approche de Développement

WorkflowAgent vs HarnessAgent (AI SDK 7) : boucles d'agent durables vs runtimes de harnais prêts à l'emploi

WorkflowAgent vs HarnessAgent dans Vercel AI SDK 7 : des boucles durables et reprenables qui vous appartiennent (@ai-sdk/workflow) face à l'intégration d'un runtime d'agent de codage prêt à l'emploi comme Claude Code ou Codex (@ai-sdk/harness). Comparez durabilité, bac à sable, maturité, surface d'API et quand choisir chacun.

Vérifié par Michael Kerkhoff, état au

Définition
AI SDK 7 est sorti le 25 juin 2026 avec deux primitives d'agent phares que les développeurs ne cessent de confondre : WorkflowAgent et HarnessAgent. Dans la documentation, elles se ressemblent et produisent toutes deux des flux compatibles avec l'AI SDK, mais elles répondent à deux questions très différentes. WorkflowAgent, issu de @ai-sdk/workflow, reprend une boucle d'agent qui vous appartient — la même que celle du ToolLoopAgent en mémoire — et la rend durable : chaque appel d'outil devient une étape de workflow distincte avec des reprises automatiques, l'état persiste au-delà des frontières de processus, et une exécution interrompue reprend à son dernier point de contrôle au lieu de tout recommencer. HarnessAgent, issu de @ai-sdk/harness, fait tout autre chose : il enveloppe un runtime d'agent complet et prêt à l'emploi — Claude Code, Codex, Deep Agents, OpenCode ou Pi — derrière une seule surface d'AI SDK, toujours dans un bac à sable, de sorte que vous héritez de son accès à l'espace de travail, de ses outils de codage intégrés, de sa compaction et de ses flux d'autorisation. En bref : WorkflowAgent vise à faire survivre votre propre boucle aux pannes ; HarnessAgent vise à emprunter en toute sécurité un runtime éprouvé conçu par d'autres. Cette comparaison les évalue selon ce qu'elles orchestrent, la durabilité, le bac à sable, l'outillage intégré, la maturité, la surface d'API, les approbations humaines et le cas d'usage idéal, afin que vous cessiez de les opposer et utilisiez chacune là où elle a sa place.
Catégorie
Approche de Développement
Options
WorkflowAgentHarnessAgent

Comparaison Détaillée

Une analyse comparative des facteurs clés pour vous aider à faire le bon choix.

WorkflowAgent vs HarnessAgent
FacteurWorkflowAgentHarnessAgent
Ce qu'il orchestreVotre propre boucle d'agent — la même que celle du ToolLoopAgent, enveloppée pour la durabilité dans un workflow que vous contrôlezUn runtime d'agent tiers complet (Claude Code, Codex, Deep Agents, OpenCode, Pi) enveloppé derrière une surface d'SDK
Durabilité et reprise après pannePersistance automatique de l'état : chaque appel d'outil est une étape durable avec reprises, et une exécution interrompue reprend à son dernier point de contrôle GagnantLa durabilité n'est pas sa garantie première — elle repose sur l'état de session natif et le cycle de vie du bac à sable du harnais sous-jacent
Bac à sable et isolation de l'hôteN'ajoute aucun bac à sable propre ; la boucle s'exécute dans votre runtime de workflow, l'isolation relève donc de votre responsabilitéS'exécute toujours dans un bac à sable par conception ; les runtimes adossés à un pont comme Claude Code et Codex exigent un véritable bac à sable réseau et gardent l'hôte sûr Gagnant
Outils de codage intégrés et espace de travailVous fournissez les outils ; la boucle durable apporte la fiabilité, pas un environnement de codage prêt à l'emploiHérite d'emblée de l'accès à l'espace de travail, des outils de codage intégrés, de la compaction et des flux d'autorisation du harnais Gagnant
Maturité et stabilité au lancementLivré dans le cadre du pilier durabilité d'AI SDK 7, bâti sur la même boucle éprouvée que le ToolLoopAgent GagnantPuissant, mais les paquets de harnais sont explicitement marqués comme expérimentaux au lancement de la v7
Surface d'APIstream() uniquement — pas de generate() — et écrit via un paramètre writable avec ModelCallStreamPartExpose à la fois generate() et stream(), renvoyant des résultats compatibles AI SDK qui s'intègrent à useChat et aux surfaces existantes Gagnant
Approbations humaines (human-in-the-loop)Approbations d'outils intégrées qui suspendent l'agent et survivent à l'interruption d'une étape de workflow, une exécution peut donc attendre des heures la validation puis reprendre GagnantUtilise les flux d'autorisation propres au runtime de harnais — puissants, mais liés à sa session plutôt qu'à un point de contrôle durable
Cas d'usage idéalBoucles longues et critiques pour l'activité qui vous appartiennent et doivent survivre aux frontières serverless, aux redémarrages et aux déploiementsIntégrer un agent de codage prêt à l'emploi derrière une surface d'SDK gouvernée et en bac à sable, sans reconstruire son runtime
Score Total · 2 égalités3 / 83 / 8

Statistiques Clés

Données réelles provenant de sources vérifiées du secteur pour appuyer votre décision.

  • Plus de 16 M de téléchargements par semaine — l'AI SDK est le SDK TypeScript dans lequel les deux primitives sont livrées, et la couche sur laquelle repose le framework d'agent open source eve de Vercel — Vercel (2026)
  • AI SDK 7 est sorti le 25 juin 2026 et répartit le travail d'agent en cinq piliers ; WorkflowAgent est le pilier durabilité et HarnessAgent le pilier « intégrer n'importe quel harnais » — Vercel (2026)
  • WorkflowAgent exécute chaque appel d'outil comme une étape de workflow durable et distincte avec reprises automatiques ; la progression survit à un plantage de processus et reprend au dernier point de contrôle — AI SDK Docs (2026)
  • HarnessAgent fait tourner des runtimes établis — Claude Code, Codex, Deep Agents, OpenCode, Pi — via une seule surface, toujours dans un bac à sable pour que l'environnement hôte reste sûr — AI SDK Docs (2026)
  • La base en mémoire, le ToolLoopAgent, perd toute progression en cas de plantage — précisément la lacune que WorkflowAgent comble pour les agents serverless de longue durée — AI SDK Docs (2026)
  • AI SDK 7 relève la version minimale de Node.js à 22 (prises en charge : 22, 24, 26), et les paquets de harnais restent marqués comme expérimentaux au lancement — Vercel AI changelog (Releasebot) (2026)
  • La couche harnais est elle-même devenue un champ de bataille : début octobre 2026, DeepSeek Harness est arrivé en préversion publique mondiale - open source, bâti sur l'architecture Cordis 'tout est un plugin', exécutant DeepSeek-V4-Flash - le troisième harnais maison des laboratoires en une semaine, après Earendil Pi 1.0 (MCP natif via Codemode) et Codex 0.160. Les harnais prêts à l'emploi que des surfaces comme HarnessAgent enveloppent apparaissent plus vite que les boucles sur mesure. — DeepSeek Harness announcement (2026)
  • L'envers du décor, c'est le verrouillage des plateformes : Figma a restreint l'accès MCP aux clients sur liste blanche en excluant Pi, tandis que Pi Durable est arrivé comme réponse expérimentale pour les applications agentiques longues qui ne doivent pas dépendre d'un tel verrouillage - preuve que l'accès aux outils, pas seulement aux modèles, est devenu un levier de pouvoir. — Hacker News / pi.dev package page (2026)

Toutes les statistiques proviennent de sources tierces vérifiées. La source, l'année et le lien direct sont affichés pour chaque chiffre.

Quand Choisir Chaque Option

Un guide clair basé sur votre situation spécifique et vos besoins.

Notre Recommandation

Ce ne sont pas des concurrents, mais deux couches différentes de la même version — et la réponse honnête est : « cela dépend de ce qui vous appartient ». Optez pour WorkflowAgent lorsque vous construisez vous-même la boucle d'agent : vous appelez votre propre modèle et vos propres outils, l'exécution dure plus longtemps qu'un délai serverless ou qu'un déploiement, et vous avez besoin de reprises automatiques, de la reprise au point de contrôle et d'approbations qui survivent à une suspension — sans écrire vous-même une machine à états. Optez pour HarnessAgent lorsque vous ne voulez pas du tout construire la boucle : vous souhaitez intégrer un agent de codage éprouvé comme Claude Code ou Codex derrière une seule surface d'SDK, bénéficier gratuitement de ses outils d'espace de travail, de sa compaction et de ses flux d'autorisation, et l'exécuter en bac à sable pour que l'hôte reste sûr — en acceptant que les paquets de harnais soient explicitement marqués comme expérimentaux au lancement. Les deux se combinent même : un HarnessAgent peut s'exécuter au sein d'une infrastructure de workflow durable lorsque les exécutions d'un agent prêt à l'emploi doivent elles aussi survivre aux redémarrages. L'approche que Context Studios recommande à ses clients privilégie la gouvernance : mettez en bac à sable et approuvez tout runtime tiers (le réglage par défaut de HarnessAgent), et rendez durable et observable toute boucle longue et critique pour l'activité qui vous appartient (WorkflowAgent). Choisissez selon la responsabilité et le risque, et non selon le nom apparu en premier dans le changelog.

Choisissez WorkflowAgent quand...
  • La boucle d'agent vous appartient, vous appelez votre propre modèle et vos propres outils, et l'exécution doit survivre aux délais serverless, aux redémarrages et aux déploiements
  • Vous avez besoin de reprises automatiques et de la reprise au point de contrôle sans écrire vous-même une machine à états
  • Vous voulez voir chaque appel d'outil comme une étape de workflow distincte et observable dans vos tableaux de bord
  • Vous avez besoin d'approbations humaines qui suspendent l'agent et peuvent reprendre des heures plus tard, en survivant à la suspension
Choisissez HarnessAgent quand...
  • Vous voulez intégrer un agent de codage complet et prêt à l'emploi — Claude Code, Codex, Deep Agents, OpenCode ou Pi — derrière une seule surface d'AI SDK
  • Vous avez besoin de l'accès à l'espace de travail, des outils de codage, de la compaction et des flux d'autorisation d'emblée, sans les construire vous-même
  • L'isolation en bac à sable du runtime d'agent est une exigence ferme et non négociable
  • Vous voulez à la fois generate() et stream() et une intégration propre à useChat et aux surfaces existantes de l'AI SDK

Réponses aux questions courantes sur cette comparaison.

Questions Fréquentes

(01)WorkflowAgent et HarnessAgent sont-ils des concurrents ?
Non. Ce sont deux piliers différents d'AI SDK 7. WorkflowAgent rend durable et reprenable une boucle d'agent qui vous appartient ; HarnessAgent enveloppe un runtime tiers complet comme Claude Code ou Codex derrière une surface d'SDK. Ils résolvent des problèmes différents et peuvent même se combiner.
(02)Lequel survit à un plantage du serveur ?
WorkflowAgent. Il persiste l'état, relance automatiquement les appels d'outils et reprend au dernier point de contrôle, tandis que le ToolLoopAgent en mémoire perd toute progression en cas de plantage. HarnessAgent s'appuie sur l'état de session natif et le bac à sable du harnais sous-jacent plutôt que sur des points de contrôle durables.
(03)Ai-je besoin d'un bac à sable pour les utiliser ?
HarnessAgent s'exécute toujours dans un bac à sable ; les runtimes adossés à un pont comme Claude Code et Codex exigent un véritable bac à sable réseau tel que @ai-sdk/sandbox-vercel. WorkflowAgent s'exécute dans votre propre runtime de workflow et n'ajoute aucun bac à sable — l'isolation relève de votre responsabilité.
(04)Puis-je utiliser WorkflowAgent et HarnessAgent ensemble ?
Oui. Un schéma de production courant consiste à piloter un agent de codage prêt à l'emploi via HarnessAgent et à envelopper l'orchestration plus longue et multi-étapes dans une infrastructure de workflow durable, afin que l'exécution survive aux redémarrages. Les deux abstractions sont découplées mais bâties sur des primitives compatibles.

Besoin d'aide pour décider ?

Réservez une consultation gratuite de 30 minutes et nous vous aiderons à déterminer la meilleure approche pour votre projet spécifique.

Réserver une Consultation GratuiteNous Écrire

Consultation gratuite · Sans engagement · Réponse personnelle