Configura un datastore Google Drive

Questa pagina descrive come creare un datastore e connettere Google Drive a Gemini Enterprise. Questa connessione consente a Gemini Enterprise di recuperare direttamente le informazioni da Google Drive. Poiché i dati non vengono copiati nell'indice di Vertex AI Search, non devi gestire l'archiviazione dei dati.

Prima di iniziare

  • Devi aver eseguito l'accesso alla console Google Cloud con lo stesso account che utilizzi per l'istanza di Google Drive che prevedi di connettere. Gemini Enterprise utilizza l'ID cliente Google Workspace per collegarsi a Google Drive.

  • Per applicare il controllo dell'accesso all'origine dati e proteggere i dati in Gemini Enterprise, assicurati di aver configurato il tuo provider di identità.

  • Verifica che tutti i documenti siano accessibili, inserendoli in un Drive condiviso di proprietà del dominio o assegnando la proprietà a un utente del dominio.

  • Attiva le funzionalità intelligenti di Google Workspace in altri prodotti Google per collegare i dati di Google Drive a Gemini Enterprise. Per informazioni, vedi Attiva o disattiva le funzionalità intelligenti di Google Workspace.

Crea il datastore Google Drive

Per creare il datastore Google Drive, svolgi i seguenti passaggi:

  1. Nella console Google Google Cloud , vai alla pagina Gemini Enterprise. Gemini Enterprise

  2. Seleziona o crea un Google Cloud progetto.

  3. Nel menu di navigazione, fai clic su Datastore.

  4. Fai clic su Crea datastore.

  5. Nella sezione Origine, cerca Google Drive e fai clic su Seleziona.

  6. Nella sezione Dati:

    1. Specifica l'origine Drive per il tuo datastore:

      • Tutto: per aggiungere l'intero drive al datastore.
      • Drive condivisi specifici: aggiungi l'ID cartella del Drive condiviso.
      • Cartelle condivise specifiche: aggiungi l'ID delle cartelle condivise.

      Per trovare l'ID cartella del Drive condiviso o di una cartella specifica, vai al Drive condiviso o alla cartella e copia l'ID dall'URL. L'URL segue questo formato: https://drive.google.com/corp/drive/folders/ID.

      Ad esempio, https://drive.google.com/corp/drive/folders/123456789012345678901.

  7. Fai clic su Continua.

  8. Nella sezione Configurazione:

    1. Dall'elenco Multiregionale, seleziona la posizione per il connettore dati.
    2. Nel campo Nome connettore dati, inserisci un nome per il connettore.
    3. Se hai selezionato US o EU come posizione, configura le impostazioni di crittografia:
      • Seleziona Chiave di crittografia gestita daGoogle o Chiave Cloud KMS.
      • Se hai selezionato Chiave Cloud KMS:
        • Nell'elenco Tipo di gestione delle chiavi, seleziona il tipo appropriato.
        • Nell'elenco Chiave Cloud KMS, seleziona la chiave.
      Per saperne di più, vedi Chiavi di crittografia gestite dal cliente.

  9. Fai clic su Continua.

  10. Nella sezione Fatturazione, seleziona Prezzi generali o Prezzi configurabili. Per saperne di più, consulta Verifica lo stato di fatturazione dei progetti e Licenze.

  11. Fai clic su Crea. Gemini Enterprise crea il datastore e mostra i datastore nella pagina Data Stores (Datastore).

Per verificare lo stato del datastore:

  1. Vai al connettore nell'elenco dei datastore e monitora il suo stato finché non diventa Active (Attivo).
  2. Quando lo stato del datastore passa da Creazione ad Attivo, il connettore Google Drive è pronto per essere utilizzato.

Dopo aver creato il datastore, crea un'app e collegala al datastore Google Drive prima di eseguire la query.

Esecuzione delle query

Dopo aver autorizzato Google Drive, quando inserisci una query di ricerca:

  1. Gemini Enterprise invia la query di ricerca all'API Google Drive.

  2. Gemini Enterprise combina i risultati con quelli di altre fonti e li visualizza.

Messaggi di errore e risoluzione dei problemi

La tabella seguente descrive i messaggi di errore, inclusi i codici di errore HTTP e i passaggi consigliati per la risoluzione dei problemi, che potresti riscontrare quando utilizzi questa origine dati Google .

Codice di errore Messaggio di errore Descrizione Risoluzione dei problemi
403 Autorizzazione negata La ricerca utilizzando le credenziali del service account non è supportata per i datastore Google Workspace. Il motore in cui viene eseguita la ricerca dispone di datastore Google Workspace e le credenziali trasmesse sono di un service account. La ricerca utilizzando le credenziali dell'account di servizio nei datastore di Google Workspace non è supportata. Chiama la ricerca utilizzando le credenziali utente o rimuovi i datastore di Google Workspace dal motore.
403 Autorizzazione negata Gli account consumer non sono supportati per i datastore Google Workspace. La ricerca viene chiamata utilizzando una credenziale di account consumer (@gmail.com), che non è supportata per i datastore Google Workspace. Rimuovi i datastore di Google Workspace dal motore o utilizza un Account Google gestito. Google
403 Autorizzazione negata ID cliente non corrispondente per il datastore La ricerca è consentita solo agli utenti che appartengono alla stessa organizzazione dei datastore di Google Workspace. Rimuovi i datastore di Google Workspace dal motore o contatta l'assistenza se l'utente e i datastore di Google Workspace devono trovarsi in organizzazioni diverse.
403 Autorizzazione negata L'accesso a Workspace per Agentspace è stato disattivato dall'amministratore dell'organizzazione. Un amministratore di Google Workspace ha disattivato l'accesso ai dati di Google Workspace per Gemini Enterprise. Contatta l'amministratore di Google Workspace per [attivare l'accesso](https://support.google.com/a/answer/16479199).

Per i problemi di ricerca comuni che si verificano durante l'interrogazione dei dati di Google Drive, vedi Problemi di ricerca comuni.

Passaggi successivi