Aller au contenu
Retour à Construisez vos premiers agents

Construisez vos premiers agents · Chapitre 5 sur 8

Outils et appels d'outils

Définir des outils avec zod, les lier à un modèle et traiter les appels d'outils que fait le modèle.

20 minutes0 objectifs sur 3 atteints

Objectifs

  • Ajoutez un champ décrit au schéma d'un outil et regardez son JSON Schema changer.À faire
  • Envoyez des arguments invalides et voyez la validation les rejeter.À faire
  • Réussissez la vérification.À faire

Étape 1 sur 4 : La lecture

Un outil est une fonction avec un schéma

tool(fn, { name, description, schema }), de @langchain/core/tools, transforme une fonction async en outil. Le schéma est un objet zod : z.object({ order_id: z.string().describe("The order number") }). Il indique quels arguments l'outil prend, leurs types, et lesquels sont facultatifs.

Le schéma sert deux fois. LangChain le convertit en JSON Schema, que lit le modèle. Et votre code s'en sert pour vérifier les arguments envoyés par le modèle avant que votre fonction s'exécute.

Ce que voit le modèle

model.bindTools(tools) renvoie un modèle qui envoie le nom, la description et le JSON Schema de chaque outil à chaque appel. La fonction elle-même ne quitte jamais votre code. Le modèle ne sait que ce que ces trois éléments lui disent : les descriptions sont donc des prompts. Écrivez-les pour le modèle, et décrivez chaque champ avec .describe().

Un appel d'outil et sa réponse

Quand le modèle veut un outil, sa réponse est un AIMessage avec des tool_calls : chaque appel a un name, des args et un id. Votre code exécute l'outil et répond avec un ToolMessage qui porte le même tool_call_id. Un modèle peut demander plusieurs appels à la fois : c'est l'id qui associe chaque résultat à son appel.

Passez l'appel d'outil entier à tool.invoke(). L'outil valide les args selon son schéma, exécute votre fonction et renvoie le ToolMessage pour vous. Si les args ne correspondent pas, il lève ToolInputParsingException et votre fonction ne s'exécute jamais. Une boucle d'agent intercepte l'erreur et la renvoie sous forme de ToolMessage avec le status "error", pour que le modèle puisse corriger son appel. Au chapitre 6, ToolNode le fait pour vous.

Étape 2 sur 4 : Essayez : De zod à l'appel d'outil

De zod à l'appel d'outil

Ajoutez un champ au schéma d'un outil et voyez ce que lit le modèle. Puis faites passer l'appel du modèle par la vraie validation, une fois avec des arguments valides et une fois avec des arguments que vous choisissez.

Mode :RéelSimuléRéel : zod, tool() de LangChain, la conversion en JSON Schema et la validation tournent dans cette page. Simulé : le modèle est scripté et ne lit pas le schéma. Ses appels d'outils sont fixés à l'avance, et à la dernière étape vous choisissez leurs arguments. Les données de commande sont fictives.

Étape 3 sur 4 : Vérification

Vérification

Question 1 sur 3Que reçoit le modèle au sujet d'un outil lié ?

Ensuite : Question 2 sur 3

Question 2 sur 3Qu'est-ce qui relie un ToolMessage à l'appel auquel il répond ?
Question 3 sur 3Le modèle envoie order_id sous forme de nombre, mais le schéma indique z.string(). Que se passe-t-il ?

Étape 4 sur 4 : Ce que vous savez faire maintenant

Ce que vous savez faire maintenant

  • Définir un outil avec tool() et un schéma zod, avec des descriptions utiles.
  • Lier des outils à un modèle et lire ses tool_calls.
  • Répondre à un appel d'outil avec un ToolMessage, et traiter les arguments invalides.