Configurare 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 di Google Workspace che prevedi di connettere. Vertex AI Search utilizza l'ID cliente Google Workspace per connettersi a Gmail.

  • 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à.

  • Prima di aggiungere azioni al datastore Gmail, un Google Cloud amministratore deve completare i passaggi descritti nella sezione Configurare l'autenticazione e le autorizzazioni per Gmail per configurare l'autenticazione OAuth 2.0 in modo da fornirti l'ID client e il client secret e configurare le autorizzazioni minime.

Crea il datastore Gmail

Per creare il datastore Gmail:

  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 Gmail e fai clic su Seleziona.

  6. Nella sezione Azioni:

    1. Inserisci l'ID client e il client secret ottenuti dall'applicazione OAuth 2.0, quindi fai clic su Verifica autenticazione.

      Per informazioni su come ottenere l'ID client e il segreto client, consulta Creare le credenziali del client OAuth. Per gli ambiti richiesti per la ricerca e le azioni, vedi Ambiti obbligatori.

    2. (Facoltativo) Espandi Impostazioni avanzate e inserisci il Nome servizio, il nome della risorsa del servizio creato in Service Directory. Questo campo è obbligatorio quando i Controlli di servizio VPC sono abilitati.

    3. Scegli le azioni dall'elenco per attivarle per il connettore Gmail.

    Per visualizzare l'elenco delle azioni, vedi Visualizzare le 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. 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).

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 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 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.
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 Agent Space è 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