---
type: Comparison
title: "WorkflowAgent vs HarnessAgent (AI SDK 7) : boucles d'agent durables vs runtimes de harnais prêts à l'emploi"
description: "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."
resource: "https://www.contextstudios.ai/fr/comparaison/workflowagent-vs-harnessagent"
category: approach
language: fr
timestamp: "2026-06-26T11:09:12.922Z"
---

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

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.

## Comparison Factors

| Factor | WorkflowAgent | HarnessAgent | Winner |
|--------|------|------|--------|
| Ce qu'il orchestre | Votre propre boucle d'agent — la même que celle du ToolLoopAgent, enveloppée pour la durabilité dans un workflow que vous contrôlez | Un runtime d'agent tiers complet (Claude Code, Codex, Deep Agents, OpenCode, Pi) enveloppé derrière une surface d'SDK | tie |
| Durabilité et reprise après panne | Persistance 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 | La 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 | a |
| Bac à sable et isolation de l'hôte | N'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 | b |
| Outils de codage intégrés et espace de travail | Vous fournissez les outils ; la boucle durable apporte la fiabilité, pas un environnement de codage prêt à l'emploi | Hé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 | b |
| Maturité et stabilité au lancement | Livré dans le cadre du pilier durabilité d'AI SDK 7, bâti sur la même boucle éprouvée que le ToolLoopAgent | Puissant, mais les paquets de harnais sont explicitement marqués comme expérimentaux au lancement de la v7 | a |
| Surface d'API | stream() uniquement — pas de generate() — et écrit via un paramètre writable avec ModelCallStreamPart | Expose à la fois generate() et stream(), renvoyant des résultats compatibles AI SDK qui s'intègrent à useChat et aux surfaces existantes | b |
| 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 | Utilise les flux d'autorisation propres au runtime de harnais — puissants, mais liés à sa session plutôt qu'à un point de contrôle durable | a |
| Cas d'usage idéal | Boucles longues et critiques pour l'activité qui vous appartiennent et doivent survivre aux frontières serverless, aux redémarrages et aux déploiements | Inté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 | tie |

## Key Statistics

- 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
- 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 »
- 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
- 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
- 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 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

## Choose WorkflowAgent When

- 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

## Choose HarnessAgent When

- 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

## Verdict

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.

## FAQ

**Q: WorkflowAgent et HarnessAgent sont-ils des concurrents ?**
A: 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.

**Q: Lequel survit à un plantage du serveur ?**
A: 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.

**Q: Ai-je besoin d'un bac à sable pour les utiliser ?**
A: 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é.

**Q: Puis-je utiliser WorkflowAgent et HarnessAgent ensemble ?**
A: 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.

Keywords: WorkflowAgent vs HarnessAgent, agents AI SDK 7, @ai-sdk/workflow, @ai-sdk/harness, boucle d'agent durable, HarnessAgent Claude Code, durabilité Vercel AI SDK