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.

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

Apri la scheda Knowledge (conoscenza) dell'agente e scegli Drive in Add knowledge.
Clicca su Connect Google Drive. Si apre la schermata di consenso di Google.
Scegli il tuo account Google e consenti l'accesso. Se Google mostra una casella per Google Drive, lasciala spuntata.
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.

Importare i file

Clicca su Add from Google Drive. Si apre il selettore di file di Google.
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.
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.
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

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.

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:

Nella console di Google Cloud, crea un progetto o scegline uno.
In APIs & Services → Library, abilita la Google Drive API e la Google Picker API.
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.
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.
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.
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.
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.