Skip to navigation
ConfigurerenKennisbank

Documenten beheren

Maak, bewerk, organiseer en houd je kennisbankdocumenten up-to-date.

Beheer je kennisbank vanuit het kennisbankdashboard, de CLI of de API. Lees Kennisbank voor meer informatie over wat een kennisbank is en hoe agents deze gebruiken.

Hoofdinterface van de kennisbank met een lijst van documenten

Documenten toevoegen

Je kunt documenten maken van bestanden, webpagina’s of platte tekst. Koppel ze na het maken aan een agent om de inhoud beschikbaar te maken in gesprekken.

Klik in het kennisbankdashboard, of rechtstreeks vanuit de configuratie van een agent, op Document toevoegen en kies een bron.

1

Bestand

Upload een document in PDF-, TXT-, DOCX-, HTML-, EPUB- of Markdown-indeling, tot 20 MB per bestand.

Interface voor het uploaden van bestanden met ondersteunde indelingen en de limiet van 20 MB

2

URL

Importeer een webpagina door de URL te plakken. Gebruik de crawloptie om een volledige site op te nemen — crawl de hele website door links vanaf de start-URL te volgen, of importeer pagina’s vanuit de sitemap van de site. Als het importeren van een pagina mislukt, controleer dan of je site de user agent van de crawler toestaat.

Interface voor het importeren van URL's waarin gebruikers een link naar documentatie kunnen plakken

Zorg dat je toestemming hebt om de inhoud van de URL’s die je opgeeft te gebruiken.
3

Tekst

Voer tekst handmatig in en geef deze een naam.

Tekstinvoerinterface waarin gebruikers aangepaste inhoud kunnen benoemen en toevoegen

User agent van de crawler

URL-imports en crawltaken halen pagina’s op met de user agent ElevenlabsBot/1.0.

Als je site achter een CDN, WAF of regel voor botbescherming staat, sta deze user agent dan toe zodat de crawler je pagina’s kan lezen. Wanneer een request wordt geblokkeerd, wordt het document gemaakt maar kan er geen inhoud uit worden geëxtraheerd.

De crawler houdt ook rekening met robots.txt. Pagina’s die niet zijn toegestaan voor ElevenlabsBot of voor alle user agents worden overgeslagen. Controleer daarom je regels als een pagina die je verwacht te indexeren ontbreekt. Zo sta je de crawler expliciet toe:

robots.txt
User-agent: ElevenlabsBot
Allow: /

Bestaande documenten aan een agent toevoegen

Documenten kunnen door meerdere agents worden hergebruikt, dus gedeelde kennis hoeft maar één keer te worden onderhouden.

  1. Ga naar de configuratie van de agent.
  2. Zoek het gedeelte voor de kennisbank en klik op Document toevoegen.
  3. Selecteer een bestaand document uit je kennisbank of upload een nieuw document.

Interface voor het toevoegen van documenten aan een agent

Door documenten voor meerdere agents te hergebruiken, blijft kennis consistent en voorkom je dubbele uploads.

Documenten bewerken

Je kunt de inhoud van een document rechtstreeks bewerken in plaats van het te verwijderen en opnieuw te uploaden. Als je een document bewerkt, worden automatisch de chunks voor het doorzoeken van inhoud en de RAG-embeddings opnieuw gegenereerd, zodat zoeken en het ophalen van informatie door de agent gesynchroniseerd blijven.

  • Tekst- en bestandsdocumenten: Bewerk de inhoud inline en sla op.
  • Bestandsdocumenten: Je kunt ook het onderliggende bestand vervangen door een nieuwe versie.
  • URL-documenten: Bewerk de inhoud wanneer automatisch synchroniseren is uitgeschakeld. Wanneer automatisch synchroniseren is ingeschakeld, beheert de synchronisatiecyclus het document en zijn handmatige bewerkingen geblokkeerd.

De inhoud van een document inline bewerken in de kennisbank 

# 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"),
)

URL-inhoud up-to-date houden

Documenten die vanuit een URL zijn gemaakt, kunnen worden vernieuwd om de nieuwste inhoud van hun bron opnieuw op te halen. Vernieuwen indexeert het document opnieuw, zodat agents met RAG de bijgewerkte inhoud gebruiken.

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

In het dashboard kun je ook automatisch synchroniseren inschakelen om URL-documenten volgens een schema automatisch te vernieuwen, zodat de inhoud zonder handmatige updates actueel blijft.

Organiseren met mappen

Mappen groeperen gerelateerde documenten, zodat je ze eenvoudiger kunt beheren en in bulk kunt koppelen. Maak een map en verplaats er vervolgens documenten naartoe vanuit het dashboard of de API.

Een map die aan een agent is gekoppeld, maakt alle documenten daarin beschikbaar via RAG. Daarom moet RAG voor de agent zijn ingeschakeld om mappen te gebruiken.

Een map maken en documenten ernaartoe verplaatsen 

# 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,
)

Afhankelijkheden en verwijderen

Elk document heeft een tabblad Afhankelijke agents met de agents die er momenteel van afhankelijk zijn.

Detailweergave van een document met het tabblad Afhankelijke agents

Een document kan niet worden verwijderd zolang een agent ervan afhankelijk is. Verwijder het document eerst uit die agents, of gebruik geforceerd verwijderen om het in één keer los te koppelen van alle afhankelijkheden.