Vai alla navigazione

Knowledge base

Fornisci al tuo agente conoscenze personalizzate per offrire risposte accurate e contestualizzate.

Una knowledge base è una raccolta di documenti che forniscono al tuo agente informazioni specifiche per il dominio, oltre ai dati su cui è stato pre-addestrato. Quando un documento è collegato a un agente, quest’ultimo può utilizzare il suo contenuto per rispondere alle domande in modo accurato e coerente.

Per creare, modificare e organizzare i documenti, consulta Gestire i documenti.

Panoramica

Una knowledge base ben curata fornisce al tuo agente le informazioni rilevanti per il tuo caso d’uso. Esempi comuni includono:

  • Cataloghi di prodotti: Specifiche, prezzi e disponibilità.
  • Policy: Policy HR, aziendali o di assistenza, ad esempio su resi, benefit o onboarding.
  • Documentazione tecnica: Guide e riferimenti API per sviluppatori.
  • FAQ dei clienti: Risposte coerenti alle domande più comuni.

Un singolo documento può essere collegato a più agenti, così puoi mantenere le conoscenze condivise in un unico posto.

L’agente in questa pagina è configurato con una conoscenza completa della documentazione e della sitemap di ElevenLabs. Chiedigli qualsiasi cosa su ElevenLabs.

Come il tuo agente usa le conoscenze

La modalità di utilizzo di ogni documento controlla in che modo l’agente lo utilizza, in uno dei due modi seguenti:

  • Contesto completo: L’agente inserisce il testo completo del documento nel suo system prompt, mantenendo l’intero documento disponibile a ogni turno. Poiché questo consuma contesto, funziona solo per documenti abbastanza piccoli da poter essere inclusi; per i documenti più grandi devi usare RAG.
  • Retrieval-Augmented Generation (RAG): Il documento viene indicizzato in anticipo e, durante la conversazione, vengono recuperati solo i passaggi più rilevanti per ogni query dell’utente affinché l’agente li possa usare. Questo consente all’agente di utilizzare knowledge base molto più grandi della finestra di contesto. Per configurazione e limiti, consulta la guida a RAG.

Imposta la modalità di utilizzo di ogni documento per scegliere il percorso seguito dall’agente:

Modalità di utilizzoComportamento
auto (predefinita)L’agente usa RAG quando abiliti RAG e il documento è indicizzato; altrimenti usa il contesto completo.
promptL’agente inserisce sempre il documento nel prompt, purché sia abbastanza piccolo da rientrare nel contesto.

L’agente accede sempre alle cartelle tramite RAG e non le inserisce mai nel prompt, quindi per usare le cartelle RAG deve essere abilitato sull’agente.

Formati di file supportati

I documenti possono essere creati da file, URL o testo. I file caricati possono essere nei seguenti formati, fino a 20 MB per file:

FormatoEstensione
PDF.pdf
Word.docx
Testo.txt
Markdown.md
HTML.html
EPUB.epub

Limiti di dimensione

Un documento può essere utilizzato nel contesto completo solo se il testo estratto rientra nel prompt, fino a circa 300.000 caratteri. I documenti più grandi devono invece essere utilizzati tramite RAG. La dimensione totale dei documenti che puoi indicizzare per RAG dipende dal tuo piano di abbonamento; consulta i limiti di utilizzo di RAG.

Puoi controllare la dimensione attuale della knowledge base di un agente da Claude o da un altro client MCP tramite il server MCP fornito.

Best practice

Qualità dei contenuti

Fornisci informazioni chiare, ben strutturate e pertinenti allo scopo del tuo agente.

Gestione delle dimensioni

Suddividi i documenti di grandi dimensioni in parti più piccole e mirate per migliorare il recupero e l’elaborazione.

Aggiornamenti regolari

Rivedi e aggiorna la knowledge base per mantenere le informazioni attuali e accurate.

Individua le lacune informative

Esamina le trascrizioni delle conversazioni per trovare gli argomenti per cui gli utenti faticano a ottenere risposte, quindi aggiungi il contesto mancante alla knowledge base.