Comment structurer ses données pour créer un agent IA de service client ?
La qualité de votre base de connaissance conditionne 80 % du succès d’un agent IA. Voici ce qu’il faut savoir avant d’écrire la première ligne de code.
Par Alexandre BRU11 min de lecturePourquoi la moitié des projets d’agent IA échouent avant même l’outil
Sur les projets d’agent IA que nous auditons, un constat revient. Quand une équipe raconte un projet raté, elle décrit presque toujours des symptômes techniques : « l’agent répondait à côté », « il inventait des choses », « les clients ne comprenaient pas ses réponses ». Ces symptômes sont réels. Mais la cause n’est presque jamais dans l’outil.
Elle est dans la documentation source.
Un agent IA moderne fonctionne selon un principe simple. Il reçoit une question, cherche dans une base de connaissance des passages pertinents, puis formule une réponse en s’appuyant sur ces passages. Cette technique, appelée RAG (Retrieval-Augmented Generation), est devenue le standard du marché en 2025. Elle a un avantage majeur : l’agent ne parle que de ce qu’il trouve dans la documentation, ce qui réduit drastiquement les réponses inventées.
Mais cette technique a une conséquence directe. Si votre documentation est mauvaise, votre agent sera mauvais, quelle que soit la qualité du modèle IA sous-jacent. Un cas d’étude publié dans une revue MDPI en 2025 illustre bien ce point : sur exactement le même modèle technique de RAG appliqué à un service client, la performance mesurée de l’agent varie de 40 à 90 % uniquement en fonction de la qualité de la base sur laquelle il s’appuie.
Ce constat est cohérent avec ce que documente le rapport State of Service 2025 de Salesforce auprès de 6 500 professionnels du service client dans le monde : la qualité de la documentation et la clarté des process internes ressortent comme les deux premiers facteurs de succès ou d’échec d’un déploiement d’IA côté service client.
C’est un renversement de perspective majeur. La question centrale d’un projet d’agent IA n’est pas « quel outil choisir » mais « quelle base de connaissance lui donner ».
Qu’est-ce qu’une base de connaissance vraiment utilisable par une IA ?
Le terme « base de connaissance » est ancien. Il désigne dans la plupart des entreprises un ensemble de documents dispersés entre FAQ, procédures internes, articles d’aide, échanges par email et fichiers Word plus ou moins à jour. Ce n’est pas ce qu’attend un agent IA.
Trois différences fondamentales séparent une base « utilisable par un humain » d’une base « utilisable par une IA ».
Le format. Un humain sait naviguer entre plusieurs documents pour recomposer une information. Une IA cherche des passages précis dans une base structurée. Chaque contenu doit être découpé en unités autonomes, avec un titre explicite, une question à laquelle il répond, et une réponse compréhensible sans référence à d’autres documents.
La cohérence. Un humain peut décider entre deux versions contradictoires d’une même procédure. Une IA n’a pas ce filtre. Si votre documentation dit à un endroit « la garantie est de 12 mois » et à un autre « la garantie est de 24 mois », l’agent produira des réponses aléatoires.
La fraîcheur. Un humain sait qu’une procédure datée de 2019 est probablement obsolète. Une IA la traite comme n’importe quelle autre information. Une base non tenue à jour produit des réponses fausses à des questions basiques, ce qui détruit la confiance des clients en quelques semaines.
Les 4 problèmes qu’on trouve dans 90 % des documentations existantes
Sur les projets que nous accompagnons chez maria, quatre défauts reviennent presque systématiquement dans les bases documentaires existantes. Les identifier est la première étape pour construire quelque chose d’utilisable.
| Problème | Symptôme typique | Impact sur l’agent IA |
|---|---|---|
| Dispersion des sources | Documentation éclatée entre 3 à 8 outils différents | L’agent ne voit qu’une partie de la vérité |
| Obsolescence silencieuse | Contenus non mis à jour depuis 12 à 36 mois | L’agent répond avec des informations fausses sans le savoir |
| Contradictions internes | Deux documents disent des choses différentes sur le même sujet | Les réponses de l’agent varient au hasard |
| Formulations non structurées | Documents rédigés pour être lus, pas pour être interrogés | L’agent trouve mal ou mal reformule |
Le problème 1 : la dispersion des sources. Dans la plupart des entreprises que nous auditons, la documentation utile pour un agent IA se trouve répartie entre 3 à 8 outils différents : FAQ publique du site, articles Zendesk ou Freshdesk, procédures internes sur Notion ou Confluence, emails de la direction produit, fichiers Word sur un Drive partagé, échanges Slack cristallisant des règles. Aucun de ces silos n’est complet à lui seul. Consolider ces sources est un travail de plusieurs jours à plusieurs semaines selon la taille de l’organisation.
Le problème 2 : l’obsolescence silencieuse. La plupart des documentations d’entreprise n’ont pas de gouvernance de mise à jour. Un article a été écrit un jour, il est resté tel quel. Les changements de politique produit, de tarification, de procédure, sont diffusés en interne mais rarement répercutés dans la documentation existante. Résultat : la documentation reflète la réalité de l’entreprise d’il y a 18 mois, pas celle d’aujourd’hui.
Le problème 3 : les contradictions internes. Dès qu’une entreprise dépasse 30 personnes, sa documentation contient presque toujours des contradictions. Deux articles écrits par deux personnes différentes à deux moments différents ne disent pas la même chose. Sur « quel est le délai de rétractation ? », « que couvre la garantie ? », « comment un client peut-il modifier son abonnement ? », les réponses varient selon la source consultée. Un agent IA amplifiera ces contradictions.
Le problème 4 : les formulations non structurées. La plupart des contenus de documentation existants ont été écrits pour être lus par un humain, pas cherchés par une IA. Les informations utiles sont diluées dans du texte narratif, les questions ne sont pas explicites, les réponses présupposent des connaissances implicites. Un humain retrouve l’essentiel. Une IA passe à côté.
Comment structurer une base de connaissance pour un agent IA : la méthode maria
Sur les projets d’agent IA que nous cadrons, une méthode s’est stabilisée pour préparer la base de connaissance. Elle tient en cinq principes qui guident tout le travail de consolidation.
Principe 1 : Une seule source de vérité par sujet
Pour chaque motif que votre agent doit traiter (délai de livraison, politique de retour, gestion des accès, disponibilité produit), il doit exister exactement une source de vérité. Pas deux, pas cinq. Une seule.
Concrètement : vous listez les motifs à couvrir, vous identifiez le contenu source unique pour chacun, vous supprimez ou vous fusionnez les doublons. Ce travail révèle presque toujours des désaccords internes qu’il faut trancher avant de continuer. C’est douloureux mais indispensable.
Principe 2 : Chaque contenu doit être autoportant
Un contenu autoportant est un contenu compréhensible sans contexte extérieur. Il commence par une question ou un titre explicite. Il donne la réponse complète. Il précise les cas particuliers. Il indique explicitement les limites de la règle.
Un contre-exemple typique : un article qui commence par « Comme évoqué dans la procédure XYZ… ». Un agent IA qui trouve ce passage ne saura pas ce que dit la procédure XYZ. La formulation autoportante serait : « La politique de retour s’applique dans les cas suivants : [liste explicite]. Elle ne s’applique pas dans les cas suivants : [liste explicite] ».
Principe 3 : Une gouvernance de mise à jour formalisée
Une base de connaissance vivante nécessite un cycle de revue. Sur nos projets, nous recommandons trois niveaux de revue : mensuel pour les contenus à forte volatilité (tarifs, disponibilités, promotions), trimestriel pour les contenus opérationnels (procédures, politiques), annuel pour les contenus fondamentaux (mentions légales, principes généraux).
Une personne responsable est nommée par domaine. Les mises à jour laissent une trace horodatée. Les contenus non revus depuis leur seuil de validité sont automatiquement signalés pour vérification.
Principe 4 : Un format lisible par l’IA
Le format compte autant que le contenu. Une base optimisée pour un agent IA structure chaque contenu selon un modèle standard : titre clair sous forme de question, réponse principale en 2 à 5 phrases, cas particuliers listés explicitement, exemples concrets, liens vers les procédures liées.
Ce format n’est pas neutre. Il conditionne la capacité de l’IA à retrouver le bon passage et à formuler une réponse correcte. Sur les projets que nous accompagnons, la simple réécriture d’une documentation existante dans ce format améliore la performance de l’agent de 20 à 40 points, sans changer une ligne de code.
Principe 5 : Un cycle de curation continue
Une base de connaissance n’est jamais finie. Chaque interaction de l’agent avec un client révèle des trous : des questions qu’il n’a pas su traiter, des réponses partiellement fausses, des cas non prévus. Un cycle de curation continue capitalise sur ces retours.
Concrètement : les échanges où l’agent a échoué sont analysés chaque semaine, les contenus manquants ou insuffisants sont identifiés, la documentation est enrichie. Cette boucle est ce qui fait la différence entre un agent qui plafonne à 50 % de résolution et un agent qui atteint 75 à 85 % en 6 mois.
Combien de FAQ faut-il pour démarrer ? Le seuil critique
Une question revient souvent sur les projets : combien de contenus faut-il dans la base avant de pouvoir lancer un pilote ? La réponse dépend de la couverture souhaitée, pas d’un nombre absolu.
Le bon indicateur : la couverture des motifs. Vous listez les 10 à 20 motifs de contact les plus fréquents de votre service client (vos superviseurs les connaissent). Pour chacun, vous vérifiez que la base contient une réponse claire, autoportante et à jour. Le seuil de démarrage est atteint quand vous couvrez au moins 80 % des motifs prioritaires.
Ordres de grandeur pratiques. Pour un service client d’e-commerce standard, un pilote démarre bien avec 30 à 50 contenus autoportants. Pour un service client d’un SaaS BtoB, comptez plutôt 80 à 150 contenus, car les cas d’usage sont plus techniques. Pour un service financier ou assurantiel, la couverture peut dépasser 300 contenus dès le pilote, en raison des exigences réglementaires.
Le piège à éviter. Vouloir tout couvrir avant de démarrer. Une base « complète » n’existe pas, et l’attendre est le meilleur moyen de ne jamais démarrer. Mieux vaut lancer un pilote sur un périmètre bien couvert et enrichir en continu, que reporter indéfiniment en cherchant la perfection.
Quel travail de curation continue prévoir ?
Une fois l’agent en production, la base doit vivre. Voici les rituels que nous recommandons sur nos projets.
Un rituel hebdomadaire de 30 à 60 minutes. Une personne dédiée (souvent le superviseur de service client) analyse un échantillon de conversations où l’agent a été mis en difficulté, identifie les contenus manquants ou insuffisants, propose des ajouts ou modifications.
Un rituel mensuel de 2 à 4 heures. Revue de la performance globale de l’agent, croisement avec les évolutions produit ou service, mise à jour coordonnée des contenus concernés.
Un rituel trimestriel d’une demi-journée. Revue stratégique : les motifs traités sont-ils toujours les bons ? De nouveaux motifs sont-ils apparus ? La performance globale progresse-t-elle ? Sur cette base, on ajuste le périmètre couvert par l’agent.
Cette charge peut sembler légère. Elle est en réalité ce qui fait la différence entre un agent qui reste performant sur la durée et un agent qui se dégrade silencieusement. Sur les projets que nous auditons, les agents qui décrochent le font presque toujours parce que la curation continue a été négligée.
« La performance d’un agent IA en année 2 dépend moins de sa performance en année 1 que de la discipline de curation qu’on a mise en place. Un agent moyen bien maintenu bat un agent excellent laissé à l’abandon. C’est vrai pour la relation client, c’est vrai pour beaucoup de choses. »
Par où commencer si votre doc est actuellement dispersée ou obsolète ?
La plupart des entreprises qui envisagent un agent IA constatent, en début de cadrage, que leur documentation n’est pas prête. Ce n’est pas une raison de renoncer. Voici l’ordre d’action que nous recommandons.
Semaine 1 : cartographier vos sources documentaires existantes. Où est la documentation aujourd’hui ? Combien d’outils ? Quel volume ? Qui la maintient ? Cette cartographie révèle presque toujours des surprises.
Semaine 2 : lister les 15 à 20 motifs de contact les plus fréquents de votre service client. Pour chaque motif, vérifier ce qui existe déjà dans votre documentation, identifier les trous et les contradictions.
Semaine 3 : sur les 5 à 8 motifs prioritaires, réécrire ou consolider le contenu au format autoportant. Cette étape prend en général 2 à 4 heures par motif, selon l’état de départ.
Semaine 4 : mettre en place une gouvernance simple. Un responsable par domaine, un calendrier de revue, un endroit unique où stocker la vérité consolidée. Cette gouvernance existera avant l’agent IA, elle continuera après.
À l’issue de ce mois, vous n’avez pas encore d’agent IA en production. Mais vous avez posé les fondations qui feront la différence entre un projet réussi et un projet raté. Sur les cas que nous accompagnons, les entreprises qui prennent le temps de ce préalable arrivent à un pilote en production 2 à 3 mois plus tard, avec une performance qui tient. Celles qui sautent cette étape lancent plus vite mais rejouent souvent tout après un premier échec.
Pour la vue d’ensemble d’un projet d’agent IA service client (méthode, budget, délais, pièges), voir Réduire la charge de votre service client avec un agent IA. Pour prendre du recul sur l’enjeu plus large du sujet, voir aussi Knowledge management et IA : pourquoi vous devez organiser votre savoir avant de déployer un agent.
En résumé
La qualité de votre base de connaissance conditionne 60 à 80 % du succès d’un projet d’agent IA de service client. Une base mal préparée produit un agent médiocre quel que soit l’outil choisi. Cinq principes structurent une bonne base : une seule source de vérité, chaque contenu autoportant, une gouvernance de mise à jour formalisée, un format lisible par l’IA, un cycle de curation continue. La préparation d’une base utilisable prend 2 à 6 semaines selon l’état de départ. Le rituel de curation continue mobilise ensuite quelques heures par semaine. Ce travail apporte de la valeur bien au-delà du projet IA initial : formation, cohérence interne, communication, copilote pour les agents humains. Un investissement qui paye longtemps.
// vos questions
Les questions qu’on nous pose
Rarement telle quelle. Les FAQ existantes ont été écrites pour être lues par un humain, pas cherchées par une IA. Elles sont souvent trop courtes, peu structurées, avec des références implicites à d’autres contenus. Une réécriture au format autoportant est nécessaire dans la plupart des cas. En revanche, la FAQ existante est un excellent point de départ pour identifier les motifs à couvrir.
Deux stratégies coexistent. La première : consolider physiquement les contenus dans un seul outil, ce qui simplifie la gouvernance mais demande un effort important de migration. La seconde : connecter l’agent IA aux différentes sources via des API, en veillant à éviter les conflits. La bonne stratégie dépend de votre organisation, mais dans les deux cas, un travail de tri et de consolidation reste nécessaire.
Sur les projets que nous accompagnons, comptez 2 à 6 semaines selon l’état de départ. Une entreprise dont la documentation est déjà bien tenue peut préparer une base pilote en 2 semaines. Une entreprise dont la documentation est dispersée et obsolète peut avoir besoin de 6 semaines de travail préalable. Dans tous les cas, ce temps est un investissement, pas un coût perdu.
Non, et c’est un point important. Une base de connaissance bien structurée sert à plusieurs usages : agent IA client, copilote pour les agents humains, formation des nouveaux collaborateurs, communication interne cohérente. Sur nos projets, nous constatons que le travail de préparation apporte de la valeur bien au-delà du projet IA initial.
Pas nécessairement au démarrage. Un espace Notion, Confluence ou Google Workspace bien structuré suffit pour un pilote. Les outils dédiés (Zendesk Guide, Document360, Atlassian Refined) apportent de la valeur à l’échelle, quand le volume de contenus et le nombre de contributeurs augmente. Cette question se pose en général à partir de 200 à 300 contenus actifs.
