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 Gemini Enterprise, 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 , vai alla paginaGoogle Cloud 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, specifica l'origine Drive per il tuo datastore. Puoi configurare i filtri che definiscono l'ambito dei contenuti di Google Drive indicizzati utilizzando la console Google Cloud o l'API:

    Console

    1. Seleziona l'origine Drive per il tuo datastore:
      • Tutti: aggiungi tutti i drive dello spazio di lavoro al datastore.
      • Filtro cartella: limita la ricerca a un insieme specifico di cartelle. Scegli Includi per limitare la ricerca solo alle cartelle elencate oppure Escludi per rimuovere le cartelle elencate dalla ricerca. Poi aggiungi uno o più ID cartella.
      • Filtro Drive condivisi: limita la ricerca a un insieme specifico di Drive condivisi. Scegli Includi per limitare la ricerca solo ai Drive condivisi elencati oppure Escludi per rimuovere i Drive condivisi elencati dalla ricerca. Poi aggiungi uno o più ID Drive condivisi.
    2. Per ogni tipo di filtro, configura la modalità Includi o Escludi, ma non entrambe.
    3. Per trovare l'ID di una cartella o di un Drive condiviso, vai alla cartella o al Drive condiviso in Google Drive 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.

    REST

    Per creare un datastore con filtri, chiama il metodo setUpDataConnector.

    Gli elenchi di inclusione sono impostati in admin_filter e gli elenchi di esclusione in admin_exclusion_filter. Per ogni tipo di filtro, compila l'elenco in admin_filter o in admin_exclusion_filter, ma non in entrambi.

    
   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       -H "X-Goog-User-Project: PROJECT_ID" \
       "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
       -d '{
         "collectionId":"COLLECTION_ID",
         "collectionDisplayName":"COLLECTION_DISPLAY_NAME",
         "dataConnector":{
           "dataSource":"google_drive",
           "params":{
             "admin_filter":{
               "SharedDriveIds": INCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": INCLUDED_FOLDER_IDS
             },
             "admin_exclusion_filter":{
               "SharedDriveIds": EXCLUDED_SHARED_DRIVE_IDS,
               "FolderIds": EXCLUDED_FOLDER_IDS
             }
           },
           "entities":[
             {
               "entityName":"drive"
             }],
           "connectorModes":[
             "FEDERATED"
             ]
         }
       }'

    Sostituisci quanto segue:

    • PROJECT_ID: il tuo ID progetto.
    • ENDPOINT_LOCATION: la regione della tua applicazione. Ad esempio: us o eu.
    • LOCATION: la multiregione del tuo datastore: global o us.
    • COLLECTION_ID: l'ID univoco del datastore.
    • COLLECTION_DISPLAY_NAME: Il nome visualizzato del datastore.
    • INCLUDED_SHARED_DRIVE_IDS: un elenco di ID di Drive condivisi da includere nella ricerca, ad esempio ["0ABCdEfGhIjKlMnOpQ"]. Utilizza un elenco vuoto [] se non stai impostando un elenco di inclusione per i Drive condivisi.
    • INCLUDED_FOLDER_IDS: un elenco di ID cartella da includere nella ricerca, ad esempio ["1AbCdEfGhIjKlMnOpQrStUvWxYz"]. Utilizza un elenco vuoto [] se non stai impostando un elenco di inclusione per le cartelle.
    • EXCLUDED_SHARED_DRIVE_IDS: un elenco di ID di Drive condivisi da escludere dalla ricerca. Utilizza un elenco vuoto [] se non stai impostando un elenco di esclusione per i Drive condivisi.
    • EXCLUDED_FOLDER_IDS: un elenco di ID cartella da escludere dalla ricerca. Utilizza un elenco vuoto [] se non stai impostando un elenco di esclusione per le cartelle.

    Per maggiori dettagli sui tipi di filtri e sull'aggiunta di filtri, vedi Aggiungere filtri a un archivio dati Google Drive.

  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, svolgi questi passaggi:

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

Dopo aver creato il datastore, crea un'app e collegala al datastore di 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 mostra.

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.
400 Argomento non valido La richiesta contiene un argomento non valido. Questo errore si verifica se il nome del connettore dati nella richiesta non soddisfa i requisiti di denominazione. Verifica il nome del connettore dati, assicurandoti che sia lungo da 1 a 63 caratteri, inizi con una lettera minuscola, termini con una lettera minuscola o una cifra e contenga solo lettere minuscole, cifre, trattini o trattini bassi. Ad esempio, utilizza un nome come cymbal-collection-123456789 anziché 123456789-cymbal-collection.

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

Passaggi successivi