Passer au contenu principal
Exécutez un agent qui utilise des outils avec l’Agent SDK TypeScript et enregistrez son état après chaque étape, pour qu’un processus planté ou redémarré reprenne là où il s’était arrêté. À la fin, vous avez un script qui répond à une question sur la documentation avec un outil de recherche, écrit chaque exécution dans .agent-runs/<run id>.json et reprend une exécution quand vous lui passez son identifiant. Le script est illustratif : le stockage dans des fichiers convient à une seule machine. En production, gardez la même paire load/save, mais appuyez-la sur votre base de données. Phaseo ne stocke pas les exécutions de l’Agent SDK à votre place.

Le construire

1

Installer

@phaseo/agent-sdk installe @phaseo/sdk avec lui. Définissez votre clé :
2

Écrire l’agent

agent.ts
3

L’exécuter

Pour tester une reprise, arrêtez le script avec Ctrl+C après la première ligne checkpoint, puis passez l’identifiant d’exécution qu’il a affiché (un UUID) :

Vérifier que ça fonctionne

  • Le script affiche checkpoint une fois par étape, puis l’identifiant d’exécution, completed et une réponse avec une URL phaseo.app/docs.
  • .agent-runs/<run id>.json contient l’identifiant d’exécution, le statut, l’historique des messages, les appels d’outils et résultats de chaque étape, et la sortie finale.
  • Après une exécution interrompue, la commande de reprise termine la même exécution au lieu d’en démarrer une nouvelle.
  • Chaque tour du modèle apparaît dans Paramètres → Utilisation → Journaux. Journalisez l’identifiant d’exécution à côté de chaque identifiant de requête pour pouvoir les faire correspondre.

Ce que contient l’état enregistré

Chaque résultat enregistré est l’AgentRunResult complet : run (identifiant, statut, messages, utilisation, pause éventuelle), steps avec leurs identifiants de requête Gateway et leurs appels d’outils, et output une fois l’exécution terminée. continueRun() l’accepte directement, ou bien un runId accompagné de state, auquel cas il appelle load() lui-même. Un appel d’outil en cours au moment où le processus s’est arrêté a peut-être déjà produit son effet : gardez donc vos outils idempotents. Le SDK répare l’historique d’un appel qui n’a jamais reçu de résultat avant de continuer. État et approbation couvre les pauses et les approbations.

Le faire évoluer prudemment

Gardez un agent par flux de travail, une courte liste d’outils et une ligne de journal par exécution avec l’identifiant d’exécution et les identifiants de requête. Quand vous avez besoin de pauses d’approbation ou de plusieurs agents partageant des outils, conservez ce client Gateway et cette paire d’état et construisez autour : l’agent de revue de code ajoute une pause d’approbation, et les outils en parallèle exécutent des outils côte à côte. Pour des valeurs par défaut de requête partagées, appelez un préréglage au lieu d’un modèle fixe.
Dernière modification le 5 novembre 2026