IA
Poser une question sur un logiciel, recevoir une réponse sourcée
LeSachant répond aux questions sur une application du parc — « comment marche tel écran ? », « à quoi sert tel traitement ? » — et cite les pages sur lesquelles il s’appuie. Il s’adresse aux équipes qui reprennent, maintiennent ou font évoluer un logiciel.
Ce qu’elle fait
On déclare un dépôt de code. LeSachant le lit, et un rédacteur automatique en tire une documentation à trois niveaux : les parcours fonctionnels, les écrans, puis les éléments techniques (classes, tables, routes). Chaque page renvoie au fichier source et à sa version exacte.
Cette documentation est ensuite indexée. Quand on pose une question, LeSachant retrouve les passages utiles, rédige une réponse et cite ses sources.
À chaque mise à jour du dépôt, seuls les fichiers modifiés sont relus. La documentation suit le code sans tout reprendre.
L’application est en cours de mise au point sur une première application du parc, SmartDailyReach : 527 pages documentées, environ 4 150 extraits indexés. Elle n’est pas encore en service sur la plateforme.
Pour qui
Pour une équipe qui hérite d’un logiciel mal documenté. Pour un nouvel arrivant qui doit comprendre une application vite. Pour un dirigeant qui veut que la connaissance d’un logiciel ne dépende plus d’une seule personne.
Comment elle est construite
LeSachant est une application du socle V005, le cadre Java de l’équipe. Elle suit une règle : ne rien réécrire de ce qu’un pack du socle sait déjà faire.
- Tout le moteur de recherche et de rédaction vient du pack IA du socle (
socle-pack-ai) : découpage des textes, recherche qui combine sens et mots-clés, citations, rédaction de la documentation. Ce chantier a fait progresser le pack lui-même. - L’application n’ajoute que trois workers, ces unités de traitement autonomes du socle : le registre des dépôts, la moisson des fichiers modifiés et la rédaction des pages.
- Les textes sont convertis en vecteurs par le service d’embeddings local de l’équipe, et les réponses sont rédigées par un modèle joint par AgentIA. Les deux passent par la passerelle d’API de la plateforme.
- Le corpus et l’index vivent dans PostgreSQL avec son extension vectorielle.
- 117 actions sont exposées en MCP, le protocole qui permet à une IA d’appeler des outils.
Le chantier a aussi produit un kit de rétro-documentation : une méthode outillée, avec ses gabarits et ses contrôles, remise à d’autres agents pour documenter d’autres logiciels.
Points forts
Mesuré, pas supposé
Chaque réglage est jugé sur un banc de 30 questions notées à la main, en moyenne sur trois passages. Dernière mesure en régime normal : 30 réponses justes sur 30.
Aucune réponse fausse
Le critère prioritaire du banc est le nombre de réponses fausses. Il est à zéro sur les dernières mesures : quand LeSachant ne sait pas, il le dit.
Des sources vérifiables
Chaque réponse cite les pages utilisées, et chaque page renvoie au fichier source et à sa version. On remonte de la réponse jusqu’au code.
La documentation suit le code
Seuls les fichiers modifiés sont relus à chaque passage. La documentation reste à jour sans tout réindexer.
Une méthode transmissible
Le kit de rétro-documentation se remet à un autre agent. Il porte ses gabarits, sa grille d’évaluation et un contrôle automatique qui vérifie l’archive remise.