Collega i tuoi agenti a Google Drive (beta)

Puoi collegare il tuo agente di Notion o i tuoi agenti personalizzati a Google Drive in modo che possano cercare, leggere, scrivere e aggiornare i file in tempo reale.

Questa connessione è legata alla persona che l'ha configurata. Quando il tuo agente utilizza Google Drive, controlla il tuo Drive in tempo reale. Nulla viene salvato o indicizzato da Notion. L'agente può accedere solo ai file di tua proprietà, ai file che sono stati condivisi con te e a qualsiasi Drive condiviso a cui hai accesso.

• Assicurati di poter accedere all'account Google che desideri utilizzare.

• Devi far parte dello spazio di lavoro senza essere un ospite e Notion AI deve essere attiva per il tuo spazio di lavoro.

• Il proprietario del tuo Google Workspace potrebbe dover approvare Custom Agents For Drive prima che tu possa collegarti. Se Google Drive non è approvato per il tuo spazio di lavoro, chiedi a un proprietario dello spazio di lavoro di approvarlo. Quando un proprietario dello spazio di lavoro si collega, Google Drive viene approvato automaticamente per lo spazio di lavoro.

• Esamina le autorizzazioni mostrate da Google prima di consentire l'accesso.

• Se il tuo spazio di lavoro controlla quali connessioni sono consentite, un proprietario dello spazio di lavoro potrebbe dover attivare Google Drive per gli agenti personalizzati.

• Il collegamento degli agenti personalizzati a Google Drive è diverso dal connettore Google Drive di Notion AI, destinato all'agente di Notion.

Puoi collegare Google Drive in due modi. Collega il tuo account Google dalle impostazioni e poi aggiungilo agli agenti che vuoi. Oppure aggiungi Google Drive mentre lavori su un agente specifico.

Collega dalle impostazioni

È il modo più rapido per usare lo stesso account Google con più agenti.

1. Vai su `Impostazioni` → `Connessioni`.

2. Seleziona `Google Drive`.

3. Seleziona `Il tuo account` → `Collega il tuo account Google Drive`.

4. Scegli `Accesso limitato` o `Accesso completo`, quindi seleziona `Collega`.

5. Leggi il promemoria, quindi seleziona `Continua su Google`.

6. Accedi con l'account Google che desideri utilizzare.

7. Nella schermata successiva di Google, seleziona tutte le caselle relative a Drive. Se ne lasci anche solo una deselezionata, i tuoi agenti non potranno funzionare.

Il tuo account Google è ora collegato a Notion. Puoi aggiungere Google Drive a qualsiasi agente personalizzato dalle impostazioni `Strumenti e accesso` dell'agente.

Collega da un agente

1. Apri l'agente personalizzato che desideri aggiornare.

   • L'agente di Notion usa l'account Google che colleghi da

     `Impostazioni` → `Connessioni`. Non devi configurare nient'altro nell'agente di Notion.

2. Vai su `Impostazioni` → `Strumenti e accesso` dell'agente.

3. Seleziona `+ Aggiungi connessione` → `Google Drive`.

4. Segui i passaggi per accedere a Google e consentire l'accesso. Nella schermata successiva di Google, seleziona tutte le caselle relative a Drive. Se ne lasci anche solo una deselezionata, i tuoi agenti non potranno funzionare.

   • Opzionale: scegli Drive condivisi o cartelle specifiche per limitare i contenuti a cui l'agente può accedere.

5. Seleziona `Salva`.

Una volta collegato Google Drive, puoi scegliere a quali contenuti può accedere l'agente. Nelle impostazioni `Strumenti e accesso` dell'agente, scegli i file o le cartelle di Drive che può visualizzare, modificare o entrambe le cose.

Per garantire la massima qualità, menziona Google Drive nelle istruzioni del tuo agente personalizzato o nel prompt per l'agente di Notion quando vuoi che cerchi o aggiorni i file di Drive.

Quando aggiungi Google Drive, scegli quali operazioni può eseguire l'agente. Potrai modificare il livello di accesso in seguito.

• Accesso limitato: l'agente può leggere tutti i file che puoi leggere, ma può modificare solo quelli che ha creato o che hai selezionato.

• Accesso completo: l'agente ha gli stessi permessi che hai già su Drive. Può leggere e modificare tutti i file che puoi leggere e modificare.

