Configura un datastore Salesforce

Anteprima privata: la creazione e l'utilizzo di un datastore mediante importazione dati è in anteprima privata. Per utilizzare il datastore di importazione dati, devi essere presente nella lista consentita. Per essere aggiunto alla lista consentita, contatta il tuo team dedicato all'account o il team di vendita.

Anteprima pubblica: la ricerca federata è in anteprima pubblica. Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

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

Prima di iniziare

Nota: per applicare in modo forzato il controllo dell'accesso all'origine dati e proteggere i dati in Google Gemini Enterprise, assicurati di aver configurato il tuo provider di identità.

Prima di configurare la connessione:

• Concedi il ruolo Discovery Engine Editor (roles/discoveryengine.editor). Questo ruolo è necessario per consentire all'utente di creare il datastore. Per concedere questo ruolo:

  1. Nella Google Cloud console vai alla pagina IAM.

     Vai a IAM

  2. Individua l'account utente e fai clic su edit Modifica.
  3. Concedi all'utente il ruolo Discovery Engine Editor. Per saperne di più, consulta Ruoli e autorizzazioni IAM.

• Configura l'account Salesforce e ottieni le credenziali di autenticazione.

Creare un datastore federato Salesforce

Per creare un datastore Salesforce:

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. Nella sezione Origine, cerca Salesforce e fai clic su Seleziona.

6. Nella sezione Dati:

   1. Nella sezione Impostazioni di autenticazione, configura l'autenticazione in base alla modalità di connessione scelta. Per saperne di più su come ottenere le credenziali di autenticazione, consulta la pagina relativa alla configurazione di Salesforce.

      • URL dell'istanza: l'URL di base dell'istanza Salesforce.
      • ID client: l'ID client OAuth per l'applicazione.
      • Client secret: il client secret OAuth per l'applicazione.
      • Fai clic su Accedi e completa l'accesso a Salesforce.

   2. Fai clic su Continua.

   3. Nella sezione Opzioni avanzate, se vuoi utilizzare l'istanza sandbox di Salesforce, seleziona la casella di controllo Usa sandbox.

   4. Fai clic su Continua.

   5. Nella sezione Entità da cercare, seleziona almeno un'entità.

   Nota: devi selezionare almeno un'entità per creare il datastore Salesforce. Tuttavia, il datastore Salesforce eseguirà la ricerca in tutte le entità dell'app Salesforce, indipendentemente dalla selezione.

7. Fai clic su Continua.

8. Se hai selezionato Ricerca federata, vai ad Azioni e seleziona le azioni richieste da attivare per il datastore dall'elenco Seleziona le azioni di Salesforce da attivare.

   Nota: se salti l'aggiunta di azioni in questo passaggio, potrai aggiungerle in un secondo momento. Per saperne di più, vedi Aggiungi azioni.

   Per visualizzare e gestire l'elenco delle azioni, vedi Visualizza e gestisci le azioni.

   1. Fai clic su Continua.

9. 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:
      • (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.
      Per saperne di più, vedi Chiavi di crittografia gestite dal cliente.

10. Fai clic su Continua.

11. Nella sezione Fatturazione, seleziona Prezzi generali o Prezzi configurabili. Per saperne di più, consulta Verifica lo stato di fatturazione dei progetti e Licenze.

12. Fai clic su Continua.

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

Dopo aver creato il datastore, crea un'app, collegala al datastore Salesforce e autorizza l'applicazione ad accedere a Salesforce prima di eseguire qualsiasi query.

Per saperne di più, vedi Passaggi successivi.

Creare un datastore di importazione dati Salesforce

Se vuoi creare un datastore di importazione dati, segui questi passaggi. In caso contrario, puoi saltare questa sezione.

Per utilizzare la console per sincronizzare i dati da Salesforce a Gemini Enterprise, segui questi passaggi:

1. Nella console, vai alla pagina Gemini Enterprise.

   Vai alla console

2. Nel menu di navigazione, fai clic su Datastore.
3. Fai clic su Crea datastore.
4. Nella pagina Select a data source (Seleziona un'origine dati), scorri o cerca Salesforce V2 per connettere l'origine di terze parti.
5. Nella sezione Autenticazioni, seleziona il metodo di autenticazione e inserisci le informazioni di autenticazione. Per saperne di più su come ottenere le credenziali di autenticazione, consulta la pagina relativa alla configurazione di Salesforce per il datastore di importazione dati dati.
6. Nella sezione Destinazioni, seleziona Pubblica o Privata.
   1. Per il tipo di destinazione Public (Pubblico), non è necessario creare la configurazione per l'allegato di servizio. Nel campo Login URL (URL di accesso), inserisci l'URL di accesso al server Salesforce.
   2. Per il tipo di destinazione Private (Privato), inserisci tutte le informazioni richieste:
      1. Service attachment (Collegamento servizio): inserisci il collegamento servizio.
      2. Base domain name (Nome di dominio di base): inserisci il tuo dominio di base.
      3. Login URL (URL di accesso): inserisci l'URL di accesso al server Salesforce.
7. Fai clic su Continua.
8. Nella sezione Entities to sync (Entità da sincronizzare), segui questi passaggi:
   1. Seleziona le entità da sincronizzare.
      • (Facoltativo) URL field name (Nome campo URL): inserisci un nome di colonna per sostituire l'URL entità predefinito con un URL personalizzato della tabella Salesforce.
   2. (Facoltativo) Per aggiungere entità personalizzate, fai clic su Add entities manually (Aggiungi entità manualmente). L'entità personalizzata deve avere il seguente formato <var>custom_object_name</var>__c.
   3. Seleziona la Sync frequency (Frequenza di sincronizzazione) per la Full Sync (Sincronizzazione completa) e la Incremental sync frequency (Frequenza di sincronizzazione incrementale) per la Incremental data sync (Sincronizzazione incrementale dei dati). Per saperne di più, vedi Pianificazioni di sincronizzazione.
9. Fai clic su Continua.
10. Nella sezione Configure your data connector (Configura il connettore dati), segui questi passaggi:
    1. Seleziona una regione per il datastore.
    2. Inserisci un nome per il tuo datastore.
    3. Fai clic su Crea. Gemini Enterprise crea il datastore e mostra i datastore nella pagina Datastore.
11. Per controllare lo stato dell'importazione, vai alla pagina Datastore e fai clic sul nome del datastore. Lo stato del connettore passa da Creazione in corso… a In esecuzione quando inizia la sincronizzazione dei dati.

Per saperne di più, vedi Passaggi successivi.

Passaggi successivi

• Per fornire un'interfaccia utente per fare query sui dati di Salesforce, crea un'app e connettila al datastore Salesforce.
• Per visualizzare e gestire l'elenco delle azioni, 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.