Socle pour agents IA sur mesure
La base que je reprends pour chaque client, afin de livrer des agents branchés à ses outils et supervisés par ses équipes.
- Type
- Socle réutilisable, un dépôt par client
- État
- Version 1.2, testée
- Serveur
- TypeScript, Node, Fastify, PostgreSQL 17
- Agents
- Mastra, protocole MCP
- Interface
- React, Vite
- Mon rôle
- Conception, architecture et code

Pourquoi un socle
Chaque client veut un agent différent, mais les mêmes questions reviennent à chaque fois : quels droits, quel budget, qui valide, comment se brancher à Gmail ou à la comptabilité, que se passe-t‑il si l’agent tourne en rond. Ce socle y répond une fois pour toutes. Pour un nouveau client, je le copie dans un dépôt dédié et je n’écris que ce qui lui est propre.
Comment ça marche
Le code décrit des modèles d’agents et de workflows. L’administration en crée les instances : un même modèle d’assistante peut devenir l’assistante de l’équipe commerciale et celle de la comptabilité, chacune avec ses accès.
- Un catalogue de briques : 44 connecteurs (messageries, CRM, boutique, paiement, banque, comptabilité, signature électronique…) et dix familles d’outils (PDF, documents Office, navigateur, images, calcul).
- Des déclencheurs : horaires, webhooks, surveillance d’une boîte e-mail.
- Une base de connaissances et une mémoire bornée, pour que l’agent s’appuie sur les documents de l’entreprise.
- Des serveurs MCP, pour brancher les outils qui parlent déjà ce protocole.
- Quatre canaux : un chat interne, un chat public à coller sur un site, Telegram et l’e-mail.
Les garde-fous
- Accord humain par défaut pour agir ou supprimer. Une demande en attente déclenche un e-mail après cinq minutes ; sans réponse au bout de 72 heures, c’est un refus.
- Pas de boucle : un appel identique déjà réussi est refusé, le même outil est limité à cinq appels, et une conversation à trente étapes.
- Un budget d’IA mensuel, avec le coût suivi par exécution, par agent et par jour, et le temps gagné mis en regard.
- La sécurité : identifiants chiffrés, règles contre l’injection de consignes, aucun accès au réseau interne, chat public en lecture seule.
- Des droits : rôles administrateur et utilisateur, accès par équipe ou par personne.
Des cas d’usage déjà construits
- Les factures fournisseurs : lues à leur arrivée dans la boîte e-mail, découpées et classées, avec un accord humain au-delà de 500 €.
- Le courrier résumé sur Telegram : chaque e-mail important est résumé avec une proposition de réponse, envoyée seulement après un clic.
- Le service client d’une boutique en ligne : voir la démonstration complète.
La stack
- Serveur : TypeScript, Node, Fastify 5, PostgreSQL 17 avec Drizzle.
- Agents : Mastra et l’AI SDK, protocole MCP.
- Interface : React et Vite.
- Qualité : Vitest, plus de soixante-dix fichiers de tests, une base en mémoire pour les tests, Playwright pour le navigateur.
- IA : tout fournisseur compatible OpenAI, Anthropic, Gemini ou un modèle local, choisi dans l’administration.
Ce que ce socle change pour un client : on ne repart pas de zéro. Les questions de droits, de budget et de validation sont déjà réglées ; le temps du projet va à son métier.