> For the complete documentation index, see [llms.txt](https://docs.aisuru.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aisuru.com/istruzione-gestione-contenuti-agenti/importazione-di-documenti/importare-documenti-testuali.md).

# Importare documenti testuali

AIsuru ti consente di importare documenti testuali e trasformarli automaticamente in conoscenza per il tuo Agente. Questo processo ti permette di arricchire rapidamente la base di conoscenza del tuo assistente virtuale generando coppie di domande e risposte pertinenti dal contenuto dei tuoi documenti.

### Documenti supportati

**I formati supportati** includono: PDF (.pdf), testo semplice (.txt), Microsoft Word (.doc,.docx), Apple Pages (.pages), OpenDocument (.odt), Rich Text Format (.rtf), HTML (.html).

**AIsuru supporta la tecnologia OCR**, ma per ottenere risultati ottimali consigliamo di caricare documenti con testo già selezionabile. L'OCR funziona meglio su documenti ben scansionati con testo chiaro, ma potrebbe avere difficoltà con scansioni di bassa qualità o formattazioni complesse.

### Importare funzionalità da altri Agenti

Oltre all'importazione di documenti, AIsuru ti consente anche di importare funzionalità complete dagli altri tuoi Agenti. Tramite la scheda **"Importa da un altro agente"** puoi:

* Copiare [**funzioni avanzate**](/avanzate/integrazioni/funzioni/funzioni-avanzate.md) con tutte le relative configurazioni;
* Importare [**intenti dinamici**](/avanzate/integrazioni/intenti-dinamici.md) e i relativi **slot;**
* Trasferire il [**dizionario personalizzato.**](/istruzione-gestione-contenuti-agenti/dizionario.md)

Questa funzionalità è particolarmente utile quando vuoi replicare configurazioni complesse tra Agenti simili o creare backup delle tue implementazioni. Per maggiori dettagli, consulta la guida sulla copia di intenti dinamici, slot e funzioni da un altro Agente.

### Accedere alla sezione di importazione

1. **Vai al pannello di gestione del tuo Agente;**
2. Seleziona **Import / Export** nella barra laterale;
3. Puoi fare clic su "Click or drag file" o trascinare un file in quest'area per caricare un documento;
4. Una volta caricato il documento, scorri verso il basso per visualizzare un'anteprima del testo estratto e regolare le varie impostazioni di importazione.

Troverai due sezioni:

1. Opzioni di importazione;
2. Variabili di contesto.

### Opzioni di importazione

#### Scelta di cosa importare

Dopo aver caricato il documento, puoi selezionare:

* **Importa solo i nuovi contenuti**: se vengono generate domande simili a quelle esistenti, AIsuru non le importerà;
* **Importa tutti i contenuti**: importa l'intero contenuto del documento, anche se esistono già domande simili.

#### Personalizzazione dei contenuti

Puoi scegliere, selezionando la casella, se impostare tutti i contenuti come:

* **Non casuale**: le domande non verranno suggerite casualmente durante l'inattività dell'utente (per saperne di più, vai alla sezione relativa al [timeout](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/utilizzo-del-timeout.md));
* **Conclusiva:** la risposta non è seguita da ulteriori domande (ad esempio, "C'è qualcos'altro che vuoi sapere?").

Puoi anche **aggiungere un link a tutte le domande importate** (ad esempio, un link al file originale, così la fonte è sempre accessibile).

#### **Altre impostazioni**

Nelle opzioni di importazione, puoi anche regolare la granularità: **questa impostazione controlla quante coppie di domande e risposte vengono generate per paragrafo**. Puoi impostare:

* **Bassa:** meno contenuti per paragrafo, più rapida da elaborare e utile per testi discorsivi o narrativi;
* **Media:** l'opzione consigliata, genera un numero moderato di contenuti;
* **Alta:** genera molti contenuti per paragrafo, richiede più tempo ma è molto utile per testi densi di informazioni con molti concetti.

{% hint style="info" %} <mark style="color:blue;">Per ottenere</mark> <mark style="color:blue;">i migliori risultati,</mark> <mark style="color:blue;">**ti consigliamo di impostare la granularità su alta**</mark><mark style="color:blue;">.</mark>
{% endhint %}

Successivamente, ci sono le **istruzioni per la generazione delle domande**. Questo campo serve per **guidare l'IA generativa nel modo in cui creerà le domande**: è fondamentale per ottenere coppie di domande e risposte pertinenti e di alta qualità.

Nelle istruzioni devi fornire:

* un breve **contesto sul documento**: di cosa tratta? A cosa serve;
* un breve **contesto sull'utente finale**: chi è? Quali tipi di domande pone? Quale linguaggio usa;
* alcune **regole e istruzioni chiare e concise** per generare le domande.

Esempio:

```
This document describes company policies for workplace safety.

Instructions for question generation:
- Create questions covering the main safety topics mentioned in the document;
- Include questions about specific procedures, safety equipment, and employee responsibilities;
- Generate questions that test understanding of the consequences of not following safety rules;
- Create some scenario-based questions that require applying the policies to real situations.
```

#### Titolo dell'allegato della fonte (facoltativo):

Seleziona questa opzione se desideri includere il testo originale come allegato per ogni coppia di domande e risposte generata.

### Variabili di contesto

Nella sezione delle variabili di contesto puoi aggiungere: tag, argomenti impostati, argomenti necessari e assegnare un Ruolo.

#### Tag

I tag sono come categorie che puoi assegnare ai tuoi contenuti. Se imposti un tag durante l'importazione di un documento, tutte le coppie di domande e risposte generate da quel documento verranno contrassegnate con tali categorie.

Per impostazione predefinita, viene aggiunto un tag per identificare l'importazione; in questo modo, puoi sempre risalire ai contenuti provenienti da ciascun documento importato.

Puoi rimuovere i tag facendo clic sull'icona rossa del cestino accanto a ciascuno, oppure fai clic su "Aggiungi" per aggiungerne uno nuovo.

#### Imposta argomenti

Aggiungi il [contesto da impostare](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/contesto-argomenti-ed-etichette.md#set-context-and-required-context) quando l'utente pone domande specifiche.

#### Argomenti necessari

Gli utenti non avranno accesso alle coppie di domande e risposte create dall'importazione del documento, a meno che non abbiano prima impostato un argomento specifico.

#### **Assegnato a**

I contenuti estratti dal documento possono essere assegnati a un [**ruolo specifico**](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/come-attribuire-contenuti-a-ruoli-specifici.md) o al **pubblico**.

### Avvio dell'importazione e Storico import

Dopo aver configurato tutte le impostazioni, puoi avviare l'importazione facendo clic sul pulsante **Importa** in basso a sinistra.

Dopo aver avviato l'importazione, avrai accesso a una nuova scheda nella sezione Import / Export: **Storico import**.

Da questa sezione puoi vedere:

* **L'avanzamento** dell'importazione avviata;
* **Importazioni precedenti.**

Per ogni importazione, puoi vedere:

* Titolo del file;
* Data di inizio e fine del processo;
* Numero di domande importate;
* Se fai clic su **"Dati e configurazione dell'importazione"** vedrai anche:
  * Dimensione del file;
  * Nome del file;
  * Se i contenuti sono impostati come non casuali;
  * Granularità;
  * Istruzioni per la generazione delle domande;
  * Titolo della fonte;
  * Gestione dei link.

L'importazione di documenti testuali in AIsuru è un modo efficace e rapido per ampliare la base di conoscenze del tuo Agente.