Maintenant que nous avons construit notre serveur MCP, passons en revue les trois primitives fondamentales et comprenons quand utiliser chacune d'elles. L'idée clé est de comprendre qui contrôle chaque primitive et quel rôle elle joue dans votre application.
Outils : contrôlés par le modèle
Les outils sont entièrement contrôlés par Claude. Le modèle d'IA décide quand appeler ces fonctions, et les résultats sont utilisés directement par Claude pour accomplir des tâches.
Utilisez les outils lorsque vous souhaitez donner à Claude des capacités supplémentaires. Par exemple, si vous demandez à Claude de calculer la racine carrée de 3 en utilisant JavaScript, Claude décidera automatiquement d'utiliser un outil d'exécution JavaScript pour fournir une réponse précise.
Ressources : contrôlées par l'application
Les ressources sont contrôlées par le code de votre application. Votre application décide quand récupérer les données de ressources et comment les utiliser, généralement à des fins d'interface utilisateur ou pour ajouter du contexte aux conversations.
Utilisez les ressources lorsque vous avez besoin de faire entrer des données dans votre application. Voici quelques exemples courants :
- Remplir les options d'autocomplétion dans votre interface utilisateur
- Ajouter du contexte aux messages avant de les envoyer à Claude
- Afficher des listes de documents ou de fichiers disponibles
Dans notre projet, nous avons utilisé des ressources pour récupérer des suggestions d'autocomplétion et pour enrichir les invites avec du contexte supplémentaire.
Invites : contrôlées par l'utilisateur
Les invites sont déclenchées par des actions de l'utilisateur. Les utilisateurs décident quand exécuter ces workflows prédéfinis via des interactions d'interface utilisateur telles que des clics sur des boutons, des sélections de menu ou des commandes slash.
Utilisez les invites pour les workflows que les utilisateurs doivent pouvoir déclencher à la demande. Elles sont parfaites pour :
- Des amorces de conversation prédéfinies
- Des modèles de tâches courantes
- Des workflows spécialisés optimisés pour des cas d'usage spécifiques
Exemples concrets
Vous pouvez voir les trois primitives en action sur l'interface officielle de Claude. Les boutons d'amorce de conversation situés sous le champ de saisie du chat sont des exemples d'invites - des workflows contrôlés par l'utilisateur qui déclenchent des interactions prédéfinies.
L'option « Ajouter depuis Google Drive » illustre les ressources en action. Lorsque vous cliquez sur ce bouton, l'application récupère une liste de vos documents et les affiche dans l'interface utilisateur. Il s'agit d'un comportement contrôlé par l'application qui sert l'interface.
Lorsque vous demandez à Claude d'effectuer des calculs ou d'exécuter du code, vous observez les outils à l'œuvre. Claude décide automatiquement d'utiliser des outils disponibles comme l'exécution JavaScript pour fournir des résultats précis.
Choisir la bonne primitive
Voici un guide de décision rapide :
- Besoin d'étendre les capacités de Claude ? Utilisez les outils
- Besoin de données pour l'interface utilisateur ou le contexte de votre application ? Utilisez les ressources
- Vous souhaitez proposer des workflows prédéfinis aux utilisateurs ? Utilisez les invites
N'oubliez pas que ce sont des directives générales pour vous aider à choisir la bonne approche selon vos besoins spécifiques. Chaque primitive sert une partie différente de l'écosystème de votre application - les outils servent le modèle, les ressources servent votre application, et les invites servent vos utilisateurs.