Configurare un datastore Zendesk

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

Prima di iniziare

Prima di configurare il datastore Zendesk, assicurati di:

  1. 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 console Google Cloud vai alla pagina IAM.

      Vai a IAM

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

  2. Crea un client OAuth e ottieni le seguenti credenziali:

    • ID client

    • Client secret

  3. Configura le autorizzazioni necessarie in Zendesk per l'applicazione OAuth.

  4. Assicurati che l'accesso tramite token sia attivato nelle impostazioni dell'API Zendesk.

Crea il datastore Zendesk

Per creare il datastore Zendesk, segui questi passaggi:

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

  6. Nella sezione Dati:

    1. Nella sezione Authentication settings (Impostazioni di autenticazione), fornisci i seguenti dettagli: * Instance URI (URI istanza):inserisci l'URI istanza di Zendesk (ad esempio, https://[subdomain].zendesk.com). * Client ID (ID client):l'identificatore univoco dell'applicazione registrata in Zendesk. * Client secret:la chiave segreta generata durante la procedura di registrazione dell'applicazione OAuth 2.0 in Zendesk.

      Per informazioni su come ottenere l'ID client e il client secret, vedi Ottieni un ID client e un client secret. Per le autorizzazioni necessarie per eseguire la ricerca, consulta Autorizzazioni obbligatorie.

    2. Fai clic su Login (Accedi) e completa l'accesso a Zendesk.

    3. Fai clic su Continua.

    4. Nella sezione Destinazioni:

      1. Server proxy: inserisci il nome host o l'indirizzo IP di un proxy per instradare il traffico HTTP, inclusi Host e Porta.
      2. URL di Zendesk Support: inserisci l'URL dell'istanza, incluso https://, che è l'URL di Zendesk Support.
      3. Fai clic su Continua.

    5. (Facoltativo) Nella sezione Opzioni avanzate:

      1. Abilita indirizzi IP statici: registra un insieme ristretto di indirizzi IP statici da aggiungere alla lista consentita del tuo sistema. Le esecuzioni della sincronizzazione non riusciranno finché questi indirizzi IP non saranno inclusi nella lista consentita.
      2. Richieste API massime al minuto: il numero massimo di richieste API al minuto da inviare all'istanza Zendesk per ogni esecuzione del connettore.
      3. Fai clic su Continua.

    6. Nella sezione Entità da cercare, seleziona tutte le entità da cercare nell'elenco. Devi selezionare almeno un'entità.

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

  9. Fai clic su Continua.

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

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 connettore Zendesk è pronto per essere utilizzato.

Dopo aver creato il datastore, crea un'app, collegala al datastore Zendesk e autorizza Gemini Enterprise ad accedere a Zendesk prima di eseguire qualsiasi query.

Per informazioni sulle autorizzazioni necessarie per eseguire la ricerca, consulta Autorizzazioni obbligatorie.

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 Zendesk e inviato una query di ricerca a Gemini Enterprise:

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

Passaggi successivi