Panoramica

Il datastore di Google Drive per Gemini Enterprise ti consente di cercare ed eseguire azioni sui dati di Google Drive, inclusi file e cartelle.

Azioni supportate

Quando il datastore di Google Drive è abilitato, gli utenti finali possono utilizzare i comandi in linguaggio naturale in Gemini Enterprise per eseguire le seguenti azioni.

Azione Descrizione
Copia file Copia un file su Google Drive.
Crea file Crea un nuovo file su Google Drive.
Scarica i contenuti del file Scarica i contenuti di un file di Google Drive.
Recupera i valori delle celle Legge i valori delle celle da un foglio di lavoro di Fogli Google.
Recupera i metadati del file Recupera i metadati di un file di Google Drive.
Ottieni le autorizzazioni dei file Elenca le autorizzazioni per un file di Google Drive.
Scarica il foglio di lavoro Legge i contenuti e i metadati di un foglio di lavoro di Fogli Google.
Inserisci dimensione Inserisce righe o colonne in un foglio di lavoro di Fogli Google.
Elenca i file recenti Elenca i file recenti su Google Drive.
Elenca i Drive condivisi Elenca i Drive condivisi su Google Drive.
Leggi documento Legge i contenuti di un documento di Documenti Google.
Leggi il contenuto del file Legge i contenuti di un file di Google Drive.
Leggi la presentazione Legge i contenuti di una presentazione Google.
Cercare file Cerca i file di Google Drive corrispondenti a una query.
Condividi file Condivide un file di Google Drive con uno o più utenti.
Sposta file nel cestino Sposta un file di Google Drive nel cestino.
Aggiorna i valori delle celle Scrive i valori delle celle in un foglio di lavoro di Fogli Google.
Aggiorna file Aggiorna un file di Google Drive esistente.
Aggiorna formule Scrive formule in un foglio di lavoro di Fogli Google.

Ambiti obbligatori

L'app OAuth gestita da Googlerichiede i seguenti ambiti OAuth. Gli utenti concedono questi ambiti quando autorizzano il connettore:

Ambito Finalità
https://www.googleapis.com/auth/drive.readonly Cercare e recuperare i contenuti di Google Drive. Consente al datastore di elencare file e cartelle, visualizzare i metadati, elencare le autorizzazioni e leggere i contenuti dei file.
https://www.googleapis.com/auth/drive.metadata.readonly Leggere i metadati dei file di Google Drive.
https://www.googleapis.com/auth/drive.file Creare e aggiornare i file che l'utente apre o crea con il connettore.
https://www.googleapis.com/auth/drive.appdata Archiviare dati specifici dell'applicazione su Google Drive.
https://www.googleapis.com/auth/drive Eseguire azioni di scrittura sui file di Google Drive (ad esempio, copia, condivisione, spostamento nel cestino e aggiornamento).

Limitazioni

  • Il datastore di Google Drive è supportato solo nelle località global, us e eu.

Problemi di ricerca comuni

Se la ricerca non restituisce il file che stai cercando o se l'app web Gemini Enterprise segnala che non sono stati trovati file di Google Drive corrispondenti, controlla i seguenti problemi e soluzioni.

L'accesso di Gemini Enterprise ai dati di Google Workspace è disattivato

Sintomo: l'app web Gemini Enterprise segnala che non sono stati trovati file di Google Drive corrispondenti o le richieste di ricerca inviate tramite l'API Search restituiscono un errore (o un avviso) 403 Permission Denied: Workspace access for Agentspace disabled by organization admin.. Puoi anche esaminare i log degli errori del datastore in Cloud Logging; consulta Risolvi i problemi relativi ai datastore Gemini Enterprise.

Problema: l'impostazione Consenti a Gemini Enterprise di accedere ai dati di Google Workspace è disattivata nella Console di amministrazione Google per l'organizzazione Google Workspace dell'utente.

Soluzione: chiedi a un amministratore di Google Workspace dell'organizzazione dell'utente di attivare l'opzione Consenti a Gemini Enterprise di accedere ai dati di Google Workspace. Nelle configurazioni tra organizzazioni, un amministratore di ogni organizzazione Google Workspace i cui utenti eseguono query su Google Drive deve attivare questa impostazione.

L'utente e il datastore appartengono a organizzazioni Google Workspace diverse

Sintomo: gli utenti che accedono da un'organizzazione Google Workspace diversa da quella del progetto Google Cloud non ricevono i risultati di Google Drive nell'app web Gemini Enterprise oppure le richieste inviate tramite l'API Search restituiscono un errore 403 Permission Denied: User does not belong to the same organization as the Workspace data store. Workspace data store is configured for customer ID ... while user belongs to customer ID .... Per verificare la presenza di errori 403 nei log, consulta Accedi ai log degli errori del connettore Gemini Enterprise con Cloud Logging.

Problema: per impostazione predefinita, Gemini Enterprise consente agli utenti di eseguire ricerche in un datastore di Google Drive solo se l'ID cliente Google Workspace dell'utente corrisponde all'organizzazione del datastore di Google Drive e del progetto Google Cloud .

Soluzione: completa la configurazione tra organizzazioni:

  1. Contatta l'assistenza clienti Google Cloud per aggiungere alla lista consentita del tuo progetto Google Cloud l'ID cliente di ogni organizzazione Google Workspace i cui utenti accedono a Gemini Enterprise.
  2. Chiedi a un amministratore di Google Workspace di attivare l'opzione Consenti a Gemini Enterprise di accedere ai dati di Google Workspace in ogni organizzazione Google Workspace.
  3. Se gli utenti devono trovare documenti di proprietà di un'altra organizzazione, attiva Includi documenti interdominio in Gestisci funzionalità dell'app web.

Le parole chiave che superano il limite di estrazione del testo di 1 MB non sono disponibili per la ricerca

Sintomo: la ricerca di parole chiave che compaiono più avanti in un file di grandi dimensioni non restituisce il file.

Problema: Google Drive estrae solo 1 MB di testo e dati di formattazione dal file per renderlo disponibile per la ricerca. Le parole chiave che superano il limite di 1 MB dell'indice non sono disponibili per la ricerca.

Soluzione: esegui la ricerca utilizzando termini che compaiono nel primo megabyte del file oppure suddividi i documenti di grandi dimensioni in file più piccoli.

I file che superano i limiti di dimensioni o di pagine PDF non vengono indicizzati

Sintomo: file di grandi dimensioni o PDF lunghi specifici non vengono visualizzati nei risultati di ricerca.

Problema: i file che superano i limiti di dimensioni o di pagine di Google Drive non vengono indicizzati e non vengono visualizzati nei risultati di ricerca:

  • Per la maggior parte dei tipi di file, le dimensioni non possono superare i 10 MB, con le seguenti eccezioni:
    • File XLSX: fino a 20 MB.
    • File PDF: fino a 30 MB.
    • File di testo: fino a 100 MB.
  • Il riconoscimento ottico dei caratteri (OCR) nei file PDF è limitato a 80 pagine. Google Drive non indicizza i PDF di dimensioni superiori a 50 MB o 80 pagine.

Soluzione: riduci le dimensioni dei file o suddividi i file e i PDF che superano questi limiti di indicizzazione.

Passaggi successivi