Configura un datastore Google Chat

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

Prima di iniziare

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

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

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

  • Aggiungi l'app OAuth alla lista consentita (solo amministratori): il datastore di Google Chat utilizza un Google'app OAuth gestita da per 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, vedi Aggiungere l'app OAuth gestita da Googlealla lista consentita.

Crea il datastore di Google Chat

Per creare il datastore di Google Chat, svolgi i seguenti passaggi:

  1. Nella Google Cloud console, 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 Chat e fai clic su Seleziona.

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

    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 località, 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) Nella sezione Policy di Sensitive Data Protection, allega una policy di Sensitive Data Protection esistente per ispezionare 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.

  10. 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 in corso… ad Attivo, il connettore Google Chat è pronto per essere utilizzato.

Dopo aver creato il datastore, collegalo a un'app esistente o creane una nuova e collegala al nuovo datastore, quindi autorizza Gemini Enterprise ad accedere a Google Chat prima di eseguire qualsiasi 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 Google Chat e inviato una query di ricerca a Gemini Enterprise:

  • Gemini Enterprise invia la query di ricerca direttamente all'API Google Chat.
  • 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 Google Chat, 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