Il tuo livello di accesso si applica a tutti i tuoi agenti. Per modificarlo, ricollega Google Drive e scegli `Aggiorna l'accesso a Drive`. L'agente di Notion usa sempre il tuo livello di accesso completo. Per limitare l'accesso di un agente personalizzato a file o cartelle specifici, usa le sue impostazioni `Strumenti e accesso`.

Google ti chiede di autorizzare l'accesso: è un passaggio normale. Scegli l'account Google che vuoi usare, controlla le autorizzazioni richieste e continua. Google ti mostrerà i permessi di Drive previsti dal livello di accesso che hai scelto. Il collegamento è completo quando Notion indica che Google Drive è `Connesso`.

Potrebbe non servire l'approvazione dell'amministratore: in molte organizzazioni che usano Google Workspace puoi collegare nuove app autonomamente. Se l'amministratore non ha impostato una regola specifica per Custom Agents For Drive, potresti riuscire a collegarti subito. Se imposta una regola per l'app, sarà quella ad applicarsi.

Notion indica `Connesso`, ma non hai visto la schermata di accesso a Google: Notion potrebbe riutilizzare una connessione a Google Drive che avevi già configurato. Se funziona ancora, è normale. Se viene usato l'account Google sbagliato o Drive non funziona, rimuovi Google Drive da `Strumenti e accesso`, poi collegalo di nuovo scegliendo l'account che vuoi usare.

Puoi rimuovere Google Drive da ogni agente che lo utilizza, o solo da un agente.

Rimuovi il tuo account da tutti gli agenti

In questo modo, disconnetti il tuo account Google da tutti gli agenti che lo usano.

• Vai su Impostazioni → Connessioni, quindi seleziona Google Drive.

• Seleziona Il tuo account.

• Accanto al tuo account connesso, seleziona Disconnetti e conferma.

Rimuovi Google Drive da un agente

1. Apri l'agente e vai su Strumenti e accesso.

2. Seleziona i tre puntini accanto alla connessione di Google Drive.

3. Seleziona Disconnetti.

Quando colleghi un agente personalizzato a Google Drive, puoi impostare un trigger per fargli controllare se ci sono modifiche. Indica una cartella o un link di Drive e scegli ogni quanto deve controllare. Se rileva modifiche, l'agente si avvia. Puoi monitorare una cartella o un'unità condivisa, ma solo i file direttamente al suo interno: le modifiche nelle sottocartelle non attivano l'agente. Non puoi monitorare tutto Il mio Drive.

Prova uno di questi prompt per verificare la connessione dell'agente a Google Drive:

• «Cerca “roadmap” su Google Drive e dimmi cosa trovi».

• «Crea un documento Google chiamato “Weekly recap” con un breve riassunto di questa settimana».

Una volta collegato a Google Drive, il tuo agente può:

• Cercare tra i Documenti, i Fogli e le Presentazioni a cui puoi accedere.

• Modificare documenti, fogli e presentazioni Google esistenti, in base all'accesso che concedi. Per altri file, come PDF o documenti Word, l'agente può salvare la versione aggiornata in un nuovo file.

• Copiare, spostare e rinominare i file oppure spostarli nel Cestino.

• Leggere e riassumere il contenuto dei file in tempo reale.

• Leggere il testo di un PDF.

• Creare nuovi documenti, fogli di calcolo, presentazioni e cartelle.

• Eseguire un'azione quando l'aggiornamento dei file attiva un trigger.

Tipi di file con cui il tuo agente può lavorare

L'agente può leggere documenti, fogli e presentazioni Google, oltre a file PDF, Word, Excel, PowerPoint, CSV e di testo semplice (inclusi HTML, JSON, XML e YAML). I file caricati, come PDF e file Office, possono avere una dimensione massima di 10 MB. Se un documento, un foglio o una presentazione Google è molto grande, l'agente potrebbe leggerne solo una parte alla volta.

Non può leggere Google Disegni, Google Maps, Google Moduli, immagini, video, audio o file zip. Se gli indichi uno di questi, il tuo agente ti dirà che non può aprire il file. Per Google Disegni e altri tipi di file Google, ti chiederà invece di aprire il file in Google Drive.

Il tuo agente ha accesso solo a ciò a cui può accedere l'account Google collegato. Se quell'account Google perde l'accesso a un file o a una cartella, anche l'agente perde l'accesso.

Gli editor possono rimuovere la connessione a Google Drive per un agente personalizzato. Solo la persona che ha collegato l'agente a Google Drive può ampliarne l'accesso (ad esempio aggiungendo altre cartelle).

