Découvrir les outils et les ressources

Un client ne doit jamais supposer ce qu’un serveur peut faire. Une fois connecté, il découvre les fonctionnalités disponibles en demandant au serveur de les répertorier.

Appelez session.list_tools() et le serveur renvoie tous les outils qu’il expose, prêts à être examinés par votre code.

Le résultat contient une liste tools. Chaque entrée possède un nom et une description compréhensible, afin que vous sachiez ce qu’elle fait.

Chaque outil expose également un inputSchema, un schéma JSON décrivant les arguments qu’il accepte. C’est ainsi que vous apprenez quoi envoyer.

Les serveurs peuvent aussi proposer des données en lecture seule. Appelez session.list_resources() pour récupérer l’ensemble des ressources que vous pouvez lire.

Chaque ressource est désignée par un uri, comme un chemin de fichier ou un schéma personnalisé. Vous utiliserez ensuite cet uri pour récupérer son contenu.

Le troisième élément fondamental est constitué des invites. session.list_prompts() révèle les modèles d’instructions réutilisables publiés par le serveur.

Vous n’obtenez que ce que le serveur a annoncé lors de la poignée de main. S’il n’a déclaré aucune resources, leur répertoire renvoie un ensemble vide.

La découverte signifie qu’un client s’adapte à l’exécution. Branchez un nouveau serveur et ses outils apparaissent simplement, sans modification du code client.

Les noms, descriptions et schémas des outils découverts sont précisément ce dont un modèle a besoin pour décider quel outil répondra à une requête ultérieure.

Les listes d’outils peuvent changer. Un client prudent peut donc les ré-énumérer après une notification de mise à jour, plutôt que de faire confiance à un instantané obsolète.

Vous avez appris à découvrir un serveur à l’exécution : répertorier ses outils, ses ressources et ses invites, puis lire chaque nom, description et schéma avant d’agir.