Configura un datastore Gmail

Questa pagina descrive come creare un datastore e connettere Gmail a Gemini Enterprise.

Prima di iniziare

  • Accedi alla console Google Cloud con lo stesso account che utilizzi per l'istanza Google Workspace che prevedi di connettere. Gemini Enterprise utilizza l'ID cliente Google Workspace per connettersi a Gmail. Gli Account Google personali (account consumer che terminano con @gmail.com) non hanno un ID cliente e non sono supportati.

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

  • Attiva le funzionalità intelligenti: nel tuo account Google Workspace, attiva sia le funzionalità intelligenti in Google Workspace sia le funzionalità intelligenti in altri prodottiGoogle . Per maggiori dettagli, vedi Attivare o disattivare le funzionalità intelligenti di Google Workspace.

  • Inserisci nella lista consentita l'app OAuth (solo amministratori): l'datastore di Gmail utilizza un'app OAuth gestita da Googleper accedere ai tuoi dati. Se la tua organizzazione limita l'accesso alle app OAuth, l'amministratore di Google Workspace deve aggiungere questa app alla lista consentita della tua organizzazione. Per maggiori dettagli, consulta Inserire nella lista consentita l'app OAuth gestita da Google.

Crea il datastore Gmail

Per creare il datastore Gmail, 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. In Origine, cerca Google Mail e fai clic su Seleziona.

  6. Nella sezione Azioni, scegli le azioni dall'elenco per attivarle per il connettore Gmail.

    Per gestire l'elenco delle azioni, vedi Gestisci azioni.

  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. (Facoltativo) Nel campo Tag, inserisci un identificatore stabile per il datastore. Questo identificatore viene utilizzato in diverse versioni del connettore e diventa immutabile dopo la creazione dell&#39datastorei, quindi scegli un valore che non devi modificare in un secondo momento.

  10. (Facoltativo) Nella sezione Policy di Sensitive Data Protection, allega una policy Sensitive Data Protection esistente per esaminare e de-identificare i dati recuperati da Gemini Enterprise tramite questo datastore. Se la tua organizzazione non richiede una policy di Sensitive Data Protection, puoi saltare questo passaggio.

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

Nella pagina Datastore, fai clic sul nome del datastore per visualizzarne lo stato. Quando lo stato del datastore passa da Creazione ad Attivo, il connettore Gmail è pronto per essere utilizzato.

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

Esecuzione delle query

Questa sezione descrive come Gemini Enterprise gestisce la tua query e le implicazioni per la privacy dell'utilizzo del datastore federato.

Dopo aver autorizzato Gmail e inviato una query di ricerca a Gemini Enterprise:

  • Gemini Enterprise invia la query di ricerca direttamente all'API Gmail.
  • Gemini Enterprise combina i risultati con quelli di altre origini dati connesse e mostra un risultato di ricerca completo.

Messaggi di errore e risoluzione dei problemi

La tabella seguente descrive i messaggi di errore comuni che potresti riscontrare quando utilizzi il connettore Gmail, inclusi i possibili codici di errore HTTP e i passaggi consigliati per la risoluzione dei problemi.

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 del service account 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.
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.

Passaggi successivi