Questa pagina descrive come creare un datastore e connettere Microsoft 365 a Gemini Enterprise.
Prima di iniziare
Prima di configurare la connessione a Microsoft 365:
Concedi il ruolo Discovery Engine Editor (
roles/discoveryengine.editor). Questo ruolo è necessario per consentire all'utente di creare il datastore. Per concedere questo ruolo:- Nella console Google Cloud vai alla pagina IAM.
- Individua l'account utente e fai clic su edit Modifica.
- Concedi all'utente il ruolo
Discovery Engine Editor. Per saperne di più, consulta Ruoli e autorizzazioni IAM.
Scegli la modalità di autenticazione del connettore a Microsoft 365:
- OAuth 2.0 (gestito da Google) (impostazione predefinita): il connettore utilizza un'applicazione Microsoft Entra gestita da Google . Non è necessario registrare un'applicazione o inserire un ID client o un client secret. A seconda delle impostazioni di consenso del tenant e delle azioni che attivi, un amministratore di Microsoft Entra potrebbe dover concedere il consenso per la tua organizzazione.
- OAuth 2.0 (Bring Your Own App): registra la tua applicazione Microsoft Entra e concedile le autorizzazioni di Microsoft Graph per le azioni che prevedi di attivare. Per completare i passaggi descritti in questa pagina, devi disporre dell'ID tenant, dell'ID client e del client secret di questa applicazione.
Per maggiori dettagli, consulta Configurazione di Microsoft 365.
Crea il datastore Microsoft 365
Per creare il datastore Microsoft 365, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Gemini Enterprise.
Fai clic su Datastore nel menu di navigazione.
Fai clic su Crea datastore.
Nella sezione Origine, cerca Microsoft 365 e fai clic su Seleziona.
Nella sezione Azioni, in Seleziona le azioni di Microsoft 365 da attivare, scegli le azioni che vuoi attivare:
Le azioni sono raggruppate in base alla superficie di Microsoft 365 su cui agiscono: Utenti e gruppi, SharePoint e OneDrive, Outlook e Teams. Seleziona un gruppo per attivare tutte le azioni al suo interno o seleziona singole azioni.
Le azioni di sola lettura vengono visualizzate nello stesso elenco delle azioni di scrittura. Solo Recupera il mio profilo è preselezionata, quindi seleziona anche le altre azioni di sola lettura di cui hai bisogno.
Per trovare un'azione in base al nome, utilizza Cerca azioni. Per attivare ogni azione, seleziona Seleziona tutte le azioni.
Fai clic su Continua.
Nella sezione Dati, espandi Impostazioni di autenticazione. In Seleziona il metodo di autenticazione, scegli una delle seguenti opzioni:
OAuth 2.0 (gestito da Google) (predefinito):
Non inserisci un ID tenant, un ID client o un client secret. Lascia Tipo di ambiente Microsoft 365 impostato su Standard: l'applicazione gestita da Googleè registrata nel cloud Microsoft commerciale. Ogni utente autorizza il connettore con il proprio account Microsoft 365 al primo utilizzo nell'app.
OAuth 2.0 (Bring Your Own App):
Inserisci i seguenti dettagli della tua applicazione Microsoft Entra:
- ID tenant: l'ID tenant del tuo tenant Microsoft 365.
- ID client: l'ID client della registrazione dell'app Microsoft Entra.
- Client secret: il client secret della registrazione dell'app Microsoft Entra.
- Tipo di ambiente Microsoft 365: seleziona Standard per i tenant su
login.microsoftonline.como US Government per i tenant sulogin.microsoftonline.us.
Fai clic su Verifica autenticazione, accedi con l'account che vuoi che il connettore utilizzi e concedi il consenso. Gemini Enterprise memorizza il token di aggiornamento risultante nella connessione; non devi inserirlo tu.
Fai clic su Continua.
Espandi Opzioni avanzate e segui questi passaggi:
Se il flusso di creazione del datastore mostra una sezione Opzioni avanzate, puoi selezionare la casella di controllo Abilita indirizzi IP statici al suo interno. In questo modo, il datastore utilizza un insieme fisso di indirizzi IP per il traffico in uscita, adatto per l'inserimento nella lista consentita sul sistema di origine. Per saperne di più, consulta Configura il traffico in uscita con IP statico.
Gli indirizzi IP statici sono disponibili solo con OAuth 2.0 (Bring Your Own App).
(Facoltativo) Per Ambiente cloud Microsoft 365, seleziona l'endpoint Microsoft Graph utilizzato dal tuo tenant: Standard/GCC, GCC High o DoD. Se non imposti questo valore, il connettore utilizza Standard/GCC.
Fai clic su Continua.
Espandi Entità da cercare e seleziona Ricerca a livello aziendale.
Fai clic su Continua.
Nella sezione Configurazione:
Dall'elenco Multiregionale, seleziona la località per il datastore.
Nel campo Nome connettore dati, inserisci un nome per il datastore.
(Facoltativo) Nel campo Tag, inserisci un identificatore stabile per questo datastore tra le versioni. Questo valore è immutabile dopo l'impostazione.
Se hai selezionato
usoeucome posizione, configura le impostazioni di crittografia:- (Facoltativo) Se non hai configurato le chiavi a singola regione, fai clic su Go to settings page (Vai alla pagina delle impostazioni) per farlo. Per saperne di più, consulta Registra una chiave a singola regione per i connettori di terze parti.
- 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.
(Facoltativo) Nella sezione Policy di Sensitive Data Protection, allega una policy di Sensitive Data Protection esistente per ispezionare e anonimizzare 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.
Fai clic su Crea.
Nella pagina Datastore, fai clic sul nome del datastore per visualizzarne lo stato. Dopo che lo stato del datastore passa da Creazione ad Attivo, puoi iniziare a utilizzare il datastore Microsoft 365.
Dopo aver creato il datastore, collegalo a un'app esistente o crea una nuova app e collegalo alla nuova app, quindi autorizza Gemini Enterprise ad accedere a Microsoft 365 prima di eseguire qualsiasi query.
Modifica le azioni abilitate
Seleziona le azioni da attivare nel passaggio Azioni quando crei il datastore. Per aggiungere o rimuovere azioni in un secondo momento, consulta Aggiungi azioni.
Gestione dei dati ed esecuzione delle query
Questa sezione descrive come Gemini Enterprise gestisce la tua query e le implicazioni per la privacy dell'utilizzo del datastore federato.
Esecuzione delle query
Dopo aver autorizzato Microsoft 365 e inviato una query di ricerca a Gemini Enterprise:
- Gemini Enterprise invia la query di ricerca direttamente all'API Microsoft Graph.
- Gemini Enterprise combina i risultati con quelli di altre origini dati connesse e mostra un risultato di ricerca completo.
Gestione dei dati
Quando utilizzi la ricerca federata di terze parti, si applicano le seguenti regole di gestione dei dati:
- La stringa di query viene inviata al backend di ricerca di terze parti (API Microsoft Graph).
- Queste terze parti potrebbero associare le query alla tua identità.
- Se sono abilitate più origini dati di ricerca federata, la query potrebbe essere inviata a tutte.
- Dopo che i dati raggiungono il sistema di terze parti, sono regolati dai termini di servizio e dalle norme sulla privacy di quel sistema.
Passaggi successivi
- Per fornire un'interfaccia utente per fare query sui dati di Microsoft 365, crea un'app e collegala al datastore di Microsoft 365.
- Per visualizzare e gestire l'elenco delle azioni attivate per il datastore di Microsoft 365, vedi Visualizza e gestisci le azioni.
- Per visualizzare l'anteprima dell'aspetto dei risultati di ricerca dopo la configurazione dell'app, consulta Ottieni i risultati di ricerca.
- Per abilitare gli avvisi per il datastore, vedi Configura gli avvisi per i datastore di terze parti.