> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Knowledge base

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](/docs/it/eleven-agents/customization/knowledge-base/manage-documents).

## 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.

> **Info**
>
> 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](/docs/it/eleven-agents/customization/knowledge-base/rag).

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

| Modalità di utilizzo | Comportamento                                                                                               |
| :------------------- | :---------------------------------------------------------------------------------------------------------- |
| `auto` (predefinita) | L'agente usa RAG quando abiliti RAG e il documento è indicizzato; altrimenti usa il contesto completo.      |
| `prompt`             | L'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:

| Formato  | Estensione |
| :------- | :--------- |
| 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](/docs/it/eleven-agents/customization/knowledge-base/rag#usage-limits).

Puoi controllare la dimensione attuale della knowledge base di un agente da Claude o da un altro client MCP tramite il [server MCP fornito](/docs/it/eleven-agents/operate/hosted-mcp).

## 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.