Menyiapkan penyimpanan data Zendesk

Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Zendesk ke Gemini Enterprise.

Sebelum memulai

Sebelum menyiapkan penyimpanan data Zendesk, pastikan hal berikut:

  1. Berikan peran Editor Discovery Engine (roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:

    1. Di konsol Google Cloud , buka halaman IAM.

      Buka IAM

    2. Temukan akun pengguna, lalu klik ikon edit Edit.
    3. Berikan peran Discovery Engine Editor kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

  2. Buat klien OAuth dan dapatkan kredensial berikut:

    • ID Klien

    • Rahasia klien

  3. Konfigurasi izin yang diperlukan dalam Zendesk untuk aplikasi OAuth.

  4. Pastikan akses token diaktifkan di setelan Zendesk API.

Buat penyimpanan data Zendesk

Untuk membuat penyimpanan data Zendesk, lakukan langkah-langkah berikut:

  1. Di konsol Google Cloud Google, buka halaman Gemini Enterprise.

    Gemini Enterprise

  2. Pilih atau buat project Google Cloud .

  3. Di menu navigasi, klik Data stores.

  4. Klik Create data store.

  5. Di Sumber, telusuri Zendesk, lalu klik Pilih.

  6. Di bagian Data:

    1. Di bagian Authentication settings, berikan detail berikut: * Instance URI: Masukkan URI instance Zendesk (misalnya, https://[subdomain].zendesk.com). * Client ID: ID unik aplikasi yang terdaftar di Zendesk. * Rahasia Klien: Kunci rahasia yang dibuat selama proses pendaftaran aplikasi OAuth 2.0 di Zendesk.

      Untuk mengetahui informasi tentang cara mendapatkan client ID dan rahasia klien, lihat Mendapatkan client ID dan rahasia klien. Untuk mengetahui izin yang diperlukan untuk melakukan penelusuran, lihat Izin yang diperlukan.

    2. Klik Login dan selesaikan login Zendesk.

    3. Klik Lanjutkan.

    4. Di bagian Tujuan:

      1. Server Proxy: Masukkan nama host atau alamat IP proxy untuk merutekan traffic HTTP, termasuk Host dan Port.
      2. URL Zendesk Support: Masukkan URL instance, termasuk https://, yang merupakan URL Zendesk Support Anda.
      3. Klik Lanjutkan.

    5. Opsional: Di bagian Advanced options:

      1. Aktifkan Alamat IP Statis: Mendaftarkan serangkaian kecil alamat IP statis untuk ditambahkan ke daftar yang diizinkan sistem Anda. Sinkronisasi akan gagal hingga alamat IP ini ada dalam daftar yang diizinkan.
      2. Permintaan API Maksimum Per Menit: Jumlah maksimum permintaan API per menit yang akan dikirim ke instance Zendesk Anda untuk setiap eksekusi konektor.
      3. Klik Lanjutkan.

    6. Di bagian Entitas yang akan ditelusuri, pilih semua entitas yang akan ditelusuri dari daftar. Anda harus memilih setidaknya satu entitas.

  7. Klik Lanjutkan.

  8. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Nama konektor data, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih US atau EU sebagai lokasi, konfigurasikan Setelan enkripsi:
      • Opsional: Jika Anda belum mengonfigurasi kunci satu wilayah, klik Buka halaman setelan untuk melakukannya. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan kunci satu wilayah untuk konektor pihak ketiga.
      • Pilih Kunci enkripsi yang dikelolaGoogle atau Kunci Cloud KMS.
      • Jika Anda memilih Kunci Cloud KMS:
        • Di daftar Key management type, pilih jenis yang sesuai.
        • Di daftar Kunci Cloud KMS, pilih kunci.
      Untuk informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

  9. Klik Lanjutkan.

  10. Di bagian Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

Di halaman Data Stores, klik nama penyimpanan data Anda untuk melihat statusnya. Setelah status penyimpanan data berubah dari Membuat menjadi Aktif, konektor Zendesk siap digunakan.

Setelah membuat penyimpanan data, buat aplikasi, hubungkan ke penyimpanan data Zendesk, dan otorisasi Gemini Enterprise ke Zendesk sebelum menjalankan kueri apa pun.

Untuk mengetahui informasi tentang izin yang diperlukan untuk melakukan penelusuran, lihat Izin yang diperlukan.

Penanganan data dan eksekusi kueri

Bagian ini menjelaskan cara Gemini Enterprise mengelola kueri Anda dan implikasi privasi penggunaan penyimpanan data gabungan.

Eksekusi kueri

Setelah Anda mengizinkan Zendesk dan mengirim kueri penelusuran ke Gemini Enterprise:

  • Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke Zendesk API.
  • Gemini Enterprise menggabungkan hasil dengan hasil dari sumber data terhubung lainnya dan menampilkan hasil penelusuran yang komprehensif.

Penanganan data

Saat menggunakan penelusuran gabungan pihak ketiga, aturan penanganan data berikut berlaku:

  • String kueri Anda dikirim ke backend penelusuran pihak ketiga (Zendesk API).
  • Pihak ketiga ini dapat mengaitkan kueri dengan identitas Anda.
  • Jika beberapa sumber data penelusuran gabungan diaktifkan, kueri mungkin dikirim ke semua sumber data tersebut.
  • Setelah data mencapai sistem pihak ketiga, data tersebut diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

Langkah berikutnya