Aperçu exécutif et portée architecturale
Vercel a officiellement déployé une refonte architecturale fondamentale pour l'adaptateur fx du kit de développement IA (version the-fx-adapter-now-runs-the-harn), modifiant en profondeur la manière dont l'exécution du harnais IA interagit avec les environnements applicatifs. Auparavant, l'exécution des harnais d'agents IA nécessitait le lancement de runtimes externes, la gestion de ponts de bac à sable et la configuration de redirections de ports complexes. Cette dernière version intègre l'adaptateur fx — propulsé par libfx, la bibliothèque TypeScript native pour fx — directement dans le même processus que votre application hôte. En exécutant localement les requêtes de harnais et de modèle tout en préservant une isolation stricte pour les opérations à risque, cette mise à jour élimine la surcharge de virtualisation inutile sans compromettre la sécurité.
L'implication stratégique de ce changement réside dans la posture de sécurité et la simplicité opérationnelle. Lors des versions précédentes, les identifiants de modèles et les états d'exécution intermédiaires traversaient souvent des frontières ou devaient être transférés dans des bacs à sable isolés. Avec la nouvelle architecture, les identifiants de modèles restent fermement sur le système hôte. Les actions à haut risque, telles que les manipulations intégrées du système de fichiers et les commandes shell, restent correctement isolées dans un bac à sable, mais le plan de contrôle bénéficie d'une communication directe en cours de processus. De plus, cette réécriture permet des cycles de vie de session persistants, ouvrant la voie à des flux de travail où les sessions d'agents peuvent être sauvegardées et reprises de manière transparente au sein d'un tout nouveau processus hôte. Cette sortie marque une évolution mature dans la gestion des flux d'agents complexes par les applications sans serveur (serverless) et proches de la périphérie (edge).
Améliorations principales et ergonomie pour les développeurs
Au-delà du changement architectural, cette version introduit une suite de fonctionnalités conçues pour offrir un contrôle granulaire sur les agents autonomes. Premièrement, le filtrage d'outils intégré permet aux ingénieurs de sélectionner explicitement les outils qu'un agent est autorisé à utiliser lors d'une phase d'exécution donnée. Cela minimise la surface d'attaque de l'agent et prévient les interactions système non intentionnelles en restreignant le périmètre des capacités par appel. Deuxièmement, le pilotage en cours de tour (mid-turn steering) modifie fondamentalement la façon dont les humains interagissent avec les exécutions d'agents actifs. Les développeurs peuvent désormais injecter de nouvelles instructions ou orientations contextuelles pendant qu'un tour est en cours de traitement, permettant une correction de trajectoire dynamique sans avoir à interrompre et redémarrer toute la boucle de conversation.
Parmi les autres améliorations ergonomiques figurent un support robuste pour l'application de sorties structurées, garantissant que les réponses des agents se conforment strictement à des schémas prédéfinis — une exigence essentielle pour le traitement programmatique en aval. Enfin, l'intégration des résultats d'outils d'image via l'assistant toModelOutput() normalise la manière dont les données visuelles sont réinjectées dans le modèle fondamental. En permettant la traduction propre et le retour des sorties multimodales dans le contexte du modèle, les agents peuvent désormais traiter, analyser et itérer nativement sur des images générées ou récupérées. Combinées à la suppression du pontage des ports du bac à sable, ces améliorations simplifient considérablement le développement d'agents IA de qualité production.
Matrice de comparaison architecturale
| Métrique d'évaluation | Base de l'ancien adaptateur FX | Nouvelle architecture the-fx-adapter-now-runs-the-harn |
Impact architectural |
|---|---|---|---|
| Latence | Élevée (Surcharge due aux ponts de bac à sable et aux sauts réseau IPC) | Minimale (Exécution en processus du harnais et des requêtes de modèle) | Temps de trajet aller-retour considérablement réduits pour les boucles d'agents |
| Empreinte mémoire | Distribuée (Nécessitait des installations de binaires séparés et des processus démons dans le bac à sable) | Consolidée (Utilise la bibliothèque TypeScript légère libfx directement dans l'hôte) |
Consommation globale de ressources réduite par session concurrente |
| Surface d'API et gestion des ports | Complexe (Nécessitait l'exposition et la gestion de ports de bac à sable dédiés) | Propre (Zéro exposition de port ; exécution directe des fonctions au niveau de l'hôte) | Topologie réseau simplifiée et réduction des frictions de configuration |
Changements majeurs et avertissements de migration
Bien que la nouvelle architecture améliore considérablement les performances et la sécurité, elle introduit des changements notables dans la façon dont l'adaptateur s'interface avec votre infrastructure. L'adaptateur s'exécutant désormais dans l'espace de processus de l'application via libfx, les dépendances qui s'appuyaient auparavant sur des installations internes de fx dans le bac à sable échoueront. L'obligation d'exécuter un pont de bac à sable dédié a été entièrement supprimée. De plus, tout code existant s'attendant à ce que les identifiants soient transférés directement dans l'environnement du bac à sable doit être refactorisé, car les identifiants résident désormais de manière sécurisée exclusivement sur l'hôte. Les développeurs doivent également s'assurer que leurs arbres de dépendances sont mis à jour proprement pour éviter les incompatibilités de version entre l'application hôte et les bibliothèques de harnais sous-jacentes.
Guide de mise à niveau étape par étape
Pour migrer votre application vers la nouvelle architecture, suivez ces trois étapes essentielles :
Mettre à jour les dépendances des paquets Mettez à niveau le paquet de harnais AI SDK de votre projet vers la dernière version contenant le nouveau adaptateur :
npm install @ai-sdk/harness-fx@latestRefactoriser la configuration de l'adaptateur Supprimez de vos scripts d'initialisation toutes les configurations de pont de bac à sable existantes, les configurations de redirection de port et la logique de transfert d'identifiants du bac à sable, car
libfxgère désormais l'exécution nativement en cours de processus.Implémenter les nouvelles fonctionnalités et vérifier l'isolation du bac à sable Exploitez les chemins d'importation mis à jour pour configurer le filtrage des outils et les sorties structurées. Assurez-vous que vos opérations de système de fichiers et de shell continuent de fonctionner correctement dans leurs limites de bac à sable isolées, tandis que les identifiants du modèle restent stockés en toute sécurité sur l'hôte.
import { HarnessAgent } from '@ai-sdk/harness-fx'; const agent = new HarnessAgent({ // Configurer le filtrage des outils intégrés et les contraintes de schéma allowedTools: ['file-search', 'custom-parser'], structuredOutput: true, });