Documenti
Google Drive
Cerca e legge file di Google Drive (Documenti, Fogli, PDF, Office); crea file di testo con conferma.
- Accesso con Connetti (OAuth)
- Azioni con conferma
- Sorgente sincronizzabile
- Rispetta i permessi dei file
Strumenti per l’agente
L’agente sceglie da solo lo strumento adatto alla domanda. Nella scheda MCP e database dell’agente puoi disattivare quelli che non servono.
| Strumento | Cosa fa | Tipo |
|---|---|---|
search_files | Cerca file per nome o per contenuto, anche in una sola cartella. | Lettura |
read_file | Testo di un file: Documenti e Presentazioni come testo, Fogli come tabella, PDF, Word ed Excel estratti. | Lettura |
list_folder | Contenuto di una cartella (anche «Il mio Drive»). | Lettura |
create_text_file | Crea un file di testo (o un Documento Google) in una cartella. Richiede conferma. | Con conferma |
Le azioni che modificano dati sono spente di default. Si attivano nella connessione con l’opzione Consenti la creazione di file (con conferma); poi ogni azione mostra in chat un riepilogo e parte solo con Conferma ed esegui.
Configurazione passo per passo
In Kaiross apri Integrazioni, scegli Google Drive e premi Nuova connessione. Il modulo mostra la stessa guida sotto Guida e permessi consigliati.
- console.cloud.google.com → nuovo progetto → API e servizi → Libreria → abilita Google Drive API.
- Schermata di consenso OAuth: tipo Interno (Google Workspace) così solo gli utenti del dominio possono autorizzare.
- Credenziali → Crea credenziali → ID client OAuth → Applicazione web; in URI di reindirizzamento autorizzati incolla il Redirect URI mostrato qui sotto.
- Copia Client ID e Client secret, salva e premi Connetti con l’account da usare. Permessi richiesti: lettura dei file e creazione di nuovi file.
Campi del modulo: Client ID OAuth.
Da incollare (cifrato nel Vault, poi non più visibile): Client secret.
Permessi dei file (sorgenti sincronizzate): con Rispetta i permessi della fonte ogni documento è visibile in chat solo a chi può aprirlo in Drive (utenti, domini, gruppi, «chiunque abbia il link»). Nessuno scope in più: bastano quelli sopra.
Gruppi Google: i membri si leggono con l’Admin SDK API (scope https://www.googleapis.com/auth/admin.directory.group.member.readonly, account amministratore). Lo scope non è richiesto di default per non bloccare il consenso agli utenti normali: se il token non lo include, i documenti condivisi solo con un gruppo restano non risolti (visibili solo a chi gestisce la knowledge) e la sorgente lo segnala.
Accesso con «Connetti» (OAuth)
- Nel modulo della connessione copia il valore Indirizzo di ritorno (Redirect URI) da registrare nell’app OAuth (icona Copia indirizzo di ritorno).
- Registra l’app OAuth presso il fornitore (passi qui sopra) incollando quel Redirect URI.
- Inserisci in Kaiross Client ID e Client secret e premi Salva e connetti: si apre la finestra del fornitore, accedi con l’account da usare e autorizza.
- Se in seguito il test segnala «Accesso scaduto», premi Ricollega nella connessione.
Permessi (scope) richiesti
Kaiross chiede solo questi permessi al fornitore; le azioni di scrittura restano comunque spente finché non le attivi.
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.file
Da sapere
- Si può usare anche come sorgente sincronizzata della knowledge: agente → scheda Sincronizzazione → Aggiungi sorgente. Vedi Sorgenti sincronizzate.
- Con Rispetta i permessi della fonte (attivo di default) ogni documento sincronizzato è visibile in chat solo a chi può aprirlo nel servizio.
Collegarla a un agente
- Apri Agenti, scegli l’agente e vai alla scheda MCP e database.
- In Aggiungi scegli Collega un’integrazione esistente e seleziona la connessione, oppure Dal catalogo per crearne una nuova (il pulsante diventa Salva e collega).
- Controlla gli Strumenti abilitati e, in Conferma delle azioni, quali azioni devono chiedere conferma.
- Premi Prova in chat e fai una domanda che richiede i dati del servizio.
Errori frequenti
- Account non collegato o accesso scaduto
- Il collegamento OAuth non è mai stato completato o non è più valido: premi Connetti o Ricollega nella connessione.
- Permessi insufficienti
- All’account mancano gli scope necessari: confrontali con l’elenco qui sopra.
- Troppe richieste
- Il servizio limita la frequenza delle chiamate: riprova tra qualche minuto.
Link utili
Console del fornitore citate nei passi: