Passer au contenu principal

​
Vue d’ensemble

Créer une base de connaissances est ta première étape pour donner à ton agent IA une connaissance de niveau expert de ton entreprise. Ce guide t’accompagne tout au long du processus complet, de la création de la base de connaissances à l’organisation du contenu et au respect des meilleures pratiques.
Planifie ta structure de connaissances avant de commencer. Une base de connaissances bien organisée est plus facile à maintenir et plus efficace pour tes agents.

​
Étape 1 : Créer une Base de Connaissances

  1. Connecte-toi à ton tableau de bord itellicoAI
  2. Clique sur Knowledge Bases dans le menu de navigation de gauche
  3. Clique sur le bouton + Créer une Base de Connaissances

​
Remplir les Informations de Base

Dialogue Créer une Base de Connaissances avec les champs nom et description
Dialogue Créer une Base de Connaissances avec les champs nom et description
1

Entrer le Nom de la Base de Connaissances

Choisis un nom clair et descriptif qui reflète la catégorie de contenu.Règles de nommage :
  • Lettres, chiffres, espaces, traits d’union et underscores uniquement
  • Pas de caractères spéciaux (@, #, $, etc.)
  • Maximum 100 caractères
Bons exemples :
  • “FAQ Support Client”
  • “Documentation Produit”
  • “Politiques d’Entreprise”
  • “Dépannage Technique”
À éviter :
  • “KB_001” (pas descriptif)
  • “Docs Divers” (trop vague)
  • “Tout!!!” (pas professionnel)
2

Ajouter une Description (Optionnel)

Fournis un contexte sur ce que cette base de connaissances contient et quand l’utiliser.Exemples de descriptions :
  • “Documentation de support orientée client incluant FAQ, politiques et guides de dépannage”
  • “Spécifications produit internes, documentation des fonctionnalités et détails techniques”
  • “Politiques RH d’entreprise, documents de conformité et procédures internes”
3

Cliquer sur Créer

Ta base de connaissances est maintenant créée et prête pour le contenu !

​
Étape 2 : Organiser avec des Dossiers

Les dossiers organisent tes éléments de connaissance en groupes logiques.
Un dossier par défaut est automatiquement créé lorsque tu crées une nouvelle base de connaissances. Tu peux le renommer, ajouter d’autres dossiers ou commencer à ajouter des éléments immédiatement.

​
Ajouter des Dossiers Supplémentaires (Optionnel)

  1. Ouvre ta base de connaissances
  2. Clique sur le bouton Créer un Dossier
  3. Entre un nom de dossier
  4. Ajoute une description optionnelle
  5. Clique sur Créer

​
Meilleures Pratiques de Nommage des Dossiers

Clair & Spécifique

  • “Facturation & Paiements”
  • “Politiques de Retour”
  • “Spécifications Produit”
  • “Problèmes Techniques”

Vague ou Générique

  • “Trucs”
  • “Dossier 1”
  • “Docs”
  • “Divers”

​
Combien de Dossiers ?

3-5 dossiers sont généralement suffisantsExemple de structure :
  • Questions Clients
  • Politiques d’Entreprise
  • Informations Produit
5-10 dossiers offrent une bonne organisationExemple de structure :
  • Facturation & Paiements
  • Support Technique
  • Fonctionnalités Produit
  • Gestion de Compte
  • Expédition & Retours
  • FAQ Générale
10-15 dossiers gardent les choses gérablesEnvisage de diviser en plusieurs bases de connaissances si tu dépasses 15 dossiers.Exemple de structure :
  • Configuration Compte
  • Problèmes Facturation
  • Modes de Paiement
  • Remboursements & Crédits
  • Catégories Produit A-F
  • Catégories Produit G-M
  • Catégories Produit N-Z
  • Dépannage Technique
  • Guides Intégration
  • Documentation API
  • Retours & Échanges
  • Options Expédition
  • Suivi Commande

​
Étape 3 : Ajouter des Éléments de Connaissance

Les éléments de connaissance sont le contenu réel - les documents, FAQ, politiques et informations que tu souhaites que ton agent connaisse.
Dialogue Créer un Nouvel Élément montrant les options Contenu Texte, Télécharger un Fichier et Page Web
Dialogue Créer un Nouvel Élément montrant les options Contenu Texte, Télécharger un Fichier et Page Web
Tu peux ajouter des éléments de connaissance de trois manières différentes. Choisis la méthode qui convient le mieux à ton contenu :
Idéal pour : FAQ, politiques, procédures, informations de référence rapideSaisie directe de texte à l’aide de l’éditeur intégré. Parfait pour le contenu que tu crées spécifiquement pour ton base de connaissances.

​
Comment Ajouter un Élément Texte

1

Cliquer sur 'Ajouter un Élément de Connaissance'

Dans ton dossier, Clique sur le bouton ajouter pour créer un nouvel élément.
2

Sélectionner 'TEXT' comme catégorie

Choisis texte si tu saisis le contenu directement.
3

Entrer un titre descriptif

Bons titres :
  • “Politique de Retour pour Produits Numériques”
  • “Instructions Réinitialisation Mot de Passe”
  • “Niveaux de Tarification Expliqués”
À éviter :
  • “Doc 1”
  • “Politique”
  • “Info”
4

Rédiger ou coller ton contenu

Entre les informations que tu souhaites que ton agent connaisse. Sois clair et complet.Exemple :
Politique de Retour pour Produits Numériques

Les produits numériques peuvent être remboursés dans les 30 jours suivant l'achat si :
1. Le produit présente un défaut technique empêchant son utilisation
2. La description du produit était matériellement inexacte
3. Le client n'a pas accédé ni téléchargé le produit

Les remboursements ne sont pas disponibles pour :
- Changement d'avis après avoir accédé au produit
- Problèmes de compatibilité divulgués dans la description du produit
- Erreur utilisateur ou mauvaise compréhension des fonctionnalités

Pour demander un remboursement, les clients doivent envoyer un e-mail à support@company.com
avec leur numéro de commande et la raison de la demande de remboursement.

Délai de traitement : 5-7 jours ouvrables
5

Cliquer sur 'Créer'

Ton élément de connaissance est enregistré et sera traité immédiatement.
Idéal pour : Manuels utilisateur, spécifications produit, documents légaux, supports de formationTélécharge des documents dans divers formats jusqu’à 10 Mo. Le système extrait et traite le contenu textuel.Formats pris en charge : PDF, Word (.doc, .docx), Texte (.txt, .log), Markdown (.md), CSV/TSV, JSON, YAML, XML

​
Comment Ajouter un Fichier

1

Cliquer sur 'Ajouter un Élément de Connaissance'

Dans ton dossier, Clique sur le bouton ajouter.
2

Sélectionner 'FILE' comme catégorie

Choisis fichier pour les téléchargements de documents.
3

Entrer un titre

Donne à ton fichier un titre descriptif (le nom de fichier sera stocké séparément).
4

Télécharger ton fichier

Clique sur Télécharger et Sélectionne ton document.Exigences :
  • Formats pris en charge : PDF, Word (.doc, .docx), Texte (.txt, .log), Markdown (.md), CSV/TSV, JSON, YAML, XML
  • Taille maximale : 10 Mo
  • Documents textuels et images numérisées (l’analyse avancée gère la plupart des numérisations)
5

Cliquer sur 'Créer'

Le système téléchargera et commencera à traiter ton fichier. Le statut changera de PENDING → PROCESSING → COMPLETED.
Le temps de traitement des fichiers varie en fonction de la taille et de la complexité du fichier. Les gros fichiers (5-10 Mo) peuvent prendre plusieurs minutes à traiter.
Idéal pour : Pages de documentation, articles de blog, articles d’aide, ressources externesExtraire le contenu d’une seule page web (pas de sites web entiers).

​
Comment Ajouter une URL

1

Cliquer sur 'Ajouter un Élément de Connaissance'

Dans ton dossier, Clique sur le bouton ajouter.
2

Sélectionner 'URL' comme catégorie

Choisis URL pour extraire du contenu web.
3

Entrer un titre

Donne au contenu un titre descriptif.
4

Entrer l'URL source

Colle l’URL complète incluant https://Exemple :
https://docs.company.com/api/authentication
5

Cliquer sur 'Créer'

Le système récupérera et traitera le contenu de la page web. Le statut changera de PENDING → PROCESSING → COMPLETED.
L’extraction URL fonctionne mieux avec des pages web simples basées sur du texte. Les applications JavaScript complexes ou les pages nécessitant une authentification peuvent ne pas s’extraire avec succès.

​
Comprendre les Statuts de Traitement

Après avoir ajouté un élément de connaissance, il passe par deux pipelines de traitement distincts. Tu verras les deux statuts dans l’interface :

​
Statut de Traitement du Contenu

Cela suit si le contenu a été extrait avec succès depuis ton source.
Élément créé et en file d’attente pour traitement. Prend généralement quelques secondes.
Le contenu est en cours de traitement maintenant :
  • Fichiers : Analyse de documents à l’aide de nos analyseurs de documents IA avancés
  • URLs : Récupération et extraction de la page web
  • Texte : Passe cette étape (va directement à COMPLETED)
Contenu extrait et stocké avec succès. L’indexation vectorielle commencera automatiquement.
L’extraction du contenu a échoué. Causes courantes :
  • Le fichier est corrompu ou protégé par mot de passe
  • L’URL nécessite une authentification ou utilise du JavaScript complexe
  • Le fichier dépasse la limite de 10 Mo
Corrections rapides :
  • Essaie de télécharger le contenu en tant que TEXT à la place
  • Supprime la protection par mot de passe du fichier
  • Divise les gros fichiers en documents plus petits
Besoin d’aide ?Si le problème persiste, contactez notre équipe support à support@itellico.ai avec :
  • Le titre de l’élément de connaissance
  • Le type de fichier ou l’URL que tu essaies d’ajouter
  • Tout message d’erreur affiché

​
Statut d’Indexation Vectorielle

Après l’extraction du contenu, il doit être indexé pour RAG (Génération Augmentée par Récupération). Cela permet à ton agent de trouver les connaissances pertinentes en fonction du sens.
En attente du début de l’indexation vectorielle. Le traitement du contenu s’est terminé avec succès.
Création d’embeddings vectoriels pour RAG :
  • Le contenu est divisé en morceaux
  • Des embeddings IA sont générés
  • Les vecteurs sont stockés dans la base de données
Cela peut prendre plusieurs minutes pour les gros documents.
L’élément est entièrement prêt ! L’agent peut maintenant trouver et utiliser ces connaissances via la recherche sémantique.
L’indexation vectorielle a échoué. Le contenu est extrait mais n’apparaîtra pas dans les résultats de recherche RAG.Corrections rapides :
  • Clique sur le bouton Réindexer sur l’élément de connaissance pour réessayer l’indexation
  • Si la réindexation échoue, Essaie de supprimer et recréer l’élément
  • Assure-toi que le contenu n’est pas trop court (nécessite au moins quelques phrases)
Besoin d’aide ?Si la réindexation ne fonctionne pas, contactez notre équipe support à support@itellico.ai avec :
  • Le titre de l’élément de connaissance
  • Quand tu as créé l’élément
  • Type de contenu (TEXT, FILE, ou URL)
Les deux statuts doivent réussir pour une fonctionnalité complète :
  • Statut Contenu : COMPLETED
  • Statut Vecteur : INDEXED
Seulement alors ton agent peut utiliser les connaissances dans les conversations.

​
Directives de Qualité du Contenu

​
Rédiger un Contenu Clair et Complet

Ne présume pas de connaissances. Explique clairement.Au lieu de : “Les clients peuvent retourner les articles dans notre fenêtre standard.”Écris : “Les clients peuvent retourner les articles dans les 30 jours suivant l’achat. Les articles doivent être inutilisés et dans l’emballage d’origine avec toutes les étiquettes attachées.”
Évite le jargon à moins qu’il ne soit standard dans l’industrie et que ton public le connaisse.Au lieu de : “Utilise le point de terminaison d’authentification pour générer un token porteur.”Écris : “Pour toi authentifier, appelez le point de terminaison /auth. Vous recevrez un token d’accès à inclure dans les requêtes suivantes.”
Les exemples rendent les concepts abstraits concrets.Exemple : “Nos niveaux de tarification incluent :
  • Basic : 29 $/mois - Jusqu’à 1 000 contacts
  • Pro : 99 $/mois - Jusqu’à 10 000 contacts
  • Enterprise : Tarification personnalisée - Contacts illimités”
Utilise des titres et des points de liste pour un contenu scannable.Bonne structure :
Politique de Retour

Articles Éligibles :
- Produits non ouverts dans l'emballage d'origine
- Articles achetés dans les 30 jours
- Produits sans signes d'utilisation

Articles Non Éligibles :
- Téléchargements numériques
- Produits personnalisés
- Articles en solde marqués comme vente finale

Processus :
1. Envoyer un e-mail à support@company.com
2. Fournir le numéro de commande
3. Recevoir l'autorisation de retour
4. Expédier l'article dans les 7 jours
Chaque élément devrait couvrir un sujet en profondeur. Diviser les grands sujets en plusieurs éléments.Au lieu de : Un “Manuel Complet de l’Entreprise” de 20 pagesCréer :
  • Politique de Retour
  • Options d’Expédition
  • Modes de Paiement
  • Garantie Produit
  • Politique de Confidentialité
  • Coordonnées

​
Lier la Base de Connaissances aux Agents

Une fois que ta base de connaissances a du contenu, tu devras la lier à tes agents pour qu’ils puissent accéder aux informations.

Attribuer des Connaissances aux Agents

Apprends comment connecter ton base de connaissances aux agents et choisir la bonne méthode d’accès (Contexte vs RAG).

​
Prochaines Étapes

Attribuer aux Agents

Connecter ton base de connaissances aux agents

Contexte vs RAG

Choisir comment tes agents accèdent aux connaissances

Meilleures Pratiques d'Architecture

Apprendre à structurer et organiser les bases de connaissances