# 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: * **Conclusivi**: l'AI non chiederà ulteriori informazioni dopo aver risposto; * **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. ### Gestione contesto All'interno della sezione di gestione del 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 come conclusivi o 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aisuru.com/istruzione-gestione-contenuti-agenti/importazione-di-documenti/importare-documenti-testuali.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.