Aperçu exécutif et importance architecturale

Le paysage du génie logiciel a connu une explosion d'agents de codage locaux et d'environnements d'exécution (harnesses), tels que Pi, Claude Code, OpenCode et Codex. Bien que ces utilitaires destinés aux développeurs servent d'excellents outils quotidiens pour la génération de code automatisée, leur transition vers des environnements cloud de production expose des lacunes architecturales critiques. Historiquement, le maintien de boucles d'agents toujours actives nécessitait du matériel local dédié, entraînant souvent des pics matériels localisés et une charge constante de gestion de l'alimentation. Le transfert de ces charges de travail de longue durée vers l'infrastructure cloud introduit des complexités substantielles, en particulier en ce qui concerne les cycles de vie serverless éphémères, la volatilité de la mémoire et l'instabilité du réseau.

La version « making-every-harness-durable » de Vercel répond directement à ces défis en introduisant durable-harness, un package open-source avancé d'adaptateurs et d'utilitaires construit sur l'interface World du SDK Workflow. Plutôt que de forcer les développeurs à reconstruire leurs architectures d'agents à partir de zéro, durable-harness enveloppe les environnements existants, en migrant directement les fichiers de session, les transcriptions et les magasins d'événements dans un journal de transactions robuste et durable. Cette conception abstrait le modèle d'exécution éphémère sous-jacent, garantissant que les tâches de longue durée s'étendant sur des minutes ou des heures peuvent survivre aux délais d'attente des fonctions, aux partitions réseau et aux plantages d'hôtes sans intervention humaine. En découplant la logique des agents des contraintes d'infrastructure à instance unique, Vercel comble le fossé entre le développement local flexible et les déploiements cloud évolutifs et hautement résilients.

Améliorations principales et ergonomie pour les développeurs

L'innovation centrale de cette version se concentre sur sa gestion de l'état et son mécanisme de récupération. Lorsqu'un agent traite un tour en plusieurs étapes — comme la lecture d'un dépôt, l'écriture d'un fichier, la création d'une pull request et l'attente de l'intégration continue (CI) —, toute interruption inattendue interrompt généralement l'exécution et rejette la progression intermédiaire. Avec durable-harness, chaque action enregistre une intention de pré-exécution et un résultat de post-exécution dans le journal durable, soutenu par la messagerie de file d'attente native. Si une fonction serverless s'arrête en cours d'exécution, une fonction nouvellement créée inspecte le journal, reconstruit l'état de la session et reprend précisément là où le tour précédent s'est arrêté. Cela élimine les appels de modèles redondants et évite le gaspillage de cycles de calcul sur des tâches qui ont déjà été complétées avec succès.

De plus, cette version introduit un contrôle nuancé sur les politiques d'exécution des outils et les limites de sécurité. Les développeurs peuvent désormais classer explicitement les outils comme 'safe' (permettant des nouvelles tentatives idempotentes) ou 'never' (empêchant une double exécution dangereuse pour des opérations telles que les transactions financières). Pour les environnements multi-locataires où l'exécution de commandes shell arbitraires et de mutations de fichiers sur des hôtes serverless partagés pose de graves risques de sécurité, Vercel propose des configurations d'espaces de travail isolés, comprenant des environnements virtuels, des bacs à sable conteneurisés et des disques de session. En outre, des documents JSON structurés (io.docs) permettent aux agents de maintenir un état de canal secondaire, tel que des plans et des listes de tâches, directement dans le journal de session. Cela garantit que l'état auxiliaire de l'agent reste synchronisé avec les invocations d'outils tout en permettant la diffusion en continu en temps réel des mutations d'état directement vers les interfaces utilisateur sans nécessiter d'infrastructure de base de données distincte.

Matrice de comparaison architecturale

Métrique d'évaluation	Référence précédente (machines virtuelles cloud ad-hoc / exécution locale)	Vercel making-every-harness-durable	Impact architectural
Latence et récupération	Latence élevée en cas de plantage ; nécessite un redémarrage manuel complet et une nouvelle invite de session.	Latence de récupération quasi nulle ; reprise automatique pilotée par les journaux via les files d'attente du SDK Workflow.	Élimine l'intervention manuelle et la facturation d'API redondante après les délais d'attente.
Mémoire et persistance	Mémoire locale volatile ou disques de VM non gérés ; état perdu en cas de plantage.	Journaux de transactions durables mis en miroir dans Postgres ou Vercel Worlds.	Garantit une continuité absolue de la session au-delà des frontières serverless éphémères.
API et sécurité des outils	Exécution d'outils sans restriction ; risque élevé d'effets secondaires en double en cas d'échec.	Politiques de sécurité des outils granulaires ('safe' vs 'never') et bacs à sable isolés.	Protège contre les bugs critiques de double exécution et les failles de sécurité multi-locataires.

Changements cassants et mises en garde relatives à la migration

Entièrement rétrocompatible avec les versions précédentes. Parce que durable-harness fonctionne comme une couche d'adaptateur externe enveloppant les outils et environnements existants (tels que Pi, fx, OpenCode et Claude Code), son adoption ne nécessite pas de modifications cassantes des invites principales des agents ou de la logique de la base de code sous-jacente. Cependant, les équipes migrant des implémentations d'environnements personnalisés doivent s'assurer que leurs backends de stockage sous-jacents sont correctement configurés pour pointer vers un magasin persistant, tel qu'une instance Postgres dédiée, lors de l'abandon des répertoires d'état local éphémères. Une attention particulière doit également être accordée aux définitions d'outils pour garantir une attribution correcte des politiques d'exécution ('safe' versus 'never'), car une mauvaise catégorisation dans les outils existants pourrait entraîner un comportement inattendu lors des séquences automatisées de récupération après plantage.

Guide de mise à niveau étape par étape

L'intégration de la durabilité dans votre flux de travail d'agent existant implique des modifications de configuration minimes centrées sur l'interface World du SDK Workflow et les variables de connectivité de la base de données.

Étape 1 : Installer le package et configurer les variables d'environnement Ajoutez le package durable-harness aux dépendances de votre projet et configurez votre environnement pour cibler une couche de stockage durable (telle que Postgres) à l'aide des variables d'environnement standard de Vercel :

npm install durable-harness @vercel/workflow

Définissez vos variables de connexion dans la configuration de votre projet :

VERCEL_WORKFLOW_DATABASE_URL=postgres://user:password@host:5432/dbname

Étape 2 : Initialiser l'adaptateur d'environnement dans le code Importez l'adaptateur d'environnement requis et instanciez-le dans votre route d'exécution d'agent, en passant l'espace de travail et les options de sécurité nécessaires :

import { WorkflowWorld } from '@vercel/workflow';
import { durableHarness } from 'durable-harness';
import { PiHarness } from 'durable-harness/pi';

export async function runAgentSession(prompt: string) {
  const world = new WorkflowWorld({
    namespace: 'agent-sessions',
  });

  const agent = durableHarness({
    harness: new PiHarness(),
    world,
    workspace: './workspace',
    builtins: true,
  });

  return await agent.run(prompt);
}

Étape 3 : Définir les politiques de sécurité des outils Assurez-vous que vos outils d'agents personnalisés déclarent explicitement leurs limites d'exécution pour gérer en toute sécurité la reprise automatique après les plantages :

const customTools = {
  lookupDatabase: {
    policy: 'safe',
    execute: async (query) => db.query(query),
  },
  processRefund: {
    policy: 'never',
    execute: async (amount) => paymentGateway.refund(amount),
  },
};