---
type: Comparison
title: "WorkflowAgent vs HarnessAgent (AI SDK 7): cicli di agente durevoli vs runtime di harness pronti all'uso"
description: "WorkflowAgent vs HarnessAgent in Vercel AI SDK 7: cicli durevoli e riprendibili che le appartengono (@ai-sdk/workflow) rispetto all'integrazione di un runtime di agente di codifica pronto all'uso come Claude Code o Codex (@ai-sdk/harness). Confronti durabilità, sandbox, maturità, superficie API e quando scegliere ciascuno."
resource: "https://www.contextstudios.ai/it/confronto/workflowagent-vs-harnessagent"
category: approach
language: it
timestamp: "2026-06-26T11:09:13.746Z"
---

# WorkflowAgent vs HarnessAgent (AI SDK 7): cicli di agente durevoli vs runtime di harness pronti all'uso

AI SDK 7 è uscito il 25 giugno 2026 con due primitive di agente di punta che gli sviluppatori continuano a confondere: WorkflowAgent e HarnessAgent. Nella documentazione si somigliano e producono entrambe flussi compatibili con l'AI SDK, ma rispondono a due domande molto diverse. WorkflowAgent, da @ai-sdk/workflow, prende un ciclo di agente che le appartiene — lo stesso del ToolLoopAgent in memoria — e lo rende durevole: ogni chiamata a uno strumento diventa un passo di workflow distinto con ritentativi automatici, lo stato persiste oltre i confini di processo e un'esecuzione andata in crash riprende dall'ultimo punto di controllo invece di ricominciare da capo. HarnessAgent, da @ai-sdk/harness, fa qualcosa di completamente diverso: avvolge un runtime di agente completo e pronto all'uso — Claude Code, Codex, Deep Agents, OpenCode o Pi — dietro un'unica superficie dell'AI SDK, sempre all'interno di una sandbox, così da ereditarne l'accesso all'area di lavoro, gli strumenti di codifica integrati, la compattazione e i flussi di autorizzazione. In breve: WorkflowAgent serve a far sopravvivere il suo ciclo ai guasti; HarnessAgent serve a prendere in prestito in sicurezza un runtime collaudato realizzato da altri. Questo confronto li valuta in base a ciò che orchestrano, alla durabilità, alla sandbox, agli strumenti integrati, alla maturità, alla superficie API, alle approvazioni umane e al carico di lavoro più adatto, così da smettere di considerarli rivali e usare ciascuno dove ha senso.

## Comparison Factors

| Factor | WorkflowAgent | HarnessAgent | Winner |
|--------|------|------|--------|
| Cosa orchestra | Il suo ciclo di agente — lo stesso del ToolLoopAgent, avvolto per la durabilità in un workflow che lei controlla | Un runtime di agente di terze parti completo (Claude Code, Codex, Deep Agents, OpenCode, Pi) avvolto dietro una superficie dell'SDK | tie |
| Durabilità e ripristino dopo un crash | Persistenza automatica dello stato: ogni chiamata a uno strumento è un passo durevole con ritentativi e un'esecuzione andata in crash riprende dall'ultimo punto di controllo | La durabilità non è la sua garanzia principale — si affida allo stato di sessione nativo e al ciclo di vita della sandbox dell'harness sottostante | a |
| Sandbox e isolamento dell'host | Non aggiunge una sandbox propria; il ciclo gira nel suo runtime di workflow, quindi l'isolamento è una sua responsabilità | Gira sempre in una sandbox per progettazione; i runtime basati su bridge come Claude Code e Codex richiedono una vera sandbox di rete e mantengono l'host al sicuro | b |
| Strumenti di codifica integrati e area di lavoro | Lei fornisce gli strumenti; il ciclo durevole aggiunge affidabilità, non un ambiente di codifica già pronto | Eredita da subito l'accesso all'area di lavoro, gli strumenti di codifica integrati, la compattazione e i flussi di autorizzazione dell'harness | b |
| Maturità e stabilità al lancio | Distribuito come parte del pilastro durabilità di AI SDK 7, costruito sullo stesso ciclo collaudato del ToolLoopAgent | Potente, ma i pacchetti di harness sono esplicitamente contrassegnati come sperimentali al lancio della v7 | a |
| Superficie API | Solo stream() — niente generate() — e scrive tramite un parametro writable con ModelCallStreamPart | Espone sia generate() sia stream(), restituendo risultati compatibili con l'AI SDK che si integrano in useChat e nelle superfici esistenti | b |
| Approvazioni umane (human-in-the-loop) | Approvazioni degli strumenti integrate che mettono in pausa l'agente e sopravvivono alla sospensione di un passo di workflow, così un'esecuzione può attendere ore l'autorizzazione e poi riprendere | Usa i flussi di autorizzazione propri del runtime di harness — potenti, ma legati alla sua sessione anziché a un punto di controllo durevole | a |
| Carico di lavoro più adatto | Cicli lunghi e critici per l'attività che le appartengono e devono sopravvivere ai confini serverless, ai riavvii e ai deploy | Integrare un agente di codifica pronto all'uso dietro una superficie dell'SDK governata e in sandbox, senza ricostruirne il runtime | tie |

## Key Statistics

