# Addestra il tuo agente AI sui file di Google Drive

> Collega Google Drive a un agente intoCHAT, scegli Documenti, Fogli, Presentazioni, PDF, file Word, di testo e Markdown, tienili sincronizzati: limiti e configurazione dell'app Google.

Se FAQ, listini prezzi, condizioni o schede prodotto stanno in Google Drive, puoi scegliere quei file e il tuo agente impara da essi. intoCHAT può aprire solo i file che scegli. Li legge e non modifica mai nulla nel tuo Drive.

> L'opzione **Drive** in **Add knowledge** mostra "Google Drive isn't configured on this server." quando Google Drive non è stato configurato per questa installazione di intoCHAT. Puoi comunque scaricare i file da Google Drive in formato PDF, Word o testo e caricarli come [file](/it/docs/files). Se gestisci tu l'installazione, vedi [Configurare l'app Google](#configurare-l-app-google).

## Cosa puoi importare

| File in Drive | Come lo legge intoCHAT |
|---|---|
| Google Documenti | Esportato in Markdown, così titoli ed elenchi restano (testo semplice se Google non riesce a esportarlo in Markdown) |
| Google Fogli | Ogni foglio, come un titolo con il nome del foglio e le sue righe in CSV. Vengono lette fino a 1.000 righe per foglio |
| Google Presentazioni | Esportato come testo semplice |
| PDF | Scaricato e letto come un PDF caricato |
| Word (`.docx`) | Scaricato e letto come un file Word caricato |
| Testo (`.txt`) e Markdown (`.md`) | Scaricati così come sono |

Altri file, come immagini, video, Google Moduli o cartelle, non compaiono nel selettore di file. Un PDF scansionato senza livello di testo non si può leggere; prima passalo all'OCR.

## Solo i file che scegli

intoCHAT chiede a Google solo il permesso `drive.file`. Con questo, intoCHAT può aprire i file che scegli nel selettore di file di Google, e nient'altro del tuo Drive:

- Non può elencare, cercare o leggere gli altri tuoi file, le cartelle o i Drive condivisi.
- Ogni file che scegli viene condiviso da Google con intoCHAT nel momento in cui lo scegli. Sceglierlo di nuovo in seguito è il modo per ridare l'accesso, se era stato tolto.
- Nella schermata di consenso di Google compare come "See, edit, create, and delete only the specific Google Drive files you use with this app". intoCHAT si limita a leggerli.

Il selettore di file è di Google: mostra il tuo Drive perché tu possa scegliere, ma intoCHAT viene a sapere solo dei file che selezioni.

## Collegare Google Drive

1. Apri la scheda **Knowledge** (conoscenza) dell'agente e scegli **Drive** in **Add knowledge**.
2. Clicca su **Connect Google Drive**. Si apre la schermata di consenso di Google.
3. Scegli il tuo account Google e consenti l'accesso. Se Google mostra una casella per Google Drive, lasciala spuntata.
4. Torni alla scheda **Knowledge**, che mostra "Google Drive connected" e, accanto a **Connected as**, il tuo account Google.

Il collegamento appartiene al tuo account intoCHAT, quindi tutti i tuoi agenti possono importare da lì. Si collega un solo account Google alla volta; collegarne di nuovo uno sostituisce il precedente. Se annulli nella schermata di Google, non viene collegato nulla. Se ci resti più di 10 minuti, ricomincia dall'opzione **Drive**.

Collegare e scollegare richiede il livello **Manage** per le integrazioni, quindi possono farlo il proprietario e gli admin. Vedi [Membri del team e ruoli](/it/docs/team).

## Importare i file

1. Clicca su **Add from Google Drive**. Si apre il selettore di file di Google.
2. Seleziona fino a 10 file. Il selettore ha una scheda per il tuo Drive e una per i Drive condivisi. Le cartelle si aprono, così puoi scegliere i file al loro interno.
3. Clicca su **Select**. intoCHAT legge i file, il che può richiedere qualche secondo per file.

Se sono stati aggiunti o aggiornati file, l'addestramento parte da solo. Un messaggio riassume l'importazione, per esempio "3 added, 1 updated, 0 unchanged". Ogni file diventa una fonte di tipo **Google Drive**, con il nome del file, un link al file in Drive e la data dell'ultima modifica.

