Gérer les documents

Gérez votre base de connaissances depuis le Dashboard de la base de connaissances, la CLI ou l’API. Pour savoir ce qu’est une base de connaissances et comment les agents l’utilisent, consultez Base de connaissances.

Ajouter des documents

Les documents peuvent être créés à partir de fichiers, de pages web ou de texte brut. Une fois créés, associez-les à un agent afin de rendre leur contenu disponible dans les conversations.

Agent utilisateur du crawler

Les importations d’URL et les tâches d’exploration récupèrent les pages avec l’agent utilisateur ElevenlabsBot/1.0.

Le crawler respecte également robots.txt. Les pages interdites à ElevenlabsBot ou à tous les agents utilisateurs sont ignorées. Vérifiez donc vos règles si une page que vous prévoyez d’indexer est absente. Pour autoriser explicitement le crawler :

User-agent: ElevenlabsBot
Allow: /

Ajouter des documents existants à un agent

Les documents peuvent être réutilisés entre les agents, les connaissances partagées ne doivent donc être gérées qu’une seule fois.

1. Accédez à la configuration de l’agent.
2. Recherchez la section de la base de connaissances et cliquez sur Ajouter un document.
3. Sélectionnez un document existant dans votre base de connaissances ou importez-en un nouveau.

Modifier les documents

Vous pouvez modifier directement le contenu d’un document au lieu de le supprimer et de l’importer à nouveau. La modification d’un document régénère automatiquement ses segments de recherche de contenu et ses embeddings RAG, afin que la recherche et la récupération par l’agent restent synchronisées.

• Documents texte et fichier : modifiez le contenu directement et enregistrez-le.
• Documents fichier : vous pouvez également remplacer le fichier sous-jacent par une nouvelle version.
• Documents URL : modifiez le contenu lorsque la synchronisation automatique est désactivée. Lorsqu’elle est activée, le cycle de synchronisation gère le document et les modifications manuelles sont bloquées.

# Update a document's name or content
elevenlabs.conversational_ai.knowledge_base.documents.update(
    documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
    name="Unladen Swallow Facts",
    content="The airspeed velocity of an unladen swallow (European) is 24 miles per hour.",
)
# Replace the underlying file of a file document
elevenlabs.conversational_ai.knowledge_base.document.update_file(
documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
file=open("/path/to/unladen-swallow-facts-v2.txt", "rb"),
)

Maintenir le contenu des URL à jour

Les documents créés à partir d’une URL peuvent être actualisés afin de récupérer le contenu le plus récent de leur source. L’actualisation réindexe le document afin que les agents utilisant RAG exploitent le contenu mis à jour.

elevenlabs.conversational_ai.knowledge_base.document.refresh(
    documentation_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
)

Dans le Dashboard, vous pouvez également activer la synchronisation automatique pour actualiser les documents URL selon une planification, afin que leur contenu reste à jour sans intervention manuelle.

Organiser avec des dossiers

Les dossiers regroupent les documents associés afin de faciliter leur gestion et leur association en masse. Créez un dossier, puis déplacez-y des documents depuis le Dashboard ou l’API.

Un dossier associé à un agent rend tous ses documents disponibles via RAG. RAG doit donc être activé sur l’agent pour utiliser des dossiers.

# Create a folder
folder = elevenlabs.conversational_ai.knowledge_base.documents.create_folder(
    name="Product documentation",
)
# Move a document into the folder
elevenlabs.conversational_ai.knowledge_base.documents.move(
document_id="i2YYI6huwBmcgYydAXARmQJc3pmX",
move_to=folder.id,
)

Dépendances et suppression

Chaque document comporte un onglet Agents dépendants qui répertorie les agents qui en dépendent actuellement.

Un document ne peut pas être supprimé tant qu’un agent en dépend. Retirez d’abord le document de ces agents, ou utilisez la suppression forcée pour le dissocier de tous les éléments dépendants en une seule fois.