Creer un agent alimente par vos documents
En bref
Ce tutoriel vous guide dans la creation d'un agent IA capable de repondre aux questions de vos utilisateurs en s'appuyant sur vos documents internes (PDF, Word, pages web). L'agent recherche les informations pertinentes dans votre base de connaissances et formule des reponses sourcees.
Modules utilises : Base de connaissances, Agent Studio.
Duree estimee : 15 minutes.
Ce que vous allez faire
- Importer des documents dans la base de connaissances
- Attendre la fin de l'indexation
- Creer un agent specialise
- Configurer les outils de recherche documentaire
- Tester l'agent avec des questions
Prerequis
- Un workspace Ontologie actif
- Des documents a importer (PDF, DOCX ou URLs)
Etape 1 : Importer des documents
- Allez dans Base de connaissances depuis la barre laterale.
- Cliquez sur + Importer.
- Selectionnez le mode d'import :
- Fichiers : glissez-deposez vos PDF ou documents Word
- URL : saisissez l'adresse d'une page web a indexer
- Cliquez sur Importer.
L'indexation demarre automatiquement. Chaque document passe par plusieurs etapes :
- Extraction du texte
- Decoupage en segments
- Generation des embeddings (representations vectorielles)
- Indexation pour la recherche
Attendez que le statut de chaque document passe a Indexe avant de continuer.
Pour plus de details : Importer des documents.
Etape 2 : Creer un agent specialise
- Allez dans Agent Studio.
- Cliquez sur + Creer un agent.
- Remplissez la configuration :
- Nom :
Assistant Documentation(ou un nom de votre choix) - Instructions systeme : decrivez le role de l'agent, par exemple :
- Nom :
Tu es un assistant specialise qui repond aux questions en te basant
sur la documentation interne de l'entreprise. Cite toujours tes
sources. Si tu ne trouves pas l'information dans les documents,
dis-le clairement plutot que d'inventer une reponse.
- Cliquez sur Creer.
Etape 3 : Configurer les outils
- Dans la configuration de l'agent, allez dans l'onglet Outils.
- Activez les outils suivants :
| Outil | Description |
|---|---|
searchDocumentation | Recherche dans la base de connaissances par pertinence semantique |
hybridSearch | Recherche combinee (semantique + mots-cles + graphe) |
- Desactivez les outils non necessaires pour eviter les distractions (ex. outils de tableur si l'agent ne doit pas y acceder).
Etape 4 : Tester l'agent
-
Ouvrez le chat de l'agent.
-
Posez des questions basees sur le contenu de vos documents :
Quelle est la politique de remboursement ?Comment configurer le module X ?Quelles sont les etapes pour le processus Y ?
-
Verifiez que l'agent :
- Repond en s'appuyant sur les documents importes
- Cite les sources (nom du document, section)
- Indique clairement quand il ne trouve pas l'information
Utiliser le Visualiseur
Pour comprendre le raisonnement de l'agent :
- Cliquez sur Visualiseur dans la barre d'outils.
- Observez la boucle OODA : l'agent observe la question, s'oriente vers les bons outils, decide de la strategie de recherche et agit en interrogeant la base de connaissances.
Pour plus de details : Visualiseur.
Etape 5 : Affiner
Si les reponses ne sont pas satisfaisantes :
| Probleme | Solution |
|---|---|
| L'agent ne trouve pas les informations | Verifiez que les documents sont bien indexes (statut "Indexe") |
| Reponses trop generiques | Ameliorez les instructions systeme avec des exemples concrets |
| L'agent invente des informations | Ajoutez dans les instructions : "Ne reponds que si tu trouves l'information dans les documents" |
| Reponses en anglais | Precisez dans les instructions : "Reponds toujours en francais" |
Resultat attendu
Votre agent IA repond aux questions en s'appuyant sur vos documents internes. Les reponses sont sourcees et fiables. Vous pouvez enrichir la base de connaissances a tout moment en important de nouveaux documents.
Pour aller plus loin
- Sources de connaissances — Types de sources supportees
- Graphe de connaissances — Explorer les liens entre documents
- Tester et evaluer — Mesurer la qualite des reponses
- Connecter et analyser — Ajouter des donnees structurees
Besoin d'aide ?
Ecrivez-nous : Support et contact.