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 essere un membro dello spazio di lavoro (non un ospite) e Notion AI deve essere attivato per il tuo spazio di lavoro.

• Il proprietario del tuo Google Workspace potrebbe dover approvare Custom Agents For Drive prima che tu possa collegare gli agenti. 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 effettua il collegamento, 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.

Esistono due modi per collegare Google Drive. Puoi collegare il tuo account Google una volta dalle impostazioni, quindi aggiungerlo a qualsiasi agente. Oppure puoi aggiungere Google Drive mentre lavori in uno specifico agente.

Collega dalle impostazioni

Esegui questa operazione per accedere a Google Drive con l'agente di Notion e utilizzare lo stesso account Google con più di un agente.

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 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 utilizza l'account Google che colleghi in

     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 una deselezionata, i tuoi agenti non potranno funzionare.

   • Facoltativo: scegli unità condivise o cartelle specifiche per limitare i contenuti a cui l'agente può accedere.

5. Seleziona Salva.

Una volta stabilita la connessione, puoi scegliere esattamente a quali contenuti può accedere il tuo agente. Nelle impostazioni Strumenti e accesso dell'agente, scegli i file o le cartelle di Drive che l'agente può visualizzare e/o modificare.

Per ottenere risultati migliori, indica Google Drive nelle istruzioni del tuo agente personalizzato o nel prompt per l'agente di Notion quando vuoi che cerchi o aggiorni file su Drive.

Quando aggiungi Google Drive, scegli quali operazioni può svolgere l'agente. Puoi cambiare questa impostazione in seguito.

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

• Accesso completo: il tuo agente usa i tuoi permessi di Drive. Può leggere e modificare tutti i file che puoi leggere e modificare.

Il 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 l'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 approvare l'accesso: Questa è la normale procedura di configurazione. Scegli l'account Google che desideri, esamina ciò che viene richiesto e continua. Successivamente, Google mostrerà le autorizzazioni di Drive per il livello di accesso scelto. Sarai connesso una volta che Notion indicherà che Google Drive è connesso.

Potrebbe non servire l'approvazione dell'amministratore: molte organizzazioni Google Workspace consentono di 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 a prevalere.

Notion dice «Connesso», ma non hai mai visto la schermata di accesso a Google: Notion potrebbe riutilizzare una connessione a Google Drive che hai configurato in precedenza. È normale se la connessione funziona ancora. Se viene usato l'account Google sbagliato o Drive non funziona, rimuovi Google Drive da Strumenti e accesso, poi collegalo di nuovo e scegli l'account che vuoi usare.

Puoi rimuovere Google Drive da tutti gli agenti che lo utilizzano oppure da un solo agente.

Rimuovi il tuo account da tutti gli agenti

In questo modo scolleghi il tuo account Google da tutti gli agenti che lo usavano.

• 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 una modifica, l'agente si attiva. Puoi monitorare una cartella o un'unità condivisa, ma solo i file contenuti direttamente nella cartella: le modifiche nelle sottocartelle non attivano l'agente. Non puoi monitorare l'intero Il mio Drive.

Prova uno di questi prompt per verificare la connessione del tuo agente a Google Drive:

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

• «Crea un documento Google chiamato “Riepilogo settimanale” con un breve riepilogo 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, a seconda dell'accesso che concedi. Per altri file, come PDF o documenti Word, il tuo agente può salvare una versione aggiornata come 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.

• Attivarsi tramite un trigger quando i file vengono aggiornati.

Tipi di file con cui il tuo agente può lavorare

Il tuo agente può leggere Documenti, Fogli e Presentazioni Google, oltre a PDF, Word, Excel, PowerPoint, CSV e file 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. Per Documenti, Fogli o Presentazioni Google molto grandi, il tuo agente potrebbe leggere solo una parte del file alla volta.

Non può leggere Disegni Google, Google Maps, Moduli Google, immagini, video, audio o file ZIP. Se gli indichi uno di questi file, l'agente ti dirà che non può aprirlo. Nel caso di Disegni Google e degli altri tipi di file Google, ti chiederà di aprirlo 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.

Chi può modificare un agente personalizzato può rimuovere la connessione a Google Drive. Solo chi ha collegato l'agente a Google Drive può ampliarne l'accesso, per esempio aggiungendo altre cartelle.

Concedi al tuo agente personalizzato l'accesso solo alle unità condivise o alle cartelle di cui ha bisogno. Così può concentrarsi sui file pertinenti e riduci i rischi.

Se un agente personalizzato è condiviso, chiunque vi abbia accesso può consultare il 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»

Questo messaggio compare se la tua organizzazione non ha approvato uno o più permessi necessari all'app. Per risolvere il problema serve l'intervento di chi amministra Google Workspace.

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»

Questo messaggio compare se chi amministra Google Workspace ha bloccato l'app per il tuo account o gruppo. Contatta chi amministra Google Workspace: deve autorizzare 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. Riconnetti Google Drive in Strumenti e accesso.

2. Se Google mostra un blocco dell'amministratore, contatta il tuo amministratore Workspace.

3. Se Google ti consente l'accesso 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 decide Google quali app le persone possono connettere

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 alle app di accedere solo alle informazioni di base per l'accesso a Google oppure bloccano tutte le nuove app. Le regole impostate per una singola app prevalgono sull'impostazione predefinita. Gli ospiti sono gestiti tramite il proprio gruppo.

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

Configura Notion Agents For Drive

Se configuri l'app, le persone possono collegarla anche quando le nuove app sono limitate alle informazioni di base per l'accesso 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`, poi seleziona Configura nuova app.

3. Cerca usando esattamente questo ID client OAuth:

   69206789846-avkmfeq0epeducrkoutjo361r8p5h103.apps.googleusercontent.com

4. Scegli i gruppi i cui membri devono poter connettersi.

5. Scegli Attendibile per concedere tutti i permessi richiesti dall'app, oppure scegli Dati Google specifici e includi tutti i permessi necessari per Drive e per l'accesso a Google.

6. Controlla le tue scelte e seleziona Fine.

7. Chiedi alla persona di connettersi di nuovo 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.

• Tutti i permessi per Drive e per l'accesso a Google siano approvati.

• Una regola di sottogruppo non la stia bloccando senza che te ne accorga.

Per Dati Google specifici, seleziona tutti i permessi richiesti dalla connessione.

Le modifiche a Google Workspace possono richiedere un po' di tempo per essere applicate. Chiedi alla persona di connettersi di nuovo quando la modifica sarà effettiva.