Gestire i documenti

Gestisci la tua knowledge base dalla dashboard della knowledge base, dalla CLI o dall’API. Per scoprire cos’è una knowledge base e come la usano gli agenti, consulta Knowledge base.

Aggiungi documenti

I documenti possono essere creati da file, pagine web o testo semplice. Una volta creati, collegali a un agente per rendere disponibili i loro contenuti nelle conversazioni.

User agent del crawler

Le importazioni di URL e i job di scansione recuperano le pagine con lo user agent ElevenlabsBot/1.0.

Il crawler rispetta anche robots.txt. Le pagine non consentite per ElevenlabsBot o per tutti gli user agent vengono ignorate, quindi controlla le tue regole se manca una pagina che ti aspetti venga indicizzata. Per consentire esplicitamente il crawler:

User-agent: ElevenlabsBot
Allow: /

Aggiungi documenti esistenti a un agente

I documenti possono essere riutilizzati tra gli agenti, quindi le conoscenze condivise devono essere mantenute una sola volta.

1. Vai alla configurazione dell’agente.
2. Trova la sezione della knowledge base e fai clic su Aggiungi documento.
3. Seleziona un documento esistente dalla tua knowledge base oppure caricane uno nuovo.

Modifica documenti

Puoi modificare direttamente il contenuto di un documento invece di eliminarlo e ricaricarlo. La modifica di un documento rigenera automaticamente i relativi chunk per la ricerca nei contenuti e gli embedding RAG, mantenendo sincronizzati la ricerca e il recupero da parte dell’agente.

• Documenti di testo e file: Modifica il contenuto inline e salva.
• Documenti file: In alternativa, sostituisci il file sottostante con una nuova versione.
• Documenti URL: Modifica il contenuto quando la sincronizzazione automatica è disattivata. Quando è attivata, il ciclo di sincronizzazione gestisce il documento e le modifiche manuali sono bloccate.

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

Mantieni aggiornati i contenuti URL

I documenti creati da un URL possono essere aggiornati per recuperare nuovamente i contenuti più recenti dalla fonte. L’aggiornamento reindicizza il documento, in modo che gli agenti con RAG abilitato utilizzino i contenuti aggiornati.

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

Nella dashboard puoi anche abilitare la sincronizzazione automatica per aggiornare automaticamente i documenti URL secondo una pianificazione, così i loro contenuti rimangono aggiornati senza interventi manuali.

Organizza con le cartelle

Le cartelle raggruppano documenti correlati, così sono più facili da gestire e da collegare in blocco. Crea una cartella, quindi sposta al suo interno i documenti dalla dashboard o tramite l’API.

Una cartella collegata a un agente rende tutti i suoi documenti disponibili tramite RAG, quindi l’agente deve avere RAG abilitato per usare le cartelle.

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

Dipendenze ed eliminazione

Ogni documento ha una scheda Agenti dipendenti che elenca gli agenti che al momento dipendono da esso.

Un documento non può essere eliminato finché un agente dipende da esso. Rimuovi prima il documento da tali agenti oppure usa l’eliminazione forzata per scollegarlo da tutti i dipendenti in una sola volta.