> 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/istruzione-sezione-avanzata/importazione-avanzata-di-documenti/documento-non-supportato.md).

# Importare un documento non supportato

AIsuru supporta l'importazione di vari tipi di documenti di testo, ma potrebbe capitare di voler importare un formato che non è supportato ufficialmente. Questa guida ti aiuterà a gestire l'importazione di diversi tipi di file non standard, assicurandoti che il tuo Agente IA possa accedere a tali informazioni e utilizzarle efficacemente.

### Procedura generale

Se il formato del tuo documento non è supportato direttamente:

1. **Estrai il testo o le informazioni** dal tuo file;
2. **Incolla le informazioni estratte:**
   1. Nelle [istruzioni](/ai-generativa/prompt-engineering.md) se vuoi che l'IA abbia sempre tutto a disposizione (e se il testo contiene meno di 200.000 caratteri);
   2. Oppure nei [contenuti](/istruzione-gestione-contenuti-agenti/contenuti.md) se vuoi separare le informazioni per argomento:
      1. **Domanda**: inserisci una parola chiave;
      2. **Varianti di domanda**: scrivi domande specifiche per le quali tali informazioni sono utili;
      3. **Risposta**: incolla il testo estratto.
3. **Spiega come leggere e utilizzare i dati** nelle istruzioni del tuo Agente.

### Gestione di formati specifici

Ora che hai esaminato la procedura generale, puoi vedere come gestire formati di file specifici.

#### File Excel

I file Excel più semplici e le tabelle in generale possono essere convertiti in formato **markdown** e inseriti in un contenuto o nelle istruzioni del tuo Agente.

Se il tuo file Excel è più complesso e hai bisogno di una maggiore accuratezza nelle risposte:

1. **Identifica diverse categorie in cui raggruppare i dati;**
2. Partendo dal tuo file Excel, **estrai le informazioni e salvale in file JSON separati** (uno per categoria) con una struttura chiara e semplice che chiunque possa comprendere;
3. **Copia il codice JSON** e incollalo:
   1. Nelle **istruzioni** se il totale non supera i 200.000 caratteri;
   2. In **contenuti** separati (uno per categoria, corrispondenti ai file):
      1. **Domanda:** inserisci una parola chiave;
      2. **Varianti di domanda:** inserisci esempi di domande a cui l'IA dovrebbe poter rispondere in base a quei dati;
      3. **Risposta:** incolla il codice JSON;
   3. In [**funzioni**](/avanzate/integrazioni/funzioni.md) separate (una per categoria, corrispondenti ai file): puoi anche usare le funzioni per ospitare i tuoi contenuti. Basta rendere accessibile il tuo file JSON e l'Agente recupererà le informazioni quando necessario;
4. Nelle istruzioni, **spiega all'Agente dove trovare le informazioni** (nelle istruzioni, nei contenuti o nelle funzioni), **come leggere i dati** (la struttura JSON), **e come utilizzarli** per rispondere alle richieste degli utenti.

#### Video

AIsuru non supporta ufficialmente l'istruzione a partire da file video. Se vuoi rendere un video interrogabile:

1. **Ottieni una trascrizione del video** (usa Whisper di OpenAI o SharePoint per le riunioni di Teams);
2. Nelle istruzioni, **spiega cosa deve fare l'IA e incolla la trascrizione.**

Ecco fatto! L'IA sarà ora in grado di rispondere alle domande sul video. La qualità delle risposte dipenderà in larga misura dalla qualità della trascrizione.

Se utilizzi Microsoft SharePoint, puoi anche allegare il link del video, al timestamp esatto, a ciascuna risposta:

1. **Assicurati di includere i timestamp** della trascrizione nelle istruzioni del tuo Agente;
2. **Copia il link del video;**
3. **Personalizza e aggiungi queste istruzioni**:

```
1. VIDEO LINK:
 - The video is here: `...name.mp4`

2. TRANSCRIPT:
 - The transcript precedes each section with hh:mm:ss indicating the exact hour, minute, and second when something is said.
 - You MUST take the transcript, the EXACT timestamp, and the following rule into account when creating the link to a specific moment.

3. BUILDING THE LINK TO A SPECIFIC MOMENT:
 - If the timestamp indicates, for example, 5 minutes and 16 seconds, that means `5*60+16 = 316` seconds. You must then append this variable part to the link:
 `&nav=%7B%22playbackOptions%22%3A%7B%22startTimeInSeconds%22%3AXXX%7D%7D` where `XXX` must be replaced with the exact number of seconds.

### Example:
- Calculation: `5 minutes and 16 seconds = 5*60+16 = 316 seconds`
- Variable part: `&nav=%7B%22playbackOptions%22%3A%7B%22startTimeInSeconds%22%3A316%7D%7D`
- Full link: `...name.mp4&nav=%7B%22playbackOptions%22%3A%7B%22startTimeInSeconds%22%3A316%7D%7D`
```

Queste istruzioni sono state create per Microsoft SharePoint. Se utilizzi YouTube o un altro servizio, assicurati di modificare di conseguenza la parte variabile del link.

#### Immagini

Per importare informazioni dalle immagini:

1. Utilizza ChatGPT o Claude per ottenere una descrizione accurata e completa dell'immagine;
2. Esporta il testo e inseriscilo:
   1. **Nelle istruzioni:** se vuoi che l'Agente abbia sempre presenti le informazioni estratte;
   2. **In un contenuto:** se vuoi mostrare l'immagine in occasioni specifiche, con determinate parole chiave o domande:
      1. **Domanda:** inserisci una domanda a cui l'immagine risponde (o una parola chiave);
      2. **Varianti di domanda:** aggiungi altre domande per cui l'immagine potrebbe essere utile;
      3. **Risposta:** la descrizione dell'immagine;
      4. [Media](/istruzione-gestione-contenuti-agenti/contenuti/creazione-manuale-dei-contenuti.md#media-and-links): aggiungi la tua immagine.

L'importazione di documenti non supportati richiede un po' più di lavoro manuale, ma ti consente di integrare un'ampia gamma di informazioni nel tuo Agente IA. Scegli il metodo più appropriato in base al tipo di documento e alla struttura delle informazioni che contiene. Verifica sempre che le informazioni importate siano accurate e facilmente accessibili all'Agente, per garantire risposte precise e pertinenti.