- Oltre 16 mln di download a settimana — l'AI SDK è l'SDK TypeScript in cui vengono distribuite entrambe le primitive e il livello su cui è costruito eve, il framework di agente open source di Vercel
- AI SDK 7 è uscito il 25 giugno 2026 e suddivide il lavoro di agente in cinque pilastri; WorkflowAgent è il pilastro della durabilità e HarnessAgent il pilastro «integrare qualsiasi harness»
- WorkflowAgent esegue ogni chiamata a uno strumento come un passo di workflow durevole e distinto con ritentativi automatici; il progresso sopravvive a un crash di processo e riprende dall'ultimo punto di controllo
- HarnessAgent esegue runtime affermati — Claude Code, Codex, Deep Agents, OpenCode, Pi — attraverso un'unica superficie, sempre all'interno di una sandbox, così che l'ambiente host resti al sicuro
- La base in memoria, il ToolLoopAgent, perde tutto il progresso in caso di crash — esattamente la lacuna che WorkflowAgent colma per gli agenti serverless di lunga durata
- AI SDK 7 alza la versione minima di Node.js a 22 (supportate: 22, 24, 26) e i pacchetti di harness restano contrassegnati come sperimentali al lancio

## Choose WorkflowAgent When

- Il ciclo di agente le appartiene, chiama il proprio modello e i propri strumenti e l'esecuzione deve sopravvivere a timeout serverless, riavvii e deploy
- Le servono ritentativi automatici e la ripresa dal punto di controllo senza scrivere a mano una macchina a stati
- Vuole vedere ogni chiamata a uno strumento come un passo di workflow distinto e osservabile nelle sue dashboard
- Le servono approvazioni umane che mettano in pausa l'agente e possano riprendere ore dopo, sopravvivendo alla sospensione

## Choose HarnessAgent When

- Vuole integrare un agente di codifica completo e pronto all'uso — Claude Code, Codex, Deep Agents, OpenCode o Pi — dietro un'unica superficie dell'AI SDK
- Le servono accesso all'area di lavoro, strumenti di codifica, compattazione e flussi di autorizzazione da subito, senza costruirli lei stesso
- L'isolamento in sandbox del runtime di agente è un requisito rigido e non negoziabile
- Vuole sia generate() sia stream() e un'integrazione pulita con useChat e le superfici esistenti dell'AI SDK

## Verdict

Non sono concorrenti, ma due livelli diversi della stessa release — e la risposta onesta è: «dipende da cosa le appartiene». Scelga WorkflowAgent quando costruisce lei stesso il ciclo di agente: chiama il proprio modello e i propri strumenti, l'esecuzione dura più di un timeout serverless o di un deploy e le servono ritentativi automatici, la ripresa dal punto di controllo e approvazioni che sopravvivono a una sospensione — senza scrivere a mano una macchina a stati. Scelga HarnessAgent quando non vuole affatto costruire il ciclo: desidera integrare un agente di codifica collaudato come Claude Code o Codex dietro un'unica superficie dell'SDK, ottenerne gratuitamente gli strumenti dell'area di lavoro, la compattazione e i flussi di autorizzazione, ed eseguirlo in una sandbox così che l'host resti al sicuro — accettando che i pacchetti di harness siano esplicitamente contrassegnati come sperimentali al lancio. I due si combinano persino: un HarnessAgent può essere eseguito all'interno di un'infrastruttura di workflow durevole quando anche le esecuzioni di un agente pronto all'uso devono sopravvivere ai riavvii. L'approccio che Context Studios consiglia ai clienti mette la governance al primo posto: metta in sandbox e approvi qualsiasi runtime di terze parti (l'impostazione predefinita di HarnessAgent) e renda durevole e osservabile qualsiasi ciclo lungo e critico per l'attività che le appartiene (WorkflowAgent). Scelga in base a responsabilità e rischio, non in base a quale nome è comparso per primo nel changelog.

## FAQ

**Q: WorkflowAgent e HarnessAgent sono concorrenti?**
A: No. Sono due pilastri diversi di AI SDK 7. WorkflowAgent rende durevole e riprendibile un ciclo di agente che le appartiene; HarnessAgent avvolge un runtime di terze parti completo come Claude Code o Codex dietro una superficie dell'SDK. Risolvono problemi diversi e possono persino combinarsi.

**Q: Quale sopravvive a un crash del server?**
A: WorkflowAgent. Persiste lo stato, ritenta automaticamente le chiamate agli strumenti e riprende dall'ultimo punto di controllo, mentre il ToolLoopAgent in memoria perde tutto il progresso in caso di crash. HarnessAgent si affida allo stato di sessione nativo e alla sandbox dell'harness sottostante anziché a punti di controllo durevoli.

**Q: Mi serve una sandbox per usarli?**
A: HarnessAgent gira sempre all'interno di una sandbox; i runtime basati su bridge come Claude Code e Codex richiedono una vera sandbox di rete come @ai-sdk/sandbox-vercel. WorkflowAgent gira nel suo runtime di workflow e non aggiunge alcuna sandbox propria — l'isolamento è una sua responsabilità.

**Q: Posso usare WorkflowAgent e HarnessAgent insieme?**
A: Sì. Uno schema di produzione comune è pilotare un agente di codifica pronto all'uso tramite HarnessAgent e avvolgere l'orchestrazione più lunga e multi-passo in un'infrastruttura di workflow durevole, così che l'esecuzione sopravviva ai riavvii. Le due astrazioni sono disaccoppiate ma costruite su primitive compatibili.

Keywords: WorkflowAgent vs HarnessAgent, agenti AI SDK 7, @ai-sdk/workflow, @ai-sdk/harness, ciclo di agente durevole, HarnessAgent Claude Code, durabilità Vercel AI SDK