Questa pagina descrive come creare un datastore e connettere Salesforce a Gemini Enterprise. Il datastore esegue ricerche nei record di Salesforce in tempo reale e consente agli utenti finali di agire su di essi utilizzando il linguaggio naturale.
Prima di iniziare
Prima di configurare la connessione a Salesforce:
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.
Chiedi all'amministratore di Salesforce di attivare il server MCP SObject All nell'organizzazione Salesforce che stai connettendo e configura il metodo di autenticazione scelto:
- OAuth 2.0 (gestito da Google) (predefinito): installa il pacchetto gestito Gemini Enterprise - Salesforce Connector da Salesforce AppExchange nell'organizzazione. Non è necessario un ID client o un client secret.
- OAuth 2.0 (Bring Your Own App): crea un'app client esterna in quell'organizzazione e ottieni la chiave utente (ID client) e il secret utente (Client secret).
Finché l'app OAuth non è configurata, gli utenti non possono autorizzare il connettore; finché il server MCP SObject All non è attivo e ogni utente autorizzante non ha l'autorizzazione di sistema API Enabled nel proprio profilo Salesforce o un set di autorizzazioni assegnato, le query e le azioni non possono essere eseguite. Consulta Configurazione di Salesforce.
Prendi nota dell'URL di My Domain della tua organizzazione, ad esempio
https://example.my.salesforce.com. Inserisci questo valore come URI istanza. Per un'organizzazione sandbox, utilizza il dominio My Domain della sandbox, ad esempiohttps://example--sandbox.sandbox.my.salesforce.com.
Trova l'URL di My Domain
Per trovare l'URL di Il mio dominio da inserire come URI istanza:
- In Salesforce, vai a Setup (Configurazione).
- Nella casella Ricerca rapida, cerca e seleziona Il mio dominio.
- In URL My Domain attuale, copia l'URL, ad esempio
https://example.my.salesforce.com.
Per un'organizzazione sandbox, esegui questa operazione nella sandbox. L'URL del dominio personale è simile a https://example--sandbox.sandbox.my.salesforce.com.
Crea il datastore Salesforce
Per creare il datastore Salesforce, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Gemini Enterprise.
Seleziona o crea un progetto Google Cloud .
Nel menu di navigazione, fai clic su Datastore.
Fai clic su Crea datastore.
Nella sezione Origine, cerca Salesforce e fai clic su Seleziona.
Nella sezione Dati:
Nella sezione Impostazioni di autenticazione, per Seleziona il metodo di autenticazione, scegli una delle seguenti opzioni:
- OAuth 2.0 (gestito da Google) (impostazione predefinita):
- In URI istanza, inserisci l'URL di Il mio dominio del tuo sito Salesforce, ad esempio
https://example.my.salesforce.com. Per un'organizzazione sandbox, inserisci Il mio dominio della sandbox, ad esempiohttps://example--sandbox.sandbox.my.salesforce.com.
- In URI istanza, inserisci l'URL di Il mio dominio del tuo sito Salesforce, ad esempio
- OAuth 2.0 (Bring Your Own App):
- In URI istanza, inserisci l'URL di Il mio dominio del tuo sito Salesforce, ad esempio
https://example.my.salesforce.com. Per un'organizzazione sandbox, inserisci il tuo dominio sandbox, ad esempiohttps://example--sandbox.sandbox.my.salesforce.com. - Per ID client, inserisci la chiave utente della tua app client esterna Salesforce.
- Per Client secret, inserisci il secret consumer della tua app client esterna Salesforce.
- Fai clic su Verifica autenticazione e completa l'accesso a Salesforce per verificare le tue credenziali OAuth.
- In URI istanza, inserisci l'URL di Il mio dominio del tuo sito Salesforce, ad esempio
- OAuth 2.0 (gestito da Google) (impostazione predefinita):
In Opzioni avanzate, se stai connettendo un'organizzazione sandbox, seleziona Usa sandbox. Salesforce gestisce quindi le azioni dalla tua organizzazione sandbox.
Fai clic su Continua.
Nella sezione Entità da cercare, seleziona le entità che vuoi che Gemini Enterprise cerchi. Per Salesforce, seleziona Salesforce MCP.
Fai clic su Continua.
(Facoltativo) Nella sezione Azioni, seleziona le azioni di creazione, aggiornamento ed eliminazione che vuoi attivare per gli utenti oppure lasciale deselezionate per mantenere il connettore in sola lettura (le azioni di sola lettura sono attivate per impostazione predefinita). Puoi anche attivare o disattivare queste azioni dopo aver creato il datastore; consulta Attiva le azioni.
Fai clic su Continua.
Nella sezione Configurazione:
- Dall'elenco Multiregionale, seleziona la posizione per il connettore dati.
- Nel campo Nome connettore dati, inserisci un nome per il connettore.
- 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 Google-managed encryption key (Chiave di crittografia gestita daGoogle) o Cloud KMS key (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.
Fai clic su Continua.
Nella sezione Fatturazione, seleziona Prezzi generali o Prezzi configurabili. Per saperne di più, consulta Verifica lo stato di fatturazione dei progetti e Licenze.
Fai clic su Crea. Gemini Enterprise crea il datastore e mostra i datastore nella pagina Datastore.
Nella pagina Datastore, fai clic sul nome del datastore per visualizzarne lo stato. Dopo che lo stato del datastore passa da Creazione ad Attivo, il datastore Salesforce è pronto per essere utilizzato.
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 Salesforce prima di eseguire qualsiasi query.
Abilita azioni
Quando crei un datastore Salesforce, le relative azioni vengono precompilate nel datastore. Le azioni di sola lettura (Soql Query, Find, Get Object Schema, Get Related Records, List Recent Sobject Records e Get User Info) sono abilitate per impostazione predefinita e sempre disponibili. Le azioni che creano, aggiornano o eliminano i record (Crea record Sobject, Aggiorna record Sobject, Aggiorna record correlato, Elimina record Sobject ed Elimina record correlato) sono disattivate per impostazione predefinita.
Se non hai attivato le azioni di creazione, aggiornamento o eliminazione durante la creazione del datastore, puoi attivarle in qualsiasi momento seguendo questi passaggi:
Nella console Google Cloud , vai al datastore Salesforce.
Seleziona la scheda Azioni.
Seleziona le azioni che vuoi attivare (Create Sobject Record, Update Sobject Record, Update Related Record, Delete Sobject Record o Delete Related Record). Per mantenere il connettore in sola lettura, lascia queste azioni deselezionate.
Fai clic su Attiva azioni.
Per l'elenco delle azioni, consulta Azioni supportate.
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 Salesforce e inviato una query di ricerca a Gemini Enterprise:
- Gemini Enterprise invia la query di ricerca direttamente al server MCP di Salesforce.
- 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 (server MCP Salesforce).
- 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 Salesforce, crea un'app e collegala al datastore Salesforce.
- 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.