È meglio limitare l'accesso solo alle unità condivise o alle cartelle di cui il tuo agente personalizzato ha bisogno. Questo aiuta l'agente a rimanere concentrato e riduce i rischi.

Se un agente personalizzato è condiviso, chiunque vi abbia accesso può cercare nel Google Drive collegato.

• Collegarsi a più di un account Google per agente.

• Questa connessione funziona solo con i file nel tuo Google Workspace. Se un file viene condiviso da un Google Workspace diverso, l'agente personalizzato non sarà in grado di accedervi.

• Se l'agente personalizzato è condiviso, chiunque possa utilizzare l'agente può anche effettuare ricerche nel Drive a cui è connesso.

«L'amministratore del tuo istituto deve esaminare questa app»

Vedrai questo messaggio quando la tua organizzazione non ha approvato una o più autorizzazioni necessarie all'app. Solo un amministratore può risolvere questo problema.

1. Seleziona Richiedi accesso.

2. Il tuo amministratore di Google Workspace riceve la richiesta in App in attesa di revisione.

3. Prova a connetterti di nuovo dopo che l'amministratore ha approvato l'app e tutte le sue autorizzazioni.

«Accesso bloccato: errore di autorizzazione»

Vedrai questo messaggio quando l'amministratore ha bloccato l'app per il tuo account o per il tuo gruppo. Contatta il tuo amministratore di Google Workspace. Deve consentire Custom Agents For Drive per il tuo gruppo prima che tu possa connetterti.

Prima funzionava, ma ora non funziona più

Il tuo accesso a Google potrebbe essere scaduto o disattivato, oppure l'amministratore potrebbe aver modificato una regola.

1. Collega di nuovo Google Drive in Strumenti e accesso.

2. Se Google segnala un blocco imposto dall'amministratore, contatta l'amministratore di Google Workspace.

3. Se riesci ad accedere a Google ma Notion non riesce ancora a connettersi, contatta l'assistenza di Notion e comunica l'errore che visualizzi.

Per consentire a qualcuno di connettersi, autorizza Custom Agents For Drive per il suo gruppo (unità organizzativa) e approva ogni autorizzazione Google richiesta dal suo livello di accesso.

Come Google stabilisce quali app puoi collegare

Nella tua console di amministrazione, in Controlli API → Impostazioni → App di terze parti non configurate, l'impostazione predefinita consente alle persone di connettere nuove app autonomamente. Con tale impostazione predefinita, le persone possono connettere Custom Agents For Drive senza la tua approvazione, a condizione che tu non abbia impostato una regola specifica per l'app.

Le altre impostazioni consentono solo le informazioni di base per l'accesso a Google o bloccano tutte le nuove app. Qualsiasi regola impostata per un'app specifica sostituisce quella predefinita. Gli ospiti vengono gestiti tramite il proprio gruppo.

Questa impostazione regola l'accesso alle app tramite l'account Google. Le installazioni da Google Workspace Marketplace sono gestite separatamente.

Configura Notion Agents For Drive

Se configuri tu l'app, le persone possono collegarla anche quando le nuove app possono accedere solo alle informazioni di base dell'account Google o sono bloccate.

1. Apri Console di amministrazione → Sicurezza → Controllo dell'accesso e dei dati → Controlli API → Controllo dell'accesso alle app.

2. Apri App configurate, quindi seleziona Configura nuova app.

3. Cerca utilizzando questo ID client OAuth esatto:

   69206789846-avkmfeq0epeducrkoutjo361r8p5h103.apps.googleusercontent.com

4. Scegli i gruppi i cui membri devono poter connettere l'app.

5. Scegli Attendibile per consentire ogni autorizzazione richiesta dall'app, oppure scegli Dati Google specifici e includi ogni autorizzazione di Drive e di accesso a Google necessaria per la connessione.

6. Rivedi le tue scelte e seleziona Fine.

7. Chiedi alla persona di riprovare a connettersi quando la modifica sarà effettiva.

Esamina una richiesta di app

Quando esamini una richiesta, controlla che:

• L'app sia Custom Agents For Drive.

• Sia consentita per il gruppo della persona.

• Ogni autorizzazione di Drive e di accesso a Google sia approvata.

• Una regola di un sottogruppo non la blocchi senza che tu te ne accorga.

Per Dati Google specifici, seleziona ogni autorizzazione richiesta dalla connessione.

Le modifiche a Google Workspace possono richiedere del tempo. Chiedi alla persona di connettersi di nuovo dopo che la modifica è stata applicata.