Base de connaissances (RAG)

La fonction de base de connaissances permet à votre agent IA de répondre aux questions en utilisant vos documents réels — notes de version, articles d'aide, politiques, tout ce qui est basé sur du texte.

Formats pris en charge

• PDF
• Markdown, texte brut
• Word (.docx) · CSV
• JSON (extrait sous forme de texte)

Processus de téléversement

1. Allez dans Connaissances → Téléverser un document
2. Choisissez un fichier (25 Mo max). Il est téléversé directement vers S3 via un POST présigné
3. Le worker prend en charge la tâche : extrait le texte → découpe en chunks d'environ 800 tokens → génère les embeddings avec OpenAI text-embedding-3-small → stocke dans pgvector
4. Le statut passe à READY une fois terminé

Fonctionnement de la récupération

À chaque message d'un visiteur, le worker génère les embeddings de la requête et exécute une recherche par distance cosinus sur les chunks de votre locataire. Les Top-K (5 par défaut) chunks qui passent un seuil de similarité sont insérés dans le prompt système.

Utiliser vos propres embeddings

Dans Agent IA → Embeddings, vous pouvez définir un endpoint d'API d'embedding personnalisé — utile si vous souhaitez utiliser Azure OpenAI, un Ollama local ou DuckLLM. L'endpoint de complétion de chat peut être différent de l'endpoint d'embedding, car les services d'agrégation ne prennent souvent pas en charge les embeddings.

Mise en cache

Un texte de requête identique touche un cache Redis de 24 heures, de sorte que la même FAQ ne génère pas de nouveaux embeddings à chaque visite. La mise en cache des prompts d'Anthropic est appliquée au prompt système + aux chunks récupérés pour des économies de coûts supplémentaires.

Quand ignorer le RAG

Désactivez RAG enabledsi votre agent IA est un simple bot de bavardage / qualification de leads qui n'a pas besoin de citer des documents.