Aller au contenu
Travaux Expertise Services CV Portfolio Intégrations Packages Laravel Blog Se connecter Me contacter

Un assistant admis dans votre application

Ce qui est intéressant chez un assistant, ce n'est pas qu'il écrit du texte, mais qu'il peut faire quelque chose dans un système qui est le vôtre. Pour cela il lui faut une porte, et cette porte, c'est vous qui la définissez : ce qui peut la franchir, avec quelle clé, et où cela s'arrête.

Ce qu'est MCP

MCP signifie Model Context Protocol : une convention sur la manière dont un assistant découvre et utilise des outils venus de l'extérieur. Votre serveur indique quelles opérations existent, quelles données chacune attend et ce qu'elle renvoie ; sur cette base, l'assistant choisit ce qu'il appelle. La différence avec une api ordinaire, c'est que le protocole est fait pour être décrit : l'assistant lit la description et n'a pas besoin d'avoir été programmé à l'avance pour votre système.

Concrètement : vous le construisez une fois et cela fonctionne avec chaque assistant qui parle le protocole, au lieu de devoir faire autre chose pour chaque fournisseur. Et cela signifie que votre ancienne api rest n'a pas à disparaître. Dans ce projet, elles cohabitent et passent toutes les deux par le même code, de sorte qu'il n'existe jamais discrètement deux versions des mêmes règles.

Ce que j'ai construit dessus

Six pièces entre un assistant et une application qui reste la vôtre.

Un serveur MCP sur l'application elle-même

Ce site en a un : un assistant peut y lire et décrire le blog, et proposer un article. MCP est le protocole par lequel un assistant découvre des outils venus de l'extérieur, et il vous épargne une intégration par assistant.

La même opération par trois canaux

Un article peut arriver par le formulaire de l'admin, par l'api rest ou par le serveur MCP. Tous les trois passent par le même écrivain dans le code, de sorte qu'il y a un jeu de règles et non trois qui s'écartent lentement.

Une clé par assistant, pas par personne

Chaque assistant reçoit sa propre clé, créée dans l'admin et visible à ce seul moment. La base de données contient une empreinte sha256, donc qui lit la table n'a encore rien. Révoquer est un bouton.

Des droits qui priment sur la requête

Une clé sans le droit de publier ne met rien en ligne, quoi que dise la requête. Ce qui arrive reste un brouillon jusqu'à ce qu'une personne le relise. La limite est dans la clé et non dans la promesse de l'assistant.

Une version texte de chaque page

À côté de llms.txt, qui résume le site, chaque page publique a une variante .md à la même url avec .md derrière. Elle est dérivée du même html, donc la version texte ne peut pas s'écarter de ce que voit un visiteur.

Un service d'assistance qu'un assistant peut utiliser

Pour FreeScout j'ai écrit un serveur MCP, afin qu'un assistant puisse rechercher et répondre à des conversations dans les limites permises par la clé, au lieu de faire copier-coller quelqu'un depuis un écran.

Comment cela s'articule

Cinq règles qui décident si vous pouvez laisser tourner cela tranquillement ou si vous devez y regarder tous les jours.

Traitez un assistant comme une partie externe

Pas comme un collègue avec un compte, et pas comme un morceau de votre propre code. Sa propre clé, ses propres droits, son propre frein sur le nombre de requêtes, et un journal de ce qu'il a fait. C'est exactement ce que vous feriez pour une intégration avec une autre entreprise, et pour les mêmes raisons.

Ce qui arrive est une proposition, pas un fait

Un assistant qui publie, envoie ou facture directement est un assistant qui, un mauvais jour, publie, envoie ou facture directement une erreur. Mettez un état entre les deux : brouillon, file d'attente, en attente d'approbation. Cela coûte un clic et cela sauve le jour où cela tourne mal.

Une api n'est pas un écran

Ce qu'une personne déduit d'un écran doit figurer explicitement dans la réponse pour un assistant : quels champs existent, ce qui est obligatoire, ce que signifie une erreur et quelle est l'étape suivante. Une api qui ne le dit pas laisse l'assistant deviner, et en texte, deviner ressemble à de la certitude.

Un frein en fait partie

Un assistant pris dans une boucle envoie des centaines de requêtes avant que quelqu'un le remarque. Un compteur par clé, un 429 clair et une réponse qui dit combien de temps attendre suffisent à en faire un désagrément plutôt qu'une panne.

Le texte que vous fournissez est une donnée, pas une instruction

Ce qui sort d'un modèle, ou ce qu'un visiteur a tapé dans un champ lu par un modèle, est une donnée. Cela ne doit jamais déterminer ce que fait votre application. Cette limite, vous la tracez dans le code, et non dans la formulation de la consigne.

Ce que ce n'est pas

Il ne s'agit pas ici d'une fenêtre de discussion sur votre site. C'est un autre type de projet, avec d'autres risques, et ce n'est généralement pas là que se trouve le gain. Le gain est dans le travail qui se fait aujourd'hui par copier-coller entre deux écrans : un résumé que quelqu'un recopie, un ticket que quelqu'un transfère, un texte que quelqu'un ressaisit ailleurs.

Et il ne s'agit pas de faire confiance à l'assistant. Tout le dispositif vise précisément à ne pas avoir à le faire : la limite est dans la clé, dans les droits et dans l'état sous lequel le travail arrive. Si l'assistant travaille bien, cela fait gagner du temps. S'il travaille mal une fois, il y a un brouillon que vous jetez.

Vous voulez une telle porte sur votre propre système

Cela commence en général par une question qui n'a rien à voir avec l'IA : quelles opérations de votre application valent la peine de pouvoir être appelées de l'extérieur. Une fois cela clair, le reste est de la construction. Envoyez un message.

La documentation de l'api de ce site se trouve sur llms.txt, et qui veut y réfléchir du côté des clés trouvera cela sous identité et accès.