Questa pagina descrive come connettere Microsoft SharePoint Online a Gemini Enterprise utilizzando la federazione dei dati.
Utilizza la seguente procedura per eseguire ricerche nel tuo account SharePoint utilizzando la ricerca federata.Informazioni sulla federazione dei dati
Con la federazione dei dati, Gemini Enterprise recupera direttamente le informazioni dalle origini dati di terze parti utilizzando le API, anziché copiare i dati in Gemini Enterprise. Con questo approccio, puoi accedere immediatamente a origini dati esterne, senza attendere l'importazione.
Prima di iniziare
Prima di poter creare il connettore in Gemini Enterprise, devi configurare una registrazione dell'applicazione Entra per consentire l'accesso sicuro a SharePoint.
Per registrare Gemini Enterprise come applicazione OAuth 2.0 in Entra:
- Vai al centro di amministrazione di Microsoft Entra.
- Nel menu, espandi la sezione Applications (Applicazioni) e seleziona App registrations (Registrazioni di app).
- Nella pagina App registrations (Registrazioni app), seleziona New registration (Nuova registrazione).
Registrare una nuova app nel centro di amministrazione di Microsoft Entra - Crea una registrazione dell'app nella pagina Registra un'applicazione:
Seleziona il tipo di account e inserisci l'URI di reindirizzamento - Nella sezione Supported account types (Tipi di account supportati), seleziona Accounts in the organizational directory only (Solo account nella directory dell'organizzazione).
Nella sezione Redirect URI (URI di reindirizzamento), seleziona Web e inserisci i seguenti URL come URL di callback web (o URL di reindirizzamento):
https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.htmlhttps://vertexaisearch.cloud.google.com/oauth-redirect
Fai clic su Register (Registrati). La tua app verrà creata.
Per ottenere l'ID client e il secret per l'app:
- Nella pagina dell'app, seleziona Certificati e secret.
- Fai clic su Nuovo segreto client.
- Inserisci una descrizione per il secret.
- Seleziona una durata di scadenza. Ti consigliamo di selezionare il valore predefinito.
- Fai clic su Aggiungi.
- Copia il secret visualizzato nella colonna Valore (
Client Secret) e l'identificatore nella colonna ID secret (Client ID) e memorizzali in modo sicuro per utilizzarli in un secondo momento.
Per configurare le autorizzazioni API richieste per l'app:
Nella pagina dell'app, seleziona Autorizzazioni API.
Fai clic su Aggiungi autorizzazioni.
Nella pagina Request API permissions (Richiedi autorizzazioni API), seleziona SharePoint.
Seleziona Autorizzazioni delegate.
Cerca e seleziona le seguenti autorizzazioni:
Sites.Search.All
Per l'accesso al sito, scegli una delle seguenti autorizzazioni:
AllSites.Read: consente di cercare in tutti i documenti a cui ha accesso su qualsiasi sito.Sites.Selected: ti offre un maggiore controllo amministrativo. Gli amministratori possono limitare i siti su cui l'utente può eseguire query, ma devono concedere l'accesso a ogni singolo sito che vogliono attivare. Per ulteriori informazioni, vedi Concedere autorizzazioni a una raccolta siti specifica.
Fai clic su Aggiungi autorizzazioni.
Crea un connettore di ricerca federata con SharePoint
Console
Segui questi passaggi per la console Google Cloud per eseguire la ricerca federata in SharePoint da Gemini Enterprise.
Nella console Google Cloud , vai alla pagina Gemini Enterprise.
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Create data store (Crea datastore).
Nella pagina Select a data source (Seleziona un'origine dati), scorri o cerca SharePoint Federated (SharePoint federato) per connettere l'origine di terze parti.
Cerca SharePoint Federated Nella sezione Authentication settings (Impostazioni di autenticazione):
- Inserisci ID client, client secret, URL istanza e ID tenant.
- Fai clic su Authenticate (Autentica).
Fai clic su Continua.
Inserisci le informazioni di autenticazione
Seleziona i tipi di entità che vuoi cercare.
Seleziona i tipi di entità Seleziona una regione per l'origine dati.
Inserisci un nome per l'origine dati.
Configura il connettore dati Fai clic su Crea. Gemini Enterprise crea il datastore e mostra i datastore nella pagina Data Stores (Datastore).
Una volta creato il datastore, vai alla pagina Datastore e fai clic sul nome del datastore per visualizzarne lo stato. Se lo stato del connettore passa da Creating (Creazione) ad Active (Attivo), il connettore di ricerca federata è pronto per essere utilizzato.
Autorizzazione utente
Dopo aver creato un datastore di ricerca federata, puoi visualizzarlo nell'elenco come una delle origini dati nel pannello di gestione delle origini. Se non hai autorizzato in precedenza Gemini Enterprise, non puoi selezionare l'origine dati. Viene invece visualizzato un pulsante Authorize (Autorizza) accanto.
Per avviare il flusso di autorizzazione:
- Fai clic su Autorizza.
Viene visualizzato il server di autorizzazione SharePoint.
Fai clic su Autorizza Accedi al tuo account.
Fai clic su Concedi l'accesso. Dopo aver concesso l'accesso, il sistema ti reindirizzerà a Gemini Enterprise per completare il flusso di autorizzazione. Gemini Enterprise ottiene
access_tokene lo utilizza per accedere alla ricerca di terze parti.
Esecuzione delle query
Quando inserisci una query di ricerca:
- Se SharePoint è autorizzato, Gemini Enterprise invia la query all'API SharePoint.
- Gemini Enterprise combina i risultati con quelli di altre fonti e li visualizza.
Gestione dei dati
Quando utilizzi la ricerca federata di terze parti, la stringa di query viene inviata al backend di ricerca di terze parti. 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.
Una volta che i dati raggiungono il sistema di terze parti, sono regolati dai Termini di servizio e dalle norme sulla privacy di quel sistema (non dai termini di Google Cloud).