- **Tutto o niente.** Se un file non si può leggere, o se i file superano il limite di caratteri dell'agente, non viene importato nulla e la tua conoscenza resta com'era. Il messaggio nomina il file quando può. Oltre il limite, intoCHAT mostra **Character limit reached**.
- **Scegliere di nuovo un file lo aggiorna.** La fonte esistente riceve il nuovo testo invece di una seconda copia. Un file il cui testo non è cambiato resta com'è.
- **I file vuoti vengono saltati** e compaiono come "skipped (no text)".
- **I fogli grandi vengono tagliati.** Di ogni foglio vengono lette solo le prime 1.000 righe, e il messaggio nomina il foglio di calcolo. Dividi un foglio più grande in più fogli o file.

I membri con il livello **Edit** per la conoscenza possono scegliere e importare file. Li scelgono dal Drive dell'account Google collegato, quindi dai quel livello solo a persone di cui ti fidi.

## Mantenere i file aggiornati

Il testo importato non cambia quando modifichi il file in Drive. Per riprendere le tue modifiche:

- **Clicca su Sync now** nell'opzione **Drive**. intoCHAT controlla quando è stato modificato l'ultima volta ogni file Drive dell'agente e rilegge solo quelli cambiati. Vengono riaddestrati solo i file il cui testo è cambiato.
- **Attiva l'Auto-resync.** Con un calendario giornaliero o settimanale, intoCHAT fa lo stesso controllo per te. I file Drive non consumano scansioni del sito, e un giro legge fino a 30 file Drive. Vedi [Auto-resync](/it/docs/managing-sources#auto-resync).
- **Scegli di nuovo il file** con **Add from Google Drive**.

Un file rinominato in Drive prende il nuovo nome al controllo successivo.

Se un file è stato eliminato, spostato nel cestino o intoCHAT non ha più il permesso di aprirlo, il controllo non riesce e la fonte mostra un messaggio, mentre il testo salvato resta nella tua conoscenza. Scegli di nuovo il file, oppure elimina la fonte se non ti serve più.

## Limiti

| Limite | Valore |
|---|---|
| File per importazione | 10 |
| Dimensione del file (PDF, Word, testo, Markdown) | 50 MB, come per i caricamenti |
| Testo per file | 4 MB, come per i caricamenti |
| Google Documenti e Presentazioni | Quello che Google riesce a esportare: fino a 10 MB di testo |
| Google Fogli | 1.000 righe per foglio |
| Caratteri | Contano sul limite di caratteri dell'agente, come ogni fonte. Vedi [Piani e limiti](/it/docs/plans-and-limits) |

## I file di Drive restano privati

- I file Drive non compaiono mai come link alle fonti sotto una risposta. Solo le pagine web hanno link.
- L'agente vede il nome di un file, ma non il suo indirizzo in Drive, quindi non può passare il link ai visitatori.
- intoCHAT salva in forma cifrata l'accesso al tuo account Google, e il browser riceve solo un accesso di breve durata per il selettore di file.

> Tutto ciò che è nella conoscenza dell'agente può finire in una risposta. Importa solo file il cui testo condivideresti con i visitatori.

## Scollegare Google Drive

Clicca su **Disconnect** nell'opzione **Drive**. Nella finestra di dialogo scegli cosa succede ai file che hai importato:

- **Tenerli (predefinito).** Restano nella conoscenza di tutti i tuoi agenti così come sono ora, ma non vengono più sincronizzati. L'Auto-resync li segna con "Google Drive was disconnected. Connect Google Drive and pick this file again to keep it in sync."
- **Also delete the … files imported from Google Drive, in all your agents.** Spunta questa casella per eliminare anche loro.

intoCHAT revoca il proprio accesso presso Google ed elimina l'accesso salvato. Puoi anche rimuovere intoCHAT dal tuo account Google in **Security → Third-party apps & services**. Se lo fai solo lì, il controllo successivo mostra "Google Drive access was revoked or has expired. Reconnect Google Drive to keep this file in sync."

## Quando qualcosa va storto

| Messaggio | Cosa fare |
|---|---|
| "Google Drive isn't configured on this server." | Google Drive non è configurato per questa installazione. Carica invece i file in **Files**, oppure configura l'app Google come descritto sotto. |
| "Google didn't grant access to the files you pick." | Collegati di nuovo e lascia spuntata la casella di Google Drive nella schermata di Google. |
| "This file was deleted in Google Drive, or intoCHAT can no longer open it." | Scegli di nuovo il file da Google Drive, oppure elimina la fonte. |
| "This file is in the Google Drive trash." | Ripristinalo in Drive, oppure elimina la fonte. |
| "intoCHAT is no longer allowed to open this file." | Chiedi l'accesso al proprietario del file, poi sceglilo di nuovo. |
| "The file's owner turned off downloading, so intoCHAT can't read it." | Chiedi al proprietario di consentire il download, oppure crea una copia di tua proprietà. |
| "Google can't export this file because it is too large" | Dividi il Documento o la Presentazione in file più piccoli. |
| "Google Drive is limiting requests right now." | Aspetta qualche minuto, poi riprova. |
| Compare **Reconnect Google Drive** | L'accesso di intoCHAT è stato revocato o è scaduto. Cliccaci sopra per collegarti di nuovo. |

## Configurare l'app Google

Questa sezione è per chi gestisce l'installazione di intoCHAT. I clienti di intoCHAT non ne hanno bisogno.

Google Drive richiede un client OAuth, una chiave API e il numero di progetto di uno stesso progetto Google Cloud:

1. Nella [console di Google Cloud](https://console.cloud.google.com/), crea un progetto o scegline uno.
2. In **APIs & Services → Library**, abilita la **Google Drive API** e la **Google Picker API**.
3. In **Google Auth Platform**, configura la schermata di consenso: nome dell'app, un'email di assistenza, il tuo dominio e i link alla tua informativa sulla privacy e ai tuoi termini. Come pubblico scegli **External**. In **Data access**, aggiungi l'ambito `https://www.googleapis.com/auth/drive.file`. È un ambito non sensibile, quindi all'app basta la verifica di base del brand da parte di Google, senza la valutazione di sicurezza prevista per gli ambiti con restrizioni.
4. In **Clients** (oppure **Credentials → Create credentials → OAuth client ID**), crea un client di tipo **Web application**:
   - **Authorized redirect URI:** l'indirizzo della tua app seguito da `/api/integrations/google-drive/callback`, per esempio `https://www.example.com/api/integrations/google-drive/callback`. Deve corrispondere esattamente a `NEXT_PUBLIC_APP_URL`.
   - **Authorized JavaScript origin:** l'indirizzo della tua app, per esempio `https://www.example.com`.
   - Salva l'ID client come `GOOGLE_DRIVE_CLIENT_ID` e il client secret come `GOOGLE_DRIVE_CLIENT_SECRET`.
5. In **Credentials → Create credentials → API key**, crea una chiave per il selettore di file. Limitala a **Websites** con l'indirizzo della tua app e alla **Google Picker API**. Salvala come `NEXT_PUBLIC_GOOGLE_DRIVE_API_KEY`.
6. Copia il **numero di progetto** (non l'ID del progetto) dalla dashboard del progetto o da **IAM & Admin → Settings**, e salvalo come `NEXT_PUBLIC_GOOGLE_DRIVE_APP_ID`. Deve essere il progetto del client OAuth: Google concede i file scelti a quell'app.
7. Esegui di nuovo il deploy. Con tutte e quattro le impostazioni presenti, l'opzione **Drive** offre **Connect Google Drive**.

I token vengono cifrati con `TOKEN_ENCRYPTION_KEY` (oppure con `NEXTAUTH_SECRET` se non è impostato). Cambiare quel segreto rende illeggibili i collegamenti salvati, e i proprietari devono collegarsi di nuovo.

Finché la schermata di consenso è in **Testing**, possono collegarsi solo gli utenti di test che aggiungi, e Google fa scadere il loro accesso dopo 7 giorni. Pubblica l'app in **In production** per tutti.