> 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 permette 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, creando domande e risposte pertinenti a partire dal contenuto dei tuoi documenti. ### Documenti supportati I **formati supportati** sono: PDF (.pdf), file di testo (.txt); Microsoft Word (.doc, .docx), Apple Pages (.pages). OpenDocument (.odt), Rich Text Format (.rtf), HTML (.html). **AIsuru supporta la tecnologia OCR**, ma per un risultato ottimale consigliamo di caricare documenti con testo già selezionabile. L'OCR funziona meglio su documenti ben scansionati e con testo chiaro, mentre potrebbe avere difficoltà con documenti di bassa qualità o con formattazioni complesse. ### Importazione di funzionalità da altri Agenti Oltre all'importazione di documenti, AIsuru ti permette di importare funzionalità complete da altri tuoi Agenti. Attraverso il tab "Importa Funzioni e Intenti" puoi: * Copiare [**funzioni avanzate**](/avanzate/integrazioni/funzioni/funzioni-avanzate.md) con tutte le loro configurazioni; * Importare [**intenti dinamici**](/avanzate/integrazioni/intenti-dinamici.md) e i relativi **slot;** * Trasferire il [**dizionario**](/istruzione-gestione-contenuti-agenti/dizionario.md) **personalizzato;** Questa funzionalità è particolarmente utile quando vuoi replicare configurazioni complesse tra Agenti simili o creare backup delle tue implementazioni. Per maggiori dettagli, consulta la guida Copia gli intenti dinamici, gli slot e le funzioni da un altro Agente. ### Accesso alla sezione di import 1. **Accedi al pannello di gestione** del tuo Agente; 2. Seleziona **Import / Export** nella barra laterale; 3. Premi sul tasto "**Choose file**" e scegli il documento da importare. 4. Una volta caricato il documento, scorri in basso per vedere un'anteprima del testo estratto e modificare le diverse impostazioni dell'import. Troverai due sezioni: 1. Opzioni di importazione; 2. Gestione contesto. ### Opzioni di importazione #### Scelta dei contenuti da importare Dopo aver caricato il documento potrai selezionare l'opzione: * **importa solo i nuovi contenuti**: se vengono generate domande simili a quelle già presenti, AIsuru non le importerà; * **importa tutto**: importa l'intero contenuto del documento, anche se sono già presenti domande simili. #### Personalizzazione dei contenuti Puoi scegliere, mettendo la spunta alla casella, se impostare tutti i contenuti come: * **Non casuali**: le domande non verranno suggerite casualmente in caso di inattività dell'utente (per saperne di più, vai alla sezione dedicata al [timeout](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/utilizzo-del-timeout.md)). Inoltre, potrai **aggiungere un link a tutte le domande importate** (ad esempio, al file originale, per avere sempre la fonte consultabile). #### **Altre impostazioni** Nelle opzioni di importazione, puoi anche modificare la granularità: **questa impostazione permette di generare più o meno domande e risposte per ogni paragrafo**. Puoi impostare una granularità: * **Bassa:** verranno importati pochi contenuti per paragrafo e ci metterà meno tempo, utile per i testi discorsivi; * **Media:** l'opzione consigliata, creerà un numero medio di contenuti; * **Alta:** verranno creati molti contenuti per paragrafo, ci metterà più tempo ma è molto utile per testi densi di informazioni con tanti concetti. {% hint style="info" %} Per un risultato migliore, **ti consigliamo di impostare la granularità su high**. {% endhint %} Infine, vi sono le **istruzioni per la generazione delle domande**. Questo spazio serve a **guidare l'IA generativa nella creazione di domande**: è cruciale ottenere domande e risposte pertinenti e di qualità. Nelle istruzioni devi fornire: * un breve **contesto sul documento**: di cosa parla? per cosa è utile? * un breve **contesto sull'utente finale**: chi è? Che tipo di domande fa? Con che linguaggio? * alcune **regole e istruzioni chiare e concise** per generare le domande. Esempio: ``` Questo documento descrive le politiche aziendali per la sicurezza sul lavoro. Istruzioni per la generazione delle domande: - Crea domande che coprano i principali argomenti di sicurezza menzionati nel documento; - Includi domande su procedure specifiche, equipaggiamento di sicurezza e responsabilità dei dipendenti; - Genera domande che verifichino la comprensione delle conseguenze del non rispetto delle norme di sicurezza; - Crea alcune domande di scenario che richiedano l'applicazione delle politiche a situazioni reali. ``` #### Allega fonte (opzionale) Seleziona questa opzione se desideri includere l'estratto del testo originale come allegato per ogni coppia domanda-risposta generata. ### Variabili di contesto All'interno della sezione di variabili di contesto puoi aggiungere: tag, argomenti impostati e argomenti necessari. #### Tag I tag sono come categorie che puoi attribuire ai tuoi contenuti. Se imposti un tag in fase di import di un documento, tutte le domande e risposte generate dal tuo documento saranno taggate con le categorie impostate. Di default, viene aggiunto un tag che identifica il tuo import: in questo modo, avrai sempre traccia dei contenuti creati dal documento importato. Puoi rimuovere i contenuti premendo sul cestino rosso ![](/files/4sshSgqS8U48WRbrV0op) accanto a ciascun tag o puoi premere su "Aggiungi" per aggiungerne uno. #### Imposta argomenti Aggiungi il [contesto da impostare](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/contesto-argomenti-ed-etichette.md#contesto-impostato-e-contesto-necessario) quando l'utente fa specifiche domande. #### Argomenti necessari L'utente non avrà accesso alle domande e risposte create con l'import del documento se prima non avrà impostato un certo argomento. #### **Assegnato a** I contenuti che verranno estratti dal documento possono essere assegnati ad un [**ruolo specifico**](/istruzione-gestione-contenuti-agenti/istruzione-sezione-avanzata/personalizzazione-dei-contenuti/come-attribuire-contenuti-a-ruoli-specifici.md) o puoi assegnarli al **pubblico.** ### Lancio dell'importazione e Storico import Una volta settate tutte le impostazioni, puoi lanciare l'importazione cliccando sul tasto **Importa** in basso a sinistra. Dopo aver fatto partire l'import, avrai accesso ad una nuova scheda nella sezione Import / Export: **Storico import**. Da questa sezione potrai vedere: * **L'andamento del processo** di importazione che hai lanciato; * **Gli import passati**. Per ogni import, potrai vedere: * Titolo del file; * Data di inizio e fine del processo; * Numero di domande importate; * Se premi sul menu "dati dell'import e configurazioni" vedrai anche: * Dimensione file; * Nome file; * Se i contenuti sono impostati 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 arricchire la conoscenza del tuo Agente. Sfrutta al massimo questa funzionalità per creare un assistente virtuale informato e capace di fornire risposte accurate e pertinenti ai tuoi utenti.