Menyiapkan penyimpanan data Freshservice

Pratinjau publik: Fitur penelusuran dan tindakan gabungan masih dalam pratinjau publik. Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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

Sebelum memulai

Sebelum menyiapkan koneksi Freshservice, lakukan hal berikut:

1. Berikan peran Discovery Engine Editor (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 edit Edit.
   3. Berikan peran Discovery Engine Editor kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

Catatan: Freshservice menggunakan OAuth yang dikelola Google. Anda tidak perlu membuat aplikasi OAuth sendiri atau memberikan client ID dan rahasia klien. Anda mengizinkan konektor dengan akun Freshservice saat mengaktifkan konektor di aplikasi.

Membuat penyimpanan data Freshservice

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

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

   Gemini Enterprise

2. Pilih atau buat project Google Cloud .

3. Di menu navigasi, klik Penyimpanan data.

4. Klik Buat penyimpanan data.

5. Di bagian Source, telusuri Freshservice, lalu klik Select.

6. Di bagian Data:

   1. Di kolom Freshworks Organization URL, masukkan URL lengkap organisasi Freshworks Anda. Sertakan https:// dan hilangkan garis miring di akhir. Misalnya, https://cymbalworkspace.freshworks.com atau https://cymbalworkspace.myfreshworks.com. Gemini Enterprise menggunakan nilai ini selama otorisasi untuk melakukan autentikasi dengan platform Freshworks.

      Catatan: Freshworks menghosting organisasi di domain freshworks.com atau myfreshworks.com. Masukkan URL persis seperti yang muncul untuk organisasi Anda.

   2. Di kolom Freshservice Account Subdomain, masukkan subdomain akun dari URL Freshservice Anda (misalnya, jika URL-nya adalah https://cymbalaccount.freshservice.com, masukkan cymbalaccount). Gemini Enterprise menggunakan nilai ini untuk mengarahkan permintaan ke akun Freshservice yang benar.

   Catatan: URL Organisasi Freshworks dan Subdomain Akun Freshservice mungkin berbeda. Satu organisasi Freshworks dapat dikaitkan dengan beberapa akun Freshservice.

   1. Klik Lanjutkan.

   2. Di bagian Entities to search, pilih entitas yang Anda inginkan untuk ditelusuri oleh Gemini Enterprise. Untuk Freshservice, pilih Tickets.

7. Klik Lanjutkan.

8. Di bagian Actions, untuk Select Freshservice actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi penyimpanan data.

   Catatan: Jika Anda melewati penambahan tindakan pada langkah ini, Anda dapat menambahkannya nanti. Untuk mengetahui informasi selengkapnya, lihat Menambahkan tindakan.

9. Klik Lanjutkan.

10. Jika alur pembuatan penyimpanan data menampilkan bagian Advanced options, Anda dapat mencentang kotak Enable Static IP Addresses di dalamnya. Hal ini memastikan penyimpanan data menggunakan kumpulan alamat IP tetap untuk traffic keluar, yang cocok untuk dimasukkan ke daftar yang diizinkan di sistem sumber. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi egress IP statis.

11. Di bagian Configuration:

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

12. Klik Lanjutkan.

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

14. Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkan penyimpanan data Anda di halaman Data Stores.

Di halaman Data Stores, klik nama penyimpanan data Anda untuk melihat statusnya. Setelah status penyimpanan data berubah dari Creating menjadi Active, penyimpanan data Freshservice siap digunakan.

Setelah membuat penyimpanan data, hubungkan penyimpanan data yang baru saja Anda buat ke aplikasi yang sudah ada atau buat aplikasi baru dan hubungkan ke aplikasi baru, lalu izinkan Gemini Enterprise untuk mengakses Freshservice sebelum menjalankan kueri apa pun.

Penanganan data dan eksekusi kueri

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

Eksekusi kueri

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

• Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke Freshservice API.
• Gemini Enterprise menggabungkan hasil tersebut dengan hasil dari sumber data lain yang terhubung 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 (Freshservice API).
• Pihak ketiga ini dapat mengaitkan kueri dengan identitas Anda.
• Jika beberapa sumber data penelusuran gabungan diaktifkan, kueri mungkin akan dikirim ke semua sumber data tersebut.
• Setelah data mencapai sistem pihak ketiga, data tersebut akan diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

Catatan: Untuk meningkatkan akurasi, LLM dapat menulis ulang kueri Anda sebelum dikirim ke Freshservice. Kueri yang ditulis ulang ini dapat menggabungkan informasi dari histori kueri sesi Anda. Akibatnya, bagian dari histori kueri Anda mungkin juga disertakan dalam kueri yang dikirim ke Freshservice API.

Langkah berikutnya

• Untuk menyediakan antarmuka pengguna untuk mengkueri data Freshservice Anda, buat aplikasi dan hubungkan ke penyimpanan data Freshservice.
• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi Anda disiapkan, lihat Mendapatkan hasil penelusuran.
• Untuk mengaktifkan pemberitahuan bagi penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.