Un agent utilisant les outils MCP

MCP fournit des fonctionnalités avec des contrats explicites.

Ce que vous apprendrez

  • Expliquez : le modèle propose, l'outil exécute
  • Appliquez l'idée dans un exemple : un agent utilisant les outils MCP
  • Reconnaître les limites et vérifier le résultat de l'exercice

MCP fournit des fonctionnalités avec des contrats explicites. Sélectionnez uniquement les outils requis pour la tâche.

Ces étapes font référence aux fonctionnalités identifiées dans le code de l'application. Ce matériel n'a pas été validé sur une instance réelle ; vérifiez la documentation et les options de votre version.

Comment ça marche, étape par étape

Le modèle propose, l'outil exécute

L'appel d'outil produit une demande d'appel avec un nom et des arguments. L'application valide le schéma, les autorisations et les limites avant exécution. Le résultat revient au contexte pour l'étape suivante. Par exemple, get_product_stock prend un SKU et renvoie une quantité ; sa description doit expliquer qu'il ne réserve pas de produits. Distinguez les résultats vides, les erreurs de validation, les accès manquants et les délais d’attente. Un JSON valide ne prouve pas que les arguments sont corrects ou que l'action est autorisée. Pour les effets externes, envisagez également une exécution en double.

Hôte, client et serveur

MCP est un protocole connectant les applications d'IA à des capacités externes. L'hôte fournit l'expérience, le client gère la connexion et le serveur expose des outils, des ressources ou des invites en fonction de la prise en charge. Les outils exécutent des opérations ; les ressources fournissent un contenu adressable ; les invites fournissent des modèles. Tous les serveurs n'implémentent pas les trois. Le transport transporte les messages, l'authentification identifie les appelants et l'autorisation contrôle l'accès. Vérifiez la révision du protocole et les extensions prises en charge aux deux extrémités. La compatibilité ne peut pas être déduite de la seule étiquette « MCP ».

Vérifier l'accès avant utilisation

Les autorisations doivent être appliquées par les serveurs et la couche de données. Ne laissez pas le modèle décider si un utilisateur peut voir un document. Filtrez les sources avant qu'elles n'entrent dans le contexte, et non après avoir généré la réponse. Utilisez des informations d'identification à accès minimal, gardez-les à l'écart des invites, des captures d'écran et du code du navigateur, et faites pivoter les clés exposées. Une liste blanche de domaines de widgets ne remplace pas l'authentification API. L'authentification vous identifie ; l’autorisation détermine les opérations et les données que vous pouvez utiliser. Test d'accès refusé également.

Le schéma explicatif

Un agent utilisant les outils MCP Suivez les flèches pleines pour le flux principal. Les flèches bleues en pointillés fournissent des données ou un contexte ; les flèches roses en pointillés affichent des commentaires ou des résultats renvoyés. Les couleurs et les formes distinguent les modèles, les magasins, les décisions et les sorties. Relations: Demande de l'utilisateur → Agent / LLM; Agent / LLM → Client MCP; Client MCP → Découvrez les schémas d'outils; Découvrez les schémas d'outils → Valider les arguments et les autorisations; Valider les arguments et les autorisations → Serveur MCP; Serveur MCP → API/base de données externe; Résultats de l'outil → Réponse finale; Identité et instructions de l'agent → Agent / LLM; Transport et authentification → Client MCP; Autorisations d'accès → Valider les arguments et les autorisations; API/base de données externe → Résultats de l'outil; Résultats de l'outil → Agent / LLM. A04 · Carte des relations Un agent utilisant les outils MCP Saisir Demande de l'utilisateur Données Identité et instructions de l'agent Décision / contrôle Transport et authentification Modèle/agent IA Agent / LLM Traitement Client MCP Traitement Découvrez les schémas d'outils Décision / contrôle Valider les arguments et les autorisations Outil/service Serveur MCP Magasin / index API/base de données externe Sortir Réponse finale Données Résultats de l'outil Décision / contrôle Autorisations d'accès Flux principal Données et contexte Commentaires et retour

Suivez les flèches pleines pour le flux principal. Les flèches bleues en pointillés fournissent des données ou un contexte ; les flèches roses en pointillés affichent des commentaires ou des résultats renvoyés. Les couleurs et les formes distinguent les modèles, les magasins, les décisions et les sorties. Sur un petit écran, faites défiler horizontalement pour suivre le schéma complet.

Un exemple complet

Connectez un serveur de démonstration, découvrez les outils et sélectionnez get_product_stock pour l'agent. Un SKU manquant déclenche une clarification plutôt qu'un accès arbitraire à toutes les commandes.

Essayez-le vous-même

  1. Activez un outil en lecture seule et testez un SKU valide, un SKU manquant et un accès refusé.
  2. Enregistrez l’entrée, la source et le résultat attendu avant d’exécuter l’expérience. Utilisez uniquement les données fictives de l'exemple.
  3. Suivez les étapes du diagramme. À chaque étape, enregistrez les informations reçues et produites ; ne confondez pas le résultat intermédiaire avec le résultat final.
  4. Répétez après avoir supprimé les informations nécessaires ou rendu la saisie ambiguë. Vérifiez si le système clarifie, arrête ou invente une réponse.
  5. Comparez avec la solution expliquée. Conservez la configuration, la date, le résultat et une explication des différences. Changez une chose et retestez.

Une solution expliquée

L'appel lit le stock SKU autorisé et traite le refus d'accès comme une erreur plutôt que comme un stock nul. Un exercice réussi vous permet de montrer le lien entre les contributions, les étapes et les résultats. Lorsqu’une information manque, une réponse prudente est plus utile que des détails inventés. Comparez bien plus que le style : vérifiez également les conditions, les sources et les opérations.

Quand cette approche est utile et quelles sont ses limites

Une description d'outil n'est pas un contrôle de sécurité. Choisissez cette approche lorsqu’elle améliore un besoin mesuré. Gardez une base de référence simple et comparez les résultats en utilisant des entrées identiques. Un exemple réussi n’établit pas la fiabilité dans toutes les situations.

Vérifiez vos connaissances

Qui exécute un appel proposé par le modèle ?

L'application ou le service hôte après validation. Le modèle n'obtient pas automatiquement un accès illimité.

Un serveur doté d’outils propose-t-il automatiquement des ressources et des invites ?

Non. Les fonctionnalités sont facultatives et doivent être découvertes et vérifiées.

Quel résultat cet exercice devrait-il produire ?

L'appel lit le stock SKU autorisé et traite le refus d'accès comme une erreur plutôt que comme un stock nul.

Les mots à retenir

  • Appel d'outil: Une demande structurée pour utiliser une capacité externe.
  • Serveur MCP: Un service exposant des capacités via Model Context Protocol.
  • Autoriser / Autorisation: Vérification du droit d'accès à une opération ou une ressource.

Sources et votre prochaine étape

Pour préparer : A03 — Un agent connecté à la connaissance