Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan ServiceNow ke Gemini Enterprise.
Sebelum memulai
Sebelum menyiapkan koneksi ServiceNow, pastikan Anda telah menyiapkan hal berikut:
Berikan peran Discovery Engine Editor (
roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:- Di konsol Google Cloud , buka halaman IAM.
- Temukan akun pengguna, lalu klik edit Edit.
- Berikan peran
Discovery Engine Editorkepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.
Pendaftaran OAuth ServiceNow: Daftarkan Gemini Enterprise sebagai aplikasi OAuth 2.0 di ServiceNow dengan batasan cakupan Broadly scoped.
Siapkan akun ServiceNow dan dapatkan kredensial autentikasi.
Siapkan peran administrator dan gunakan akun administrator untuk menetapkan peran dan izin pengguna yang diperlukan.
Siapkan project Google Cloud dengan akun administrator yang mampu mengelola konfigurasi tingkat organisasi, sehingga organisasi dapat menyiapkan workforce pool. Pastikan organisasi Anda disiapkan untuk mengelola workforce pool.
Untuk mengaktifkan kemampuan penelusuran kata kunci, pastikan "pengindeksan tabel" diaktifkan di instance ServiceNow Anda. Untuk mengetahui informasinya, lihat Mengonfigurasi tabel untuk pengindeksan dan penelusuran.
Membuat penyimpanan data ServiceNow
Untuk membuat penyimpanan data ServiceNow, lakukan langkah-langkah berikut:
Di konsol Google Cloud , buka halaman Gemini Enterprise.
Pilih atau buat project Google Cloud .
Di menu navigasi, klik Penyimpanan data.
Klik Buat penyimpanan data.
Di bagian Source, telusuri ServiceNow, lalu klik Select.
Di bagian Data:
Di bagian Connector mode, pilih Penyerapan data atau Federated search sebagai mode koneksi.
Klik Lanjutkan.
Di bagian Authentication settings, konfigurasikan autentikasi berdasarkan mode koneksi yang Anda pilih.
Jika Anda memilih Federated search, masukkan detail berikut:
- Instance URL: URL dasar instance ServiceNow Anda.
- Client ID: Client ID OAuth untuk aplikasi Anda.
- Client Secret: Rahasia klien OAuth untuk aplikasi Anda.
- Auth URI: URL endpoint otorisasi yang disediakan oleh ServiceNow.
- Token URI: URL endpoint token yang disediakan oleh ServiceNow.
- User ID: ID pengguna ServiceNow.
- Password: Sandi untuk pengguna ServiceNow.
Jika Anda memilih Penyerapan data, masukkan detail berikut:
- Instance URL: URL dasar instance ServiceNow Anda.
- Client ID: Client ID OAuth untuk aplikasi Anda.
- Client Secret: Rahasia klien OAuth untuk aplikasi Anda.
- User ID: ID pengguna ServiceNow.
- Password: Sandi untuk pengguna ServiceNow.
Untuk mengetahui informasi selengkapnya tentang kredensial, lihat Konfigurasi ServiceNow.
Jika Anda memilih Federated Search, klik Login dan selesaikan login ServiceNow.
Klik Lanjutkan.
Jika Anda memilih Federated search, lakukan tindakan berikut:
- Di bagian Destinations:
- Masukkan URL Instance situs ServiceNow Anda.
- Masukkan URL Dasar situs ServiceNow Anda.
Klik Lanjutkan.
Opsional: Di bagian Advanced options, konfigurasikan salah satu hal berikut:
- Untuk mengekspos atau menyembunyikan tabel sistem ServiceNow, centang kotak Include system tables.
- Di kolom Portal suffix, masukkan akhiran URL default untuk portal (misalnya,
sp). - Di kolom Knowledge portal suffix, masukkan akhiran untuk portal informasi. Anda dapat memasukkan satu akhiran (misalnya,
kb) atau petasys_idpusat informasi ke akhiran (misalnya,key1:value1|fallback:kb). - Di kolom Catalog portal suffix, masukkan akhiran untuk portal katalog. Anda dapat memasukkan satu akhiran (misalnya,
csm) atau peta katalogsys_idke akhiran (misalnya,key1:value1|fallback:csm). - Di kolom Incident portal suffix, masukkan akhiran untuk
portal insiden (misalnya,
ip). - Di kolom Public host URL, masukkan URL publik instance Anda untuk digunakan saat membuat URL (misalnya,
https://some-public-url.com). Jika Anda tidak memberikan nilai ini, Gemini Enterprise akan menggunakan Instance URL.
Klik Lanjutkan.
- Di bagian Destinations:
Jika Anda memilih Penyerapan data, di bagian Advanced options, lakukan hal berikut:
- Opsional: Di kolom URL suffix, masukkan akhiran URL dari link portal pengetahuan atau katalog.
- Opsional: Untuk mengizinkan sekumpulan alamat IP statis di sistem Anda, centang kotak Enable Static IP Addresses. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi egress IP statis.
- Opsional: Di kolom Max QPS, masukkan kueri maksimum per detik untuk menerapkan pembatasan kapasitas pada kueri yang dikirim konektor ke instance ServiceNow.
- Klik Lanjutkan.
Di bagian Entities to search (jika Anda memilih Federated search) atau Entities to sync (jika Anda memilih Penyerapan data), pilih semua entitas yang diperlukan.
- Jika Anda memilih Federated search, lanjutkan ke langkah berikutnya.
- Jika Anda memilih Penyerapan data, lanjutkan dengan langkah-langkah berikut:
- Opsional: Untuk menyinkronkan project tertentu, lakukan hal berikut:
- Klik Filter.
- Untuk memfilter entity dari indeks, centang kotak Exclude from the index, atau untuk memastikan entity disertakan dalam indeks, centang kotak Include to the index.
- Masukkan kunci. Tekan enter setelah setiap kunci.
- Klik Simpan.
- Untuk mengonfigurasi jadwal sinkronisasi, lakukan hal berikut:
- Dalam daftar Frekuensi sinkronisasi, pilih frekuensi sinkronisasi.
- Untuk menjadwalkan sinkronisasi penuh data entitas dan identitas secara terpisah, luaskan menu di bagian Sinkronisasi penuh, lalu pilih Opsi kustom.
- Dalam daftar Frekuensi sinkronisasi inkremental, pilih frekuensi sinkronisasi inkremental. Untuk mengetahui informasi selengkapnya, lihat Jadwal sinkronisasi.
- Dalam daftar Frekuensi sinkronisasi, pilih frekuensi sinkronisasi.
- Opsional: Untuk menyinkronkan project tertentu, lakukan hal berikut:
Klik Lanjutkan.
Di bagian Actions:
- Jika Anda memilih Federated search, dari Select ServiceNow actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi konektor.
Jika Anda memilih Penyerapan data:
- Di bagian Authentication settings, konfigurasikan autentikasi berdasarkan mode koneksi yang Anda pilih.
Berikan detail autentikasi berikut sesuai kebutuhan:
- Instance URL: URL dasar instance ServiceNow Anda.
- Client ID: Client ID OAuth untuk aplikasi Anda.
- Client Secret: Rahasia klien OAuth untuk aplikasi Anda.
- Auth URI: URL endpoint otorisasi yang disediakan oleh ServiceNow.
- Token URI: URL endpoint token yang disediakan oleh ServiceNow.
- User ID: ID pengguna ServiceNow.
- Password: Sandi untuk pengguna ServiceNow.
Untuk mengetahui informasi selengkapnya tentang kredensial, lihat Konfigurasi ServiceNow.
Klik Login dan login ke ServiceNow untuk memverifikasi akun Anda.
Klik Lanjutkan.
Opsional: Di bagian Advanced options, konfigurasikan salah satu hal berikut:
- Untuk mengekspos atau menyembunyikan tabel sistem ServiceNow, centang kotak Include system tables.
- Di kolom Portal suffix, masukkan akhiran URL default untuk portal (misalnya,
sp). - Di kolom Knowledge portal suffix, masukkan akhiran untuk portal informasi. Anda dapat memasukkan satu akhiran (misalnya,
kb) atau petasys_idpusat informasi ke akhiran (misalnya,key1:value1|fallback:kb). - Di kolom Catalog portal suffix, masukkan akhiran untuk portal katalog. Anda dapat memasukkan satu akhiran (misalnya,
csm) atau peta katalogsys_idke akhiran (misalnya,key1:value1|fallback:csm). - Di kolom Incident portal suffix, masukkan akhiran untuk
portal insiden (misalnya,
ip). - Di kolom Public host URL, masukkan URL publik instance Anda untuk digunakan saat membuat URL (misalnya,
https://some-public-url.com). Jika Anda tidak memberikan nilai ini, Gemini Enterprise akan menggunakan Instance URL.
Klik Lanjutkan.
Di bagian Destinations:
- Opsional: Masukkan Instance URL situs ServiceNow Anda.
- Opsional: Masukkan URL dasar situs ServiceNow Anda.
Klik Lanjutkan.
Dari Select ServiceNow actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi konektor.
Untuk mengelola daftar tindakan, lihat Mengelola tindakan.
Klik Lanjutkan.
Di bagian Configuration:
- Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
- Di kolom Nama konektor data Anda, masukkan nama untuk konektor Anda.
- Jika Anda memilih
usataueusebagai 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.
Klik Lanjutkan.
Di bagian Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.
Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkannya 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, konektor ServiceNow siap digunakan.
Untuk konektor penyerapan yang dibuat dengan ServiceNow, status penyimpanan data bertransisi dari Creating ke Running setelah inisiasi sinkronisasi. Statusnya kemudian berubah menjadi Active setelah penyerapan selesai, yang menandakan bahwa penyimpanan data telah dikonfigurasi sepenuhnya. Bergantung pada volume data, penyerapan mungkin memerlukan waktu beberapa jam.
Setelah membuat penyimpanan data, buat aplikasi, hubungkan ke penyimpanan data ServiceNow, dan izinkan Gemini Enterprise untuk mengakses ServiceNow 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 ServiceNow dan mengirim kueri penelusuran ke Gemini Enterprise:
- Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke ServiceNow 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 (ServiceNow 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.
Langkah berikutnya
- Untuk menyediakan antarmuka pengguna untuk mengkueri data ServiceNow, buat aplikasi dan hubungkan ke penyimpanan data ServiceNow.
- Untuk mengelola daftar tindakan, lihat Mengelola tindakan.
- Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran.
- Untuk mengaktifkan pemberitahuan bagi penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.