Guide · Utilisateurs avancés
Donner des outils à un assistant (MCP, API, webhooks)
Permettre à un assistant de consulter vos systèmes de façon contrôlée, avec un serveur MCP, un outil API ou un webhook.
Un assistant peut faire plus que rechercher dans des documents : il peut appeler des outils pour obtenir une donnée à jour ou déclencher une action. Ces fonctions nécessitent une licence Pro et se configurent dans la page Outils de l’administration (rôles Administrateur et Propriétaire).
Trois types d’outils
| Type | Quand l’utiliser |
|---|---|
| Serveur MCP | Vous disposez d’un serveur Model Context Protocol (transport HTTP « streamable ») qui expose déjà des outils |
| Outil API | Vous voulez appeler une API REST existante, en décrivant précisément ses paramètres |
| Webhook | Vous voulez transmettre une demande à un service (par exemple un workflow n8n) qui fera le traitement |
Outil API : décrire chaque paramètre
Un outil API se définit par une adresse (avec paramètres de chemin éventuels), une méthode, un format de corps (JSON, formulaire), un délai et une taille maximale de réponse. Pour chaque paramètre, vous choisissez :
- son emplacement : chemin, requête, en-tête ou corps ;
- sa source :
- fourni par le modèle (par exemple un numéro de dossier donné par l’utilisateur),
- fixé par l’administrateur (par exemple une clé d’accès),
- issu du contexte de la conversation.
Ne laissez jamais au modèle un paramètre sensible : identifiants, périmètre de données, droits. Fixez-les.
Un sélecteur de réponse permet de ne transmettre au modèle que la partie utile du résultat.
Serveur MCP
Déclarez l’adresse du serveur et, si nécessaire, son jeton d’accès et l’en-tête à utiliser. EasyRag liste les outils exposés ; sélectionnez uniquement ceux dont l’assistant a besoin. Testez chaque outil depuis l’interface avant de le relier à un assistant.
EasyRag est client du protocole MCP : il utilise les outils d’autres serveurs. Il n’expose pas lui-même de serveur MCP.
Webhook
Indiquez l’adresse, la méthode, les en-têtes, le délai et le schéma des paramètres attendus. EasyRag ajoute à l’appel les identifiants de session, de conversation et d’assistant, utiles pour tracer le traitement côté service.
Relier les outils à l’assistant
Dans la configuration de l’assistant, section Connaissances et outils, activez les outils voulus. Décrivez dans le prompt système quand les utiliser (« Pour tout numéro de dossier, consulte l’outil Suivi des demandes »).
Tester
- Posez une question qui doit déclencher l’outil, et une qui ne doit pas le faire.
- Vérifiez dans les journaux de requêtes de la supervision les appels réalisés.
- Testez un cas d’erreur (service indisponible) : l’assistant doit le dire, pas inventer.