Skip to main content
Utilisez cette recette lorsqu’un flux Agent doit :
  • s’exécuter via le SDK Agent pour TypeScript
  • s’appuyer sur la recherche Web gérée
  • renvoyer du JSON strictement structuré
  • récupérer de façon déterministe du JSON mal formé mais presque valide

1. Installer les SDK

2. Définir un contrat de sortie restreint

Limitez la première sortie de recherche afin que les opérateurs puissent facilement l’examiner dans les journaux.

3. Créer l’agent

Utilisez parseOutput afin que l’environnement d’exécution renvoie des données typées plutôt que du texte brut.

4. Configurer une fois l’adaptateur connecté au gateway

Voici le point essentiel :
  • responseFormat rend le schéma de sortie explicite
  • plugins active la réparation des réponses presque valides en JSON
  • gatewayTools met la recherche Web gérée à la disposition du modèle
  • toolChoice impose l’outil de recherche lorsque ce flux doit toujours s’appuyer sur des sources

5. Exécuter le flux de travail

6. Vérifier les journaux

Après une exécution réussie, consultez les détails de la requête et vérifiez que :
  • les outils natifs de recherche Web demandés ou l’activité de recherche gérée apparaissent
  • les résultats de recherche et les citations ont été conservés
  • l’exécution du plugin indique response-healing uniquement lorsqu’une récupération était nécessaire
  • la sortie finale respecte le schéma JSON demandé

7. Quand utiliser ce modèle

Utilisez cette recette lorsque :
  • le flux correspond surtout à une recherche ponctuelle, et non à une boucle complexe d’outils locaux
  • le modèle doit s’appuyer sur des sources avant de répondre
  • les appelants en aval ont besoin de JSON typé plutôt que de texte libre
N’utilisez pas ce modèle lorsque :
  • le flux connaît déjà les URL exactes et que phaseo:web_fetch suffit
  • l’agent a davantage besoin d’outils locaux avancés que d’outils natifs du fournisseur
  • le contrat de sortie est assez souple pour que la contrainte JSON apporte plus de complexité que de valeur

Guides associés

Dernière modification le 2 octobre 2026