Google Workspace

Un unico accesso Google connette Drive, Sheets e Docs, 14 strumenti per leggere, creare e aggiornare file. Gmail e Calendar si connettono separatamente.

Un unico accesso Google connette Drive, Sheets e Docs al tuo agente, e al momento della connessione viene offerta una modalità di sola lettura. Quattordici strumenti gli permettono di leggere i tuoi file e di creare o aggiornare fogli di calcolo e documenti per tuo conto. Gmail e Google Calendar sono connessioni separate, entrambe collegate qui sotto.

Connetti

Apri Integrazioni e scegli Google (Drive · Sheets · Docs).
Accedi con Google e concedi l'accesso. Per mantenerlo in sola lettura, attiva l'opzione read-only, l'agente potrà così leggere ma mai creare, aggiornare o spostare nulla.
L'agente può ora lavorare con i tuoi Drive, Sheets e Docs.

L'unico intoppo che manda in confusione: lo scope drive.file. Per tutelare la tua privacy, l'elenco di Drive mostra sempre e solo i file creati dall'agente più i file o le cartelle che hai condiviso esplicitamente con l'account Google connesso, mai il tuo intero Drive. Sheets e Docs restano comunque raggiungibili in tutto l'account tramite link o ID, quindi il modo più veloce per far lavorare l'agente su un documento esistente è incollarne l'URL (o condividere il file). Se l'agente "non trova" un foglio di calcolo che sai esistere, la causa è questo scope.

Cosa può fare l'agente

Strumento	Accesso	Tipo	Cosa fa
`gdrive_list_files`	Pubblico sicuro	Read	Elenca i file e le cartelle a cui l'agente può accedere, quelli che ha creato più quelli che hai condiviso; filtra per nome o elenca una cartella.
`gdrive_read_file`	Pubblico sicuro	Read	Legge il testo di un file di Drive; i formati nativi Docs, Sheets e Slides vengono esportati in testo semplice o CSV.
`gsheets_read`	Pubblico sicuro	Read	Legge i valori delle celle di un foglio tramite URL o ID, usando un intervallo in notazione A1.
`gsheets_get_metadata`	Pubblico sicuro	Read	Ottiene il titolo e le schede di un foglio, nomi, ID e conteggio di righe/colonne.
`gdocs_read`	Pubblico sicuro	Read	Legge l'intero testo di un Google Doc tramite URL o ID.
`gdrive_create_file`	Solo proprietario	Write	Crea un file di testo semplice (txt, csv, markdown, html) in Drive, facoltativamente dentro una cartella.
`gdrive_create_folder`	Solo proprietario	Write	Crea una nuova cartella, facoltativamente dentro una cartella superiore.
`gdrive_update_file`	Solo proprietario	Write	Rinomina un file di Drive, ne sostituisce il contenuto o lo sposta in un'altra cartella.
`gsheets_append_rows`	Solo proprietario	Write	Aggiunge righe dopo l'ultima riga di dati in una scheda del foglio.
`gsheets_update_cells`	Solo proprietario	Write	Sovrascrive un intervallo di celle specifico con nuovi valori.
`gsheets_create`	Solo proprietario	Write	Crea un nuovo foglio con un titolo, schede facoltative e righe iniziali facoltative.
`gdocs_create`	Solo proprietario	Write	Crea un nuovo Google Doc con un titolo e un testo iniziale facoltativo.
`gdocs_insert_text`	Solo proprietario	Write	Inserisce testo in un Doc, alla fine per impostazione predefinita, oppure in una posizione stabilita.
`gdocs_replace_text`	Solo proprietario	Write	Trova e sostituisce ogni occorrenza di una stringa in un Doc.

Public-safe vs owner-only

I cinque strumenti di lettura sono public-safe, un agente che parla con un visitatore del sito può usarli per rispondere a partire da un foglio di calcolo o da un documento condiviso. I nove strumenti di scrittura sono owner-only: non vengono mai esposti a un visitatore pubblico e, connettendosi in modalità read-only, tutti e nove restano nascosti, così l'agente può leggere ma non può cambiare nulla.

Esempio pratico

Dici al tuo agente interno: "Leggi la scheda dei lead in questo foglio [link] e inizia un documento di follow-up che riassuma i primi cinque." Chiama gsheets_read sul link condiviso, poi gdocs_create per creare il documento e gdocs_insert_text per riempirlo, un nuovo file che compare nel tuo Drive, creato con il tuo account.

Limiti e onestà

Ristretto per scelta. Lo scope drive.file fa sì che l'agente veda solo i file creati e condivisi, non il tuo intero Drive. È una funzionalità, non un difetto.
Lo strumento giusto per i file nativi. gdrive_create_file crea file di testo semplice; usa gsheets_create / gdocs_create per veri Sheets e Docs.
Il lavoro dell'IA è misurato in ABT, come ogni attività dell'agente, vedi Fatturazione e ABT.

Gmail e Calendar (connessioni separate)

Gmail si connette come account email tramite lo stesso accesso Google e fornisce all'agente strumenti email owner-only. La lettura e la ricerca della posta funzionano sullo scope concesso.

Calendar è un'integrazione a sé, disponibilità e prenotazioni si trovano nella pagina Google Calendar.

Risoluzione dei problemi

"Non trovo il mio file." Non è stato creato dall'agente né condiviso. Incolla il link/ID del documento, oppure condividi il file/cartella con l'account Google connesso.
Strumenti di scrittura assenti. La connessione è in modalità read-only, riconnettiti senza di essa per abilitare creazione/aggiornamento/spostamento.
Il documento è uscito vuoto. gdocs_create senza testo crea un documento vuoto; chiedi il contenuto, oppure prosegui con gdocs_insert_text.

FAQ

L'agente può vedere il mio intero Drive? No, solo i file che ha creato più quelli che hai condiviso esplicitamente (lo scope drive.file).

Può inviare email? La lettura funziona; l'invio è a scope ristretto, vedi la nota qui sopra e Email prima di farci affidamento.

La sola lettura blocca davvero tutte le scritture? Sì, tutti e nove gli strumenti di scrittura sono nascosti finché la connessione è in read-only.

Avanti

Google Calendar, offri fasce libere e prenota appuntamenti
Email, accesso Gmail, IMAP/SMTP e la famiglia di strumenti email
Abilità dell'agente, come gli strumenti si collegano a un agente
Panoramica delle integrazioni

In questa pagina