1Définition

Un outil est une fonction de l'application décrite au modèle par un nom, une description et des paramètres. Le modèle peut répondre par une demande d'appel ; le programme exécute l'outil, puis renvoie le résultat dans un message dédié. Le modèle n'exécute jamais rien lui-même.

2Principes fondamentaux

3Exemples pratiques

1const outils = [{2  name: "score",3  description: "Renvoie le score d'un joueur de Sys-Code à partir de son pseudo.",4  input_schema: {5    type: "object",6    properties: { pseudo: { type: "string" } },7    required: ["pseudo"],8  },9}];

1const outil = OUTILS[appel.nom];2if (!outil) return { erreur: "Outil inconnu : " + appel.nom };3try {4  return await outil(appel.arguments);5} catch (e) {6  return { erreur: e.message };7}

4Erreurs courantes

await globalThis[appel.nom](…)

OUTILS[appel.nom], une table fermée

soldes[pseudo] += montant;

Number.isInteger(montant) && montant <= 50

const r = await outil(args);

try { … } catch (e) { return { erreur: e.message }; }

5Subtilités à connaître

• ◆Un modèle peut demander plusieurs outils à la fois : on peut les exécuter en parallèle avec Promise.all s'ils sont indépendants.
• ◆Le résultat d'un outil repasse par le modèle : un résultat énorme consomme la fenêtre de contexte. On renvoie l'essentiel.
• ◆Le protocole MCP standardise la description et l'appel d'outils entre applications et modèles.

6Vérifie ta compréhension