Menghubungkan sumber data pihak ketiga

Catatan: Fitur ini adalah penawaran Pratinjau, yang tunduk pada "Persyaratan Penawaran Pra-GA" dari Persyaratan Khusus Layanan GCP. Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran. Selain itu, dengan menggunakan fitur ini, Anda menyetujui persyaratan dan ketentuan Pratinjau AI Generatif ("Persyaratan Pratinjau"). Untuk fitur ini, Anda dapat memproses data pribadi sebagaimana diuraikan dalam Adendum Pemrosesan Data Cloud, dengan tunduk pada batasan dan kewajiban yang berlaku dalam Perjanjian (sebagaimana didefinisikan dalam Persyaratan Pratinjau).

Halaman ini menjelaskan cara menghubungkan sumber data pihak ketiga ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Saat Anda menghubungkan sumber data pihak ketiga, Vertex AI Search akan membuat konektor data, dan mengaitkan datastore (disebut datastore entity) dengan datastore tersebut untuk entity yang Anda tentukan. Jenis entity khusus untuk sumber data yang Anda hubungkan. Misalnya, entitas Jira Cloud mencakup masalah, lampiran, komentar, dan log aktivitas.

Sumber data pihak ketiga hanya tersedia untuk aplikasi penelusuran umum. Aplikasi chat, rekomendasi, dan agen tidak dapat menggunakan sumber data pihak ketiga.

Konektor pihak ketiga tidak mematuhi CMEK.

Untuk mengimpor data dari sumber data Google, lihat Membuat penyimpanan data penelusuran.

Sebelum memulai

1. Hubungi tim Akun Google Anda dan minta untuk ditambahkan ke daftar yang diizinkan untuk konektor sumber data pihak ketiga.

2. Buka bagian untuk sumber yang ingin Anda gunakan:

   • Menghubungkan Adobe Experience Manager
   • Menghubungkan AODocs (Daftar yang diizinkan tambahan)
   • Menghubungkan Asana
   • Kotak Connect
   • Menghubungkan Coda (Daftar yang diizinkan tambahan)
   • Menghubungkan Confluence Cloud
   • Menghubungkan Pusat Data Confluence secara Lokal
   • Menghubungkan Dropbox
   • Menghubungkan Dynamics 365
   • Menghubungkan Entra ID
   • Hubungkan GitHub (Daftar yang diizinkan tambahan)
   • Hubungkan GitLab (Daftar yang diizinkan tambahan)
   • Menghubungkan Jira Cloud
   • Menghubungkan Data Center Jira secara Lokal
   • Menghubungkan Microsoft Outlook (Daftar yang diizinkan tambahan)
   • Menghubungkan Microsoft Teams (Daftar yang diizinkan tambahan)
   • Connect Monday
   • Hubungkan Notion (Daftar yang diizinkan tambahan)
   • Menghubungkan Okta
   • Menghubungkan OneDrive
   • Menghubungkan Salesforce
   • Menghubungkan ServiceNow
   • Menghubungkan Data Center SharePoint secara On-premises
   • Menghubungkan SharePoint Online
   • Menghubungkan Slack
   • Menghubungkan Trello
   • Menghubungkan WordPress
   • Menghubungkan Workday
   • Hubungkan Zendesk (Daftar yang diizinkan tambahan)

Menghubungkan Adobe Experience Manager

Gunakan prosedur berikut untuk menyinkronkan data dari Adobe Experience Manager ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Selain daftar yang diizinkan konektor pihak ketiga, konektor ini mengharuskan project Anda ditambahkan ke daftar yang diizinkan tambahan. Untuk ditambahkan ke daftar yang diizinkan ini, hubungi tim akun Vertex AI Search Anda.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

3. Administrator Adobe Experience Manager harus membuat atau mendapatkan hal berikut untuk berintegrasi dengan Vertex AI Search:

   • Kredensial layanan instance Adobe Experience Manager Anda
   • URL instance situs Adobe Experience Manager Anda

Membuat konektor Adobe Experience Manager

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Adobe Experience Manager ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Adobe Experience Manager untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Adobe Experience Manager Anda, lalu klik Lanjutkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan AODocs

Gunakan prosedur berikut untuk menyinkronkan data dari AODocs ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Selain daftar yang diizinkan konektor pihak ketiga, konektor ini mengharuskan project Anda ditambahkan ke daftar yang diizinkan tambahan. Untuk ditambahkan ke daftar yang diizinkan ini, hubungi tim akun Vertex AI Search Anda.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

3. Administrator AODocs harus membuat atau mendapatkan hal berikut untuk berintegrasi dengan Vertex AI Search:

   • ID Instance (URL domain instance AODocs Anda)
   • ID Klien
   • Rahasia klien

Membuat konektor AODocs

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari AODocs ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri AODocs untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi AODocs Anda, lalu klik Autentikasi. Jendela baru akan muncul.

6. Lakukan autentikasi akun Anda dan konfirmasi bahwa akun tersebut berhasil sebelum kembali ke halaman Menentukan sumber AODocs untuk penyimpanan data Anda.

7. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

8. Pilih region untuk penyimpanan data Anda.

9. Masukkan nama untuk konektor data Anda.

10. Pilih frekuensi sinkronisasi.

11. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

12. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Asana

Gunakan prosedur berikut untuk menyinkronkan data dari Asana ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

• Siapkan kontrol akses untuk sumber data Anda. Untuk informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

• Administrator Asana harus membuat atau mendapatkan token akses pribadi (PAT) berikut untuk autentikasi. Untuk informasi selengkapnya, lihat Token akses pribadi dalam dokumentasi Asana.

Untuk mengundang anggota ke ruang kerja Asana, lakukan langkah-langkah berikut:

1. Login ke aplikasi Asana dengan akun administrator Anda.

2. Klik ikon profil, lalu pilih Konsol Admin.

3. Klik Undang anggota. Masukkan alamat email pengguna dan project yang ingin Anda tambahkan.

4. Klik Kirim. Pengguna menerima undangan untuk memastikan mereka ditambahkan ke project.

Untuk membuat PAT, lakukan hal berikut:

1. Buka Konsol Developer Asana.

2. Klik Aplikasi saya.

3. Klik Create token.

4. Dalam dialog Create new token, isi informasi yang diperlukan.

5. Klik Create token.

6. Salin token untuk digunakan nanti.

7. Klik Selesai.

Membuat konektor cloud Asana

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Asana ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, pilih Penyimpanan Data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Asana untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan detail autentikasi, termasuk PAT yang dihasilkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data.

8. Berikan nama untuk penyimpanan data.

9. Tetapkan frekuensi sinkronisasi untuk penyimpanan data.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data, lalu klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi dan datastore disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Connect Box

Gunakan prosedur berikut untuk menyinkronkan data dari Box ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Anda harus memiliki akses administrator ke instance Box dengan 2FA diaktifkan. Semua petunjuk penyiapan hanya dapat dilakukan dari akun administrator.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

3. Baca Penyiapan dengan JWT dalam dokumentasi Box untuk mengetahui ringkasan penyiapan dengan screenshot.

Membuat aplikasi Box

1. Login ke Konsol Developer Box dengan akun administrator Anda.
2. Klik Create platform app.
3. Pilih Jenis aplikasi sebagai Aplikasi kustom.
4. Masukkan Nama aplikasi.
5. Tetapkan properti berikut:
   1. Tujuan: Integrasi
   2. Kategori: AI
   3. Sistem eksternal: Google Cloud Agent Builder
6. Pilih Authentication method sebagai Server authentication (with JWT).
7. Klik Create app.

Mengonfigurasi aplikasi Box

1. Di Box Developer Console, pilih Aplikasi platform, lalu buka tab Configuration.
2. Di bagian App access level, pilih App + Enterprise access.

3. Di bagian Application scopes, pilih cakupan berikut:

   1. Baca semua file dan folder yang disimpan di Box
   2. Edit semua file dan folder yang disimpan di Box
   3. Mengelola pengguna
   4. Mengelola grup
   5. Mengelola properti perusahaan

4. Di bagian Advanced features, pilih Make API calls using the as-user header.

5. Di bagian Tambahkan dan kelola kunci publik, klik Buat pasangan kunci publik/pribadi.

   1. Kunci publik akan otomatis diupload ke konsol dengan ID. ID ini digunakan saat membuat koneksi.
   2. Anda dapat mendownload file konfigurasi dengan kunci pribadi dan frasa sandi. Pastikan untuk menyimpan file ini untuk digunakan nanti.
   3. Jika ingin, untuk membuat kunci Anda sendiri, lihat panduan penyiapan pasangan kunci Box.

6. Klik Simpan perubahan.

Memberi otorisasi aplikasi Box

1. Di Box Developer Console, pilih Platform app, lalu buka tab Authorization.
2. Klik Review and submit.
3. Pada dialog Tinjau pengiriman otorisasi aplikasi, klik Kirim.
4. Login ke pengelola aplikasi platform admin Box dengan akun administrator Anda.
5. Pilih Aplikasi platform yang telah Anda konfigurasi.
6. Klik tiga titik (...) di baris yang sesuai.
7. Pilih Authorize app dari menu drop-down.
8. Dalam dialog Authorize app, klik Authorize untuk menyelesaikan proses otorisasi.

Siapkan informasi autentikasi Box berikut:

• ID Perusahaan: Dapatkan dari tab Setelan umum.
• Client ID dan Client secret: Dapatkan dari tab Configuration di bagian OAuth 2.0 credentials.
• Kunci pribadi, ID Kunci, dan Frasa Sandi: Parameter ini sudah dibuat dan didownload ke file lokal dari tab Konfigurasi di bagian Tambahkan dan kelola kunci publik saat mengonfigurasi aplikasi.

Membuat konektor Box

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Box ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Buat penyimpanan data.

4. Di halaman Pilih sumber data, scroll atau telusuri Box untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Anda.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk penyimpanan data Anda.

9. Pilih frekuensi sinkronisasi untuk penyimpanan data Anda.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi dan datastore disetel, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Coda

Gunakan prosedur berikut untuk menyinkronkan data dari Coda ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Selain daftar yang diizinkan konektor pihak ketiga, konektor ini mengharuskan project Anda ditambahkan ke daftar yang diizinkan tambahan. Untuk ditambahkan ke daftar yang diizinkan ini, hubungi tim akun Vertex AI Search Anda.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

3. Administrator Coda harus membuat atau mendapatkan token Coda API untuk berintegrasi dengan Vertex AI Search.

Membuat konektor Coda

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Coda ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Coda untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Coda Anda, lalu klik Lanjutkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Confluence Cloud

Gunakan prosedur berikut untuk menyinkronkan data dari Confluence Cloud ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah menyiapkan sumber data dan mengimpor data untuk pertama kalinya, Anda dapat memilih seberapa sering penyimpanan data disinkronkan dengan sumber tersebut.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Pastikan Anda memiliki akses administrator ke instance dan project Confluence.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

Menyiapkan autentikasi dan izin di Confluence

Pastikan Anda memiliki detail autentikasi dan akses administrator yang diperlukan ke instance Confluence. Gunakan petunjuk berikut untuk membuat client ID dan rahasia klien melalui Atlassian Developer Console, mengonfigurasi cakupan OAuth 2.0 yang diperlukan, menyiapkan izin untuk pengguna, mengambil URL dan ID instance Anda, mengonfigurasi peran, dan mengautentikasi untuk menyinkronkan data antara Confluence Cloud dan Vertex AI Search. Untuk mengaktifkan OAuth 2.0 dan mendapatkan client ID dan secret, lihat aplikasi OAuth 2.0 (3LO) dalam dokumentasi Developer Atlassian.

1. Buat integrasi OAuth 2.0 di Atlassian Developer Console:

   1. Login ke Atlassian Developer Console.
   2. Klik ikon profil, lalu pilih Atlassian Developer Console.
   3. Klik Create, lalu pilih OAuth 2.0 Integration.
   4. Masukkan nama untuk aplikasi, lalu lakukan hal berikut:
      1. Centang kotak persyaratan dan ketentuan.
      2. Klik Buat.
      3. Klik Authorization.
      4. Di tabel Jenis otorisasi, pilih Tambahkan untuk OAuth 2.0 (3LO).
   5. Di kolom Callback URL, masukkan https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html.
   6. Klik Simpan perubahan.

   Jika Anda melihat peringatan: Aplikasi Anda tidak memiliki API. Menambahkan API ke aplikasi Anda, lanjutkan ke langkah 2 dan selesaikan semua langkah yang tersisa. Jika tidak, lanjutkan ke langkah 4 dan langkah 5.

2. Aktifkan OAuth 2.0:

   1. Klik Izin.
   2. Buka Confluence API.
   3. Klik Tambahkan.
   4. Klik Configure.
   5. Buka tab Cakupan terperinci, lalu klik Edit cakupan.
   6. Pilih cakupan berikut.

      Melihat Cakupan

      • read:attachment:confluence
      • read:configuration:confluence
      • read:content.metadata:confluence
      • read:content-details:confluence
      • read:group:confluence
      • read:space:confluence
      • read:user:confluence
   7. Pastikan tujuh cakupan dipilih dan simpan perubahan Anda.

3. Dapatkan client ID dan rahasia klien:

   1. Klik Distribusi.
   2. Pilih Edit.
   3. Pilih Berbagi untuk mengaktifkan pengeditan kolom lainnya.
   4. Isi kolom yang tersisa.
   5. Pilih Ya saat Anda melihat Does your app store personal data?
   6. Pilih Setelan untuk menyalin Client ID dan Rahasia klien.

4. Dapatkan URL instance:

   1. Buka atlassian.net, lalu login dengan akun administrator Anda.
   2. Pilih aplikasi yang ingin disinkronkan. Misalnya, sinkronkan aplikasi pertama.
   3. Temukan URL instance. Nama ini muncul sebagai subdomain di kolom URL.

5. Dapatkan ID instance:

   1. Buka tab baru, salin URL instance, lalu tambahkan /_edge/tenant_info ke URL instance. Contoh, https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info.
   2. Buka link untuk menemukan nilai cloudId. cloudId adalah ID instance Anda.

Menyiapkan izin dan peran

1. Login ke atlassian.com dengan akun administrator Anda.
2. Klik ikon menu atau buka admin.atlassian.com.
3. Di halaman Admin, klik Kelola pengguna, lalu buka halaman Grup.
4. Buka situs domain Atlassian Anda, lalu buka instance Confluence Cloud.
5. Buka IAM.

6. Berikan peran Discovery Engine kepada administrator Confluence. Hal ini memungkinkan administrator Confluence mengonfigurasi konektor seperti yang diuraikan dalam Membuat konektor Confluence Cloud.

7. Berikan peran administrator kepada pengguna:

   1. Buat akun pengguna khusus. Gunakan akun ini untuk penyiapan penyimpanan data.
   2. Tetapkan peran Admin kepada pengguna baru.

8. Konfigurasikan izin di Atlassian:

   1. Buka situs domain Atlassian Anda, lalu buka instance Confluence Cloud. Atau, buka langsung admin.atlassian.com.

   2. Klik ikon menu dan pilih opsi yang diperlukan.

   3. Opsional: Jika diminta, pilih organisasi yang sesuai dari halaman landing.

9. Membuat dan mengonfigurasi grup:

   1. Di halaman Administrator, klik tombol Kelola pengguna jika diperlukan, lalu pilih Kelola pengguna dari menu drop-down.
   2. Di halaman Pengelolaan pengguna, pilih Grup.
   3. Klik Buat grup dan tetapkan nama. Gunakan grup ini untuk menetapkan izin yang diperlukan oleh konektor.

10. Tambahkan izin ke grup: Tetapkan peran Admin akses pengguna.

11. Tetapkan anggota grup:

    1. Di halaman Group, klik Add product, lalu pilih peran produk yang sesuai dari menu drop-down.Dalam hal ini, pilih User access admin.
    2. Klik Tambahkan untuk mengonfirmasi penetapan peran.
    3. Klik Tambahkan anggota grup untuk menyertakan akun pengguna atau anggota grup. Pastikan konektor mengautentikasi atas nama pengguna ini untuk mengambil dokumen.

Agar izin pengguna diterapkan dengan benar, setiap pengguna Confluence Cloud harus membuat email mereka terlihat oleh semua pengguna. Untuk melakukannya, ubah setelan visibilitas email di Confluence Cloud dan tetapkan visibilitas ke Anyone. Untuk mengetahui informasi selengkapnya, lihat Menetapkan visibilitas email dalam dokumentasi Atlassian.

Membuat konektor Confluence Cloud

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Confluence Cloud ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Confluence untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Anda, lalu klik Autentikasi.

6. Jendela baru akan muncul. Masukkan nama pengguna dan sandi instance. Pastikan autentikasi berhasil sebelum kembali ke halaman Menentukan sumber Confluence untuk penyimpanan data Anda.

7. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

8. Pilih region untuk konektor data Anda.

9. Masukkan nama untuk konektor data Anda.

10. Pilih frekuensi sinkronisasi.

11. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan Data.

12. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Lihat Mempratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Confluence Data Center di Server Lokal

Gunakan prosedur ini untuk membuat aplikasi penelusuran dan penyimpanan data Confluence Data Center di Agent Builder, yang menyinkronkan data Confluence on-premise dengan Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah menyiapkan sumber data dan mengimpor data untuk pertama kalinya, Anda dapat memilih seberapa sering penyimpanan data disinkronkan dengan sumber tersebut.

Sebelum memulai

Sebelum menyiapkan koneksi, pastikan Anda memiliki hal berikut:

1. Lampiran layanan (hanya diperlukan untuk jenis tujuan pribadi): Konfigurasikan lampiran layanan untuk transfer data yang aman.
2. Nama pengguna dan sandi: Dapatkan kredensial yang valid untuk autentikasi dari administrator Confluence Anda.
3. Opsional untuk jenis tujuan pribadi: Domain URL: Tentukan URL instance Confluence Data Center.
4. Opsional: Base domain name: Berikan nama domain dasar untuk instance Confluence.
5. Opsional: Port tujuan: Identifikasi port yang digunakan untuk komunikasi dengan Pusat Data Confluence.

6. Gunakan panduan konfigurasi berikut untuk membuat koneksi dengan Private Service Connect(PSC). Sesuaikan atau tambahkan resource sesuai kebutuhan. Pastikan lampiran layanan PSC dikonfigurasi dengan benar untuk terhubung ke instance pribadi dan memenuhi persyaratan untuk layanan yang dipublikasikan.

   1. Konfigurasikan setelan jaringan:

      1. Tempatkan lampiran layanan PSC dan load balancer di subnet yang berbeda dalam jaringan Virtual Private Cloud yang sama.

      2. Sistem backend harus tetap tertutup untuk jaringan publik karena alasan keamanan. Namun, pastikan server dapat menerima traffic dari sumber berikut:

         • Untuk load balancer berbasis proxy/HTTP(s) (ILB proxy L4, ILB L7), konfigurasikan backend untuk menerima permintaan dari subnet proxy di jaringan Virtual Private Cloud.

         • Untuk informasi selengkapnya, lihat dokumentasi Subnet khusus proxy untuk load balancer berbasis Envoy.

   2. Sesuaikan aturan firewall:

      1. Aturan masuk:

         • Izinkan traffic dari subnet lampiran layanan PSC ke subnet load balancer internal (ILB).
         • Pastikan ILB dapat mengirim traffic ke backend.
         • Izinkan pemeriksaan health check menjangkau backend.

      2. Aturan keluar: Mengaktifkan traffic keluar secara default, kecuali jika aturan penolakan tertentu berlaku.

7. Pertimbangan tambahan: Pastikan untuk menyimpan semua komponen, termasuk lampiran layanan PSC dan load balancer, di region yang sama.

Membuat lampiran layanan

Gunakan langkah-langkah berikut untuk membuat lampiran layanan:

1. Menentukan jenis endpoint: Pilih endpoint Publik atau Pribadi.

2. Untuk endpoint Publik: Jika Jenis tujuan Pusat Data Confluence adalah Publik, Anda tidak perlu membuat penyiapan untuk lampiran layanan. Sebagai gantinya, Anda dapat menggunakan URL publik di kolom Domain URL di konsol Google Cloud saat membuat konektor.

3. Untuk endpoint Pribadi:

   1. Gunakan private service connect (PSC) untuk mengaktifkan koneksi dari instance pribadi ke Google Cloud.
   2. Buat jaringan Virtual Private Cloud dan subnet yang diperlukan.
   3. Buat instance virtual machine (VM) dan instal layanan backend.
   4. Opsional: Siapkan probe health check untuk memantau kondisi backend.
   5. Tambahkan load balancer untuk merutekan traffic ke VM atau backend.
   6. Tentukan aturan firewall untuk mengizinkan traffic antara endpoint PSC dan backend.
   7. Publikasikan endpoint dengan membuat lampiran layanan PSC.

Membuat pengguna Confluence Data Center dan menyiapkan izin

Agar Vertex AI Search dapat memperoleh data dari Confluence, Anda harus membuat pengguna baru dengan izin minimum yang diperlukan. Ikuti langkah-langkah berikut untuk membuat pengguna dan menyiapkan izin yang diperlukan.

1. Login sebagai administrator:

   1. Buka situs domain Atlassian Anda, lalu buka instance Confluence Data Center.
   2. Masukkan nama pengguna dan sandi admin.
   3. Klik Log In.

2. Buat pengguna baru:

   Saat membuat penyimpanan data, Anda harus membuat pengguna untuk mendapatkan data dari instance pihak ketiga.

   1. Klik ikon setelan.
   2. Pilih Pengelolaan pengguna.
   3. Masukkan kredensial administrator, jika diminta.
   4. Di halaman Administrasi, klik Buat pengguna.
   5. Masukkan alamat email, nama lengkap, nama pengguna, dan sandi.
   6. Klik Buat pengguna.

3. Menetapkan pengguna ke grup:

   1. Di halaman Administrasi Confluence, buka tab Pengguna dan keamanan, lalu klik Grup.
   2. Klik Tambahkan grup. Masukkan nama untuk grup dan buat.
   3. Di kolom Temukan grup, masukkan nama grup untuk menemukan grup.
   4. Klik ikon setelan.
   5. Pilih akun profil, lalu buka Pengelolaan pengguna.
   6. Di halaman Pengguna, pada bagian Daftar pengguna, telusuri pengguna yang baru dibuat di kolom Cari pengguna.
   7. Klik pengguna untuk membuka halaman Lihat pengguna.
   8. Klik Edit grup untuk membuka halaman Edit grup pengguna.
   9. Centang kotak untuk grup pengguna yang dibuat.
   10. Klik Simpan untuk menetapkan pengguna ke grup yang baru dibuat.

   Pengguna yang ditambahkan akan ditetapkan di bagian Anggota grup.

4. Konfigurasikan izin pengguna:

   1. Di halaman Administrasi Confluence, buka tab Masalah.
   2. Cari Izin.
   3. Pilih Lihat izin global.
   4. Pilih Edit permissions.
   5. Di halaman Edit izin global, telusuri grup yang ditetapkan ke pengguna, lalu aktifkan opsi dapat menggunakan.

Mengonfigurasi ruang dokumentasi

1. Klik ikon Confluence untuk membuka halaman Dasbor.
2. Klik Buat ruang.
3. Pilih Ruang dokumentasi, lalu klik Berikutnya.
4. Masukkan semua detail yang diperlukan, lalu klik Buat untuk membuat ruang dokumentasi.
5. Di bagian Ruang saya, klik ruang yang baru dibuat.
6. Buka Halaman, lalu buka menu (tiga titik).
7. Pilih Batasan.
8. Dari menu drop-down Batasan, pilih opsi Melihat dan mengedit dibatasi.
9. Telusuri grup dan tetapkan izin dapat melihat.
10. Klik Terapkan. Pengguna dibuat dengan akses minimum dan izin ditetapkan untuk ruang. Anda juga dapat menetapkan izin ke blog.

Membuat konektor Pusat Data Confluence On-premises

Konsol

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Pusat data Confluence untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Anda, lalu klik Lanjutkan.

6. Dari menu drop-down Jenis tujuan, pilih Publik atau Pribadi.

   1. Untuk jenis tujuan Publik, Anda tidak perlu membuat penyiapan untuk lampiran layanan. Sebagai gantinya, Anda dapat menggunakan URL publik di kolom URL Domain di konsol Google Cloud.
   2. Untuk jenis tujuan Pribadi, masukkan semua informasi yang diperlukan:
      1. Jika instance Anda memiliki URL domain:
         • Service attachment: Masukkan lampiran layanan Anda.
         • Opsional: Nama domain dasar: Masukkan domain dasar Anda.
         • URL Domain: Masukkan URL domain Anda.
         • Opsional: Destination port: Masukkan port tujuan Anda.
      2. Jika instance Anda tidak memiliki URL domain:
         • Service attachment: Masukkan lampiran layanan Anda.
         • Opsional: Destination port: Masukkan port tujuan Anda.

7. Klik Lanjutkan.

8. Opsional: Advanced options: Pilih dan aktifkan Proxy settings dan SSL settings, jika diperlukan.

9. Di bagian Entity to sync, pilih semua entity yang diperlukan untuk disinkronkan, lalu klik Continue.

10. Pilih region untuk konektor data Anda dan masukkan nama untuk konektor data Anda.

11. Pilih frekuensi sinkronisasi.

Untuk jenis tujuan Pribadi, setelah Anda mengirimkan detail untuk konektor, VAIS akan mengirimkan permintaan koneksi ke PSC Anda. Buka konektor Anda untuk melihat pesan yang mengizinkan projectId di PSC. Konektor tetap dalam status Error hingga Anda mengizinkan koneksi di PSC. Saat Anda menyetujui permintaan koneksi, konektor akan berpindah ke status Aktif selama sinkronisasi berikutnya berjalan. Jika Anda mengonfigurasi PSC untuk menerima semua koneksi, konektor akan otomatis berpindah ke status Aktif setelah dibuat.

Untuk jenis tujuan Publik, konektor akan otomatis memasuki status Aktif setelah pengiriman.

Untuk memverifikasi status penyimpanan data dan aktivitas penyerapan, lakukan tindakan berikut:

1. Buka konektor di daftar penyimpanan data dan pantau statusnya hingga berubah menjadi Aktif.
2. Setelah status konektor berubah menjadi Aktif, klik entitas yang diperlukan dan pastikan semua entitas yang dipilih diserap. Status penyimpanan data bertransisi dari Membuat menjadi Berjalan saat sinkronisasi dimulai dan berubah menjadi Aktif setelah penyerapan selesai, yang menunjukkan bahwa penyimpanan data telah disiapkan. Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.
• Lihat Mempratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Dropbox

Gunakan prosedur berikut untuk menyinkronkan data dari Dropbox ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi selengkapnya, lihat Menggunakan kontrol akses sumber data.

2. Siapkan informasi autentikasi Dropbox berikut. Untuk mengetahui informasi tentang cara menyiapkan parameter ini, lihat Panduan OAuth dalam dokumentasi Dropbox.

   • ID Klien
   • Rahasia klien

Membuat konektor Dropbox

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Dropbox ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan Data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Dropbox untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Dropbox Anda, lalu klik Authenticate. Jendela baru akan muncul.

6. Lakukan autentikasi akun Anda dan konfirmasi bahwa akun tersebut berhasil sebelum kembali ke halaman Menentukan sumber Dropbox untuk penyimpanan data Anda.

7. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

8. Pilih lokasi untuk penyimpanan data Anda.

9. Masukkan nama untuk penyimpanan data Anda.

10. Pilih frekuensi sinkronisasi untuk penyimpanan data Anda.

11. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

12. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya. Periksa tab Dokumen untuk memastikan entitas Anda telah diserap dengan benar.

    Bergantung pada ukuran data Anda, proses penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi dan datastore disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Dynamics 365

Gunakan prosedur berikut untuk menyinkronkan data dari Dynamics 365 ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Perhatian: Konektor ini memberikan dukungan ACL sebagian. Selama pratinjau pribadi, domain pengguna diverifikasi, tetapi verifikasi pengguna terperinci tidak didukung.

Sebelum memulai

Sebelum membuat konektor Dynamics 365:

1. Administrator Dynamics 365 harus membuat atau mendapatkan hal berikut untuk berintegrasi dengan Vertex AI Search:

   • ID Klien
   • Rahasia klien
   • Tenant Azure
   • URL Organisasi

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

Membuat konektor Dynamics 365

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Dynamics 365 ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Dynamics 365 untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Dynamics 365 Anda, lalu klik Lanjutkan.

6. Masukkan tenant Azure dan URL organisasi Anda, lalu klik Lanjutkan.

7. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

8. Pilih region untuk penyimpanan data Anda.

9. Masukkan nama untuk konektor data Anda.

10. Pilih frekuensi sinkronisasi.

11. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

12. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Entra ID

Gunakan prosedur berikut untuk menyinkronkan data dari ID Entra ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

2. Untuk mendapatkan client ID dan rahasia klien, lakukan hal berikut:

   1. Buat aplikasi Entra ID:

      1. Login ke Pusat administrator Microsoft Entra dan klik Aplikasi.
      2. Di menu drop-down Application, klik App registrations.
      3. Di halaman App registrations, klik New registration.
      4. Klik Add new registration, lalu lakukan tindakan berikut:
         • Masukkan nama untuk aplikasi.
         • Di bagian Supported account types, pilih Accounts in the organizational directory only.
         • Di bagian Redirect URI, tambahkan URI pengalihan web yang mengarah ke: https://login.microsoftonline.com/common/oauth2/nativeclient.
      5. Klik Daftar.

   2. Menyimpan kredensial:

      Di jendela aplikasi terdaftar, simpan nilai berikut untuk digunakan nanti:

      1. Gunakan Application (client) ID untuk menetapkan parameter Client ID.
      2. Gunakan ID Direktori (tenant) untuk menetapkan parameter Azure Tenant.

   3. Membuat secret klien:

      1. Buka Certificates & secrets dan buat rahasia klien baru:
      2. Klik New client secret dan tentukan durasi yang diperlukan.
      3. Simpan secret klien dan salin nilai kunci untuk digunakan nanti.

Mengonfigurasi izin Entra ID API

1. Di jendela aplikasi terdaftar, klik API permissions.

2. Di bagian Configured permissions, pilih Microsoft Graph dan konfigurasikan izin berikut:

   Lihat izin

   • User.Read.All (Application)

   Jika Anda ingin menyerap profileCardAttributes, konfigurasikan izin berikut:

   Lihat izin

   • People.Read.All (Application)
   • PeopleSettings.Read.All (Application)

3. Berikan izin admin untuk semua izin yang ditambahkan. Persetujuan administrator diperlukan untuk menggunakan kredensial klien dalam alur autentikasi.

Membuat konektor Entra ID

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari ID Entra ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Entra ID untuk menghubungkan sumber pihak ketiga Anda.

5. Di bagian Authentication settings, masukkan client ID dan rahasia klien.

6. Lewati opsi Destinations dan klik Continue.

7. Di bagian Opsi lanjutan, masukkan ID tenant Azure.

8. Klik Lanjutkan.

9. Di bagian Entitas yang akan disinkronkan, pilih Profil pengguna.

10. Klik Lanjutkan.

11. Di Konfigurasikan konektor data, pilih region untuk penyimpanan data Anda.

12. Masukkan nama untuk konektor data Anda.

13. Pilih frekuensi sinkronisasi.

14. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

15. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

16. Saat status konektor berubah menjadi Aktif, buka tab Entity.

17. Klik entity userprofiles.

18. Periksa jumlah dokumen yang diserap dan pastikan jumlahnya cocok dengan jumlah pengguna di ID Entra.

    Jika aplikasi Entra ID memiliki izin yang diperlukan untuk menyerap atribut kustom, aplikasi akan menyerap hingga 15 atribut kartu profil per data. Secara default, atribut kustom tidak dapat ditelusuri.

Agar atribut kustom dapat ditelusuri, lakukan hal berikut:

1. Di halaman userprofiles, buka tab Schema.
2. Klik Edit.

3. Batalkan pilihan atribut, seperti address, agar tidak dapat diambil, ditelusuri, dan diindeks, lalu klik Save.

   Tombol Edit tetap tidak aktif selama beberapa menit sebelum diaktifkan kembali.

4. Jika tombol Edit dalam status Aktif, klik Edit.

5. Pilih kotak dapat diambil, dapat ditelusuri, dan dapat diindeks untuk atribut kustom yang diperlukan.

6. Aktifkan penelusuran.

7. Klik Simpan.

Menguji mesin telusur

Setelah mengonfigurasi mesin telusur, uji kemampuannya. Hal ini memastikannya menampilkan hasil yang akurat berdasarkan akses pengguna.

1. Mengaktifkan aplikasi web:

   1. Buka konfigurasi integrasi aplikasi dan alihkan ke Aktifkan aplikasi web.

2. Menguji aplikasi web:

   1. Klik Buka di samping link aplikasi web, lalu login sebagai pengguna.

   2. Verifikasi bahwa hasil penelusuran dibatasi untuk item yang dapat diakses oleh pengguna.

Melihat pratinjau hasil penelusuran orang

1. Di aplikasi penelusuran, buka Pratinjau dan mulai telusuri dalam konsol saat menggunakan IdP Google.

   • Atau, buka link yang diberikan dan login dengan IdP Anda untuk mulai menelusuri.
   • Hasil penelusuran akan muncul sebagai kartu orang, yang menampilkan detail pengguna seperti Nama, Jabatan, Email, dan Foto profil.

2. Klik kartu orang untuk melihat halaman profil mendetail, yang mencakup hal berikut:

   • Nama
   • Foto profil
   • Jabatan
   • Departemen
   • Rantai pengelolaan
   • Bawahan langsung

3. Jika atribut kustom (properti kartu profil) ditransfer dan dibuat dapat diindeks, ditelusuri, dan diambil:

   • Penelusuran berdasarkan nilai atribut kustom hanya menampilkan profil orang yang berisi atribut tersebut.
   • Atribut kustom muncul di hasil penelusuran, tetapi hanya dapat diakses melalui API, bukan antarmuka pengguna Vertex Search.

Mengonfigurasi kumpulan identitas tenaga kerja untuk IdP non-Google tanpa SSO

1. Jika karyawan Anda menggunakan IdP non-Google, tidak memiliki SSO dengan Google, atau bukan pelanggan Google Workspace, siapkan kumpulan tenaga kerja seperti yang dijelaskan di Menggunakan kontrol akses sumber data untuk mengaktifkan penelusuran karyawan.

   Dengan kumpulan tenaga kerja, Anda dapat mengelola dan mengautentikasi pengguna dari penyedia identitas eksternal, seperti Azure atau Okta, dalam konsol Google Cloud.

2. Untuk mengonfigurasi kumpulan tenaga kerja dan mengaktifkan aplikasi web agar akses pengguna lancar, lakukan hal berikut:

   1. Buat kumpulan tenaga kerja di tingkat organisasi di Google Cloud dengan mengikuti panduan penyiapan yang sesuai:

      1. Penyiapan OIDC Azure
      2. Penyiapan SAML Azure
      3. Penyiapan Okta & OIDC
      4. Penyiapan Okta & SAML

   2. Konfigurasikan kumpulan tenaga kerja di Agent Builder > Settings untuk wilayah tempat Anda membuat aplikasi.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Lihat Mempratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan GitHub

Gunakan prosedur berikut untuk menyinkronkan data dari GitHub ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Selain daftar yang diizinkan konektor pihak ketiga, konektor ini mengharuskan project Anda ditambahkan ke daftar yang diizinkan tambahan. Untuk ditambahkan ke daftar yang diizinkan ini, hubungi tim akun Vertex AI Search Anda.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

3. Administrator GitHub harus mendapatkan token akses pribadi instance GitHub untuk berintegrasi dengan Vertex AI Search.

Membuat konektor GitHub

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari GitHub ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri GitHub untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi GitHub Anda, lalu klik Lanjutkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan GitLab

Gunakan prosedur berikut untuk menyinkronkan data dari GitLab ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Selain daftar yang diizinkan konektor pihak ketiga, konektor ini mengharuskan project Anda ditambahkan ke daftar yang diizinkan tambahan. Untuk ditambahkan ke daftar yang diizinkan ini, hubungi tim akun Vertex AI Search Anda.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

3. Administrator GitLab harus mendapatkan token akses pribadi instance GitLab untuk berintegrasi dengan Vertex AI Search.

Membuat konektor GitLab

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari GitLab ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri GitLab untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi GitLab Anda, lalu klik Lanjutkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Jira Cloud

Gunakan prosedur berikut untuk menyinkronkan data dari Jira Cloud ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah menyiapkan sumber data dan mengimpor data untuk pertama kalinya, Anda dapat memilih seberapa sering penyimpanan data disinkronkan dengan sumber tersebut.

Sebelum memulai

Sebelum menyiapkan koneksi:

• Siapkan kontrol akses. Pastikan kontrol akses dikonfigurasi dengan benar untuk sumber data Anda. Langkah ini memastikan bahwa hanya pengguna yang diberi otorisasi yang dapat mengakses dan mengelola data. Untuk informasi selengkapnya, lihat dokumentasi Menggunakan kontrol akses sumber data.
• Agar izin pengguna diterapkan dengan benar, pengguna Jira Cloud harus memberikan izin berbagi.
• Pastikan Anda memiliki akun Atlassian, instance Jira, dan project.
• Pastikan Anda memiliki akses administrator ke instance Jira dan project.

Menyiapkan autentikasi dan izin di Jira

Dengan menggunakan petunjuk di bagian berikut, pastikan Anda memiliki detail autentikasi dan akses administrator yang diperlukan ke instance Jira. Buat client ID dan rahasia klien melalui Atlassian Developer Console, konfigurasikan cakupan OAuth 2.0 yang diperlukan, siapkan izin untuk pengguna, ambil URL dan ID instance Anda, konfigurasikan peran, dan autentikasi untuk menyinkronkan data antara Jira Cloud dan Vertex AI Search.

Membuat client ID dan rahasia klien

Catatan: Untuk mengaktifkan OAuth 2.0 dan mendapatkan client ID dan secret, lihat [aplikasi OAuth 2.0 (3LO)][confluence-oauth] dalam dokumentasi Developer Atlassian.

1. Buat integrasi OAuth 2.0 di Atlassian Developer Console:

   1. Login ke Atlassian Developer Console.
   2. Klik ikon profil, lalu pilih Developer Console.
   3. Klik Create, lalu pilih OAuth 2.0 Integration.

   4. Masukkan nama untuk aplikasi dan lakukan tindakan berikut:

      1. Centang kotak persyaratan dan ketentuan.
      2. Klik Buat.
      3. Klik Authorization.
      4. Di tabel Jenis otorisasi, pilih Tambahkan untuk OAuth 2.0 (3LO).

   5. Di kolom Callback URL, masukkan https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html.

   6. Klik Simpan perubahan.

   Jika Anda melihat peringatan: Aplikasi Anda tidak memiliki API. Menambahkan API ke aplikasi Anda, lanjutkan ke langkah 2 dan selesaikan semua langkah yang tersisa. Jika tidak, lanjutkan ke langkah 4 dan langkah 5.

2. Aktifkan OAuth 2.0:

   1. Pilih Izin:

      1. Buka Jira API.
      2. Klik Tambahkan.
      3. Klik Configure.
      4. Buka tab Cakupan klasik, lalu klik Edit cakupan. Pilih cakupan berikut:

         Melihat Cakupan

         • read:avatar:jira
         • read:audit-log:jira
         • read:group:jira
         • read:issue-security-level:jira
         • read:issue-security-scheme:jira
         • read:jira-user
         • read:jira-work
         • read:user:jira

   2. Pastikan delapan cakupan dipilih, lalu simpan perubahan Anda.

3. Dapatkan client ID dan rahasia klien:

   1. Klik Distribusi.

   2. Pilih Edit, lalu lakukan tindakan berikut:

      1. Pilih Berbagi untuk mengaktifkan pengeditan kolom lainnya.
      2. Isi kolom yang tersisa.
      3. Pilih Ya saat Anda melihat Does your app store personal data?

   3. Pilih Setelan untuk menyalin Client ID dan Rahasia Klien.

4. Dapatkan URL instance:

   1. Buka atlassian.net, lalu login dengan akun administrator Anda.
   2. Pilih aplikasi yang ingin disinkronkan. Misalnya, sinkronkan aplikasi pertama.
   3. Temukan URL instance, yang merupakan subdomain di kolom URL.

5. Dapatkan ID instance:

   1. Buka tab baru, salin URL instance, lalu tambahkan /_edge/tenant_info ke URL instance. Contoh, https://YOUR-INSTANCE.atlassian.net/_edge/tenant_info.
   2. Buka link untuk menemukan nilai cloudId. cloudId adalah ID instance Anda.

Menyiapkan izin dan peran

1. Login ke atlassian.com dengan akun administrator Anda.
2. Klik ikon menu di kiri atas atau buka admin.atlassian.com.
3. Di halaman Admin, klik Kelola pengguna, lalu buka halaman Grup.
4. Klik Buat grup. Masukkan nama untuk grup dan buat.
5. Klik Tambahkan produk.
6. Pada dialog Tambahkan produk ke grup, pilih Admin akses pengguna sebagai peran produk.
7. Klik Tambahkan.
8. Di halaman Grup, klik Tambahkan anggota grup untuk menambahkan pengguna atau akun yang diautentikasi oleh konektor.

Agar izin pengguna diterapkan dengan benar, setiap pengguna Jira Cloud harus membuat email mereka terlihat oleh semua pengguna. Untuk melakukannya, ubah setelan visibilitas email di Confluence Cloud dan tetapkan visibilitas ke Anyone. Untuk mengetahui informasi selengkapnya, lihat Menetapkan visibilitas email dalam dokumentasi Atlassian.

Membuat konektor Jira Cloud

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Jira Cloud ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan Data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Jira Cloud untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Anda, lalu klik Autentikasi.

6. Masukkan nama pengguna dan sandi instance.

7. Pastikan autentikasi berhasil sebelum kembali ke halaman Menentukan sumber Jira untuk penyimpanan data Anda.

8. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

9. Pilih region untuk penyimpanan data Anda.

10. Masukkan nama untuk penyimpanan data Anda.

11. Pilih frekuensi sinkronisasi.

12. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan Data.

13. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Lihat Hasil pratinjau untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Pusat Data Jira di Server Lokal

Gunakan prosedur ini untuk membuat aplikasi penelusuran dan penyimpanan data Jira Data Center di Agent Builder, yang menyinkronkan data Jira on-premise dengan Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah menyiapkan sumber data dan mengimpor data untuk pertama kalinya, Anda dapat memilih seberapa sering penyimpanan data disinkronkan dengan sumber tersebut.

Sebelum memulai

Sebelum menyiapkan koneksi, pastikan Anda memiliki hal berikut:

1. Lampiran layanan (Wajib untuk jenis tujuan pribadi saja): Konfigurasikan lampiran layanan untuk transfer data yang aman.
2. Nama pengguna dan sandi: Dapatkan kredensial yang valid untuk autentikasi dari administrator Jira Anda.
3. Opsional untuk jenis tujuan pribadi: URL Domain: Tentukan URL instance Data Center Jira.
4. Opsional: Base domain name: Berikan nama domain dasar untuk instance Jira.
5. Opsional: Port tujuan: Identifikasi port yang digunakan untuk berkomunikasi dengan Data Center Jira.

6. Gunakan panduan konfigurasi berikut untuk membuat koneksi dengan Private Service Connect(PSC). Sesuaikan atau tambahkan resource sesuai kebutuhan. Pastikan lampiran layanan PSC dikonfigurasi dengan benar untuk terhubung ke instance pribadi dan memenuhi persyaratan untuk layanan yang dipublikasikan.

   1. Konfigurasikan setelan jaringan:

      1. Tempatkan lampiran layanan PSC dan load balancer di subnet yang berbeda dalam jaringan Virtual Private Cloud yang sama.

      2. Sistem backend harus tetap tertutup untuk jaringan publik karena alasan keamanan. Namun, pastikan server dapat menerima traffic dari sumber berikut:

         • Untuk load balancer berbasis proxy/HTTP(s) (ILB proxy L4, ILB L7), konfigurasikan backend untuk menerima permintaan dari subnet proxy di jaringan Virtual Private Cloud.

         • Untuk informasi selengkapnya, lihat dokumentasi Subnet khusus proxy untuk load balancer berbasis Envoy.

   2. Sesuaikan aturan firewall:

      1. Aturan masuk:

         • Izinkan traffic dari subnet lampiran layanan PSC ke subnet load balancer internal (ILB).
         • Pastikan ILB dapat mengirim traffic ke backend.
         • Izinkan pemeriksaan health check menjangkau backend.

      2. Aturan keluar: Mengaktifkan traffic keluar secara default, kecuali jika aturan penolakan tertentu berlaku.

7. Pertimbangan tambahan: Pastikan untuk menyimpan semua komponen, termasuk lampiran layanan PSC dan load balancer, di region yang sama.

Membuat lampiran layanan

Gunakan langkah-langkah berikut untuk membuat lampiran layanan:

1. Menentukan jenis endpoint: Pilih endpoint Publik atau Pribadi.

2. Untuk endpoint Publik: Jika Jenis tujuan Pusat Data Jira adalah Publik, Anda tidak perlu membuat penyiapan untuk lampiran layanan. Sebagai gantinya, Anda dapat menggunakan URL publik di kolom Domain URL di konsol Google Cloud.

3. Untuk endpoint Pribadi:

   1. Gunakan PSC untuk mengaktifkan koneksi dari instance pribadi ke Google Cloud.
   2. Buat jaringan Virtual Private Cloud dan subnet yang diperlukan.
   3. Buat instance virtual machine (VM) dan instal layanan backend.
   4. Opsional: Siapkan probe health check untuk memantau kondisi backend.
   5. Tambahkan load balancer untuk merutekan traffic ke VM atau backend.
   6. Tentukan aturan firewall untuk mengizinkan traffic antara endpoint PSC dan backend.
   7. Publikasikan endpoint dengan membuat lampiran layanan PSC.

Membuat pengguna Jira Data Center dan menyiapkan izin

Agar Vertex AI Search dapat memperoleh data dari Jira, Anda harus membuat pengguna baru dengan izin minimum yang diperlukan. Ikuti langkah-langkah berikut untuk membuat pengguna dan menyiapkan izin yang diperlukan.

1. Login sebagai administrator:

   1. Buka situs domain Atlassian Anda dan buka instance Data Center Jira.
   2. Masukkan nama pengguna dan sandi administrator.
   3. Klik Log In.

2. Buat pengguna baru:

   Saat membuat penyimpanan data, Anda harus membuat pengguna untuk mendapatkan data dari instance pihak ketiga.

   1. Klik ikon setelan.
   2. Pilih Pengelolaan pengguna.
   3. Masukkan kredensial administrator, jika diminta.
   4. Di halaman Administrasi, klik Buat pengguna.
   5. Masukkan alamat email, nama lengkap, nama pengguna, dan sandi.
   6. Klik Buat pengguna.

3. Menetapkan pengguna ke grup:

   1. Di halaman Administration, pada bagian User management, klik Groups.
   2. Buat grup dengan memasukkan nama dan mengklik Tambahkan grup.
   3. Pilih grup yang baru dibuat.
   4. Klik Tambahkan/Hapus pengguna.
   5. Klik ikon anggota yang terletak di samping kotak Tambahkan anggota ke grup yang dipilih.
   6. Pilih pengguna yang baru dibuat, lalu klik Simpan pilihan.
   7. Klik Tambahkan pengguna yang dipilih untuk melihat pengguna baru di bagian anggota grup.

   Anda dapat melihat pengguna yang ditambahkan ditetapkan di bagian Anggota grup.

4. Konfigurasikan izin pengguna:

   1. Di halaman Administration, buka tab Issues.
   2. Pilih Skema izin.
   3. Klik Tambahkan skema izin.
   4. Masukkan nama untuk skema, lalu klik Tambahkan.
   5. Pilih skema, lalu klik ikon Izin.
   6. Klik Berikan izin.
   7. Tambahkan izin berikut, tetapkan izin ini ke grup yang dibuat sebelumnya, lalu klik Berikan:
      1. Menjelajahi project.
      2. Menjelajahi arsip project.
   8. Tambahkan skema ini ke project tempat pengguna dalam grup memerlukan akses untuk melihat project, masalah, komentar, log aktivitas, dan lampiran.

Anda dapat menambahkan skema ini ke project tempat pengguna dalam grup tersebut memerlukan akses untuk melihat project tersebut serta masalah, komentar, log aktivitas, dan lampiran dalam project tersebut.

Mengonfigurasi akses aplikasi

1. Di halaman Administration, buka tab Applications.
2. Di tab Applications, pilih Application access.
3. Telusuri grup yang dibuat, lalu pilih grup tersebut.
4. Pastikan grup muncul dalam daftar akses.

Pengguna dibuat dengan akses minimum. Skema ini ditambahkan ke project. Administrator Jira dapat menambahkan lebih banyak anggota ke grup tersebut atau menambahkan pengguna ke project tersebut.

Membuat konektor Pusat Data Jira On-premises

Konsol

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Pusat data Jira untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Anda, lalu klik Lanjutkan.

6. Dari menu drop-down Jenis tujuan, pilih Publik atau Pribadi.

   1. Untuk jenis tujuan Publik, Anda tidak perlu membuat penyiapan untuk lampiran layanan. Sebagai gantinya, Anda dapat menggunakan URL publik di kolom URL Domain di konsol Google Cloud.

   2. Untuk jenis tujuan Pribadi, masukkan semua informasi yang diperlukan:

      1. Jika instance Anda memiliki URL domain:
         • Service attachment: Masukkan lampiran layanan Anda.
         • Opsional: Nama domain dasar: Masukkan domain dasar Anda.
         • URL Domain: Masukkan URL domain Anda.
         • Opsional: Destination port: Masukkan port tujuan Anda.
      2. Jika instance Anda tidak memiliki URL domain:
         • Service attachment: Masukkan lampiran layanan Anda.
         • Opsional: Destination port: Masukkan port tujuan Anda.

7. Klik Lanjutkan.

8. Opsional: Advanced options: Pilih dan aktifkan Proxy settings dan SSL settings, jika diperlukan.

9. Di bagian Entity to sync, pilih semua entity yang diperlukan untuk disinkronkan, lalu klik Continue.

10. Pilih region untuk konektor data Anda dan masukkan nama untuk konektor data Anda.

11. Pilih frekuensi sinkronisasi.

Untuk jenis tujuan Pribadi, setelah Anda mengirimkan detail untuk konektor, VAIS akan mengirimkan permintaan koneksi ke PSC Anda. Buka konektor Anda untuk melihat pesan yang mengizinkan projectId di PSC. Konektor tetap dalam status Error hingga Anda mengizinkan koneksi di PSC. Saat Anda menyetujui permintaan koneksi, konektor akan berpindah ke status Aktif selama sinkronisasi berikutnya berjalan. Jika Anda mengonfigurasi PSC untuk menerima semua koneksi, konektor akan otomatis berpindah ke status Aktif setelah dibuat.

Untuk jenis tujuan Publik, konektor akan otomatis memasuki status Aktif setelah pengiriman. Untuk memverifikasi status penyimpanan data dan aktivitas penyerapan, lakukan tindakan berikut:

1. Buka konektor di daftar penyimpanan data dan pantau statusnya hingga berubah menjadi Aktif.
2. Setelah status konektor berubah menjadi Aktif, klik entitas yang diperlukan dan pastikan semua entitas yang dipilih diserap. Status penyimpanan data bertransisi dari Membuat menjadi Berjalan saat sinkronisasi dimulai dan berubah menjadi Aktif setelah penyerapan selesai, yang menunjukkan bahwa penyimpanan data telah disiapkan. Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Microsoft Outlook

Gunakan prosedur berikut untuk menyinkronkan data dari Microsoft Outlook ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Selain daftar yang diizinkan konektor pihak ketiga, konektor ini mengharuskan project Anda ditambahkan ke daftar yang diizinkan tambahan. Untuk ditambahkan ke daftar yang diizinkan ini, hubungi tim akun Vertex AI Search Anda.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

3. Administrator Microsoft Outlook harus membuat atau mendapatkan hal berikut untuk berintegrasi dengan Vertex AI Search:

   • ID Klien
   • Rahasia klien
   • ID Tenant

Membuat konektor Microsoft Outlook

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Microsoft Outlook ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Microsoft Outlook untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Microsoft Outlook Anda, lalu klik Lanjutkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Microsoft Teams

Gunakan prosedur berikut untuk menyinkronkan data dari Microsoft Teams ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Selain daftar yang diizinkan konektor pihak ketiga, konektor ini mengharuskan project Anda ditambahkan ke daftar yang diizinkan tambahan. Untuk ditambahkan ke daftar yang diizinkan ini, hubungi tim akun Vertex AI Search Anda.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

3. Administrator Microsoft Teams harus membuat atau mendapatkan hal berikut untuk berintegrasi dengan Vertex AI Search:

   • ID Klien
   • Rahasia klien
   • ID Tenant

Membuat konektor Microsoft Teams

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Microsoft Teams ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Microsoft Teams untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Microsoft Teams Anda, lalu klik Lanjutkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Connect Monday

Gunakan prosedur berikut untuk menyinkronkan data dari Senin ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi, pastikan Anda memiliki URL domain, akses administrator, dan token API.

Untuk membuat URL akun dan token API, lakukan hal berikut:

1. Login ke aplikasi Monday dengan akun administrator Anda.
2. Klik ikon Profil.
3. Pilih Administrasi.
4. Buka tab Umum, lalu masukkan Nama akun dan URL akun.
5. Kembali ke ikon Profil, lalu pilih Developer.
6. Di halaman Monday developer center, klik My access tokens.
7. Klik Tampilkan untuk menampilkan token.
8. Salin token untuk digunakan dalam autentikasi.

Membuat konektor Senin

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Senin ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di halaman Penyimpanan data, klik Buat penyimpanan data.

3. Di halaman Pilih sumber data, scroll atau telusuri Senin untuk menghubungkan sumber pihak ketiga Anda.

4. Masukkan informasi autentikasi Monday Anda, lalu klik Lanjutkan.

5. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

6. Pilih region untuk penyimpanan data Anda.

7. Masukkan nama untuk konektor data Anda.

8. Pilih frekuensi sinkronisasi.

9. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

10. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Notion

Gunakan prosedur berikut untuk menyinkronkan data dari Notion ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Perhatian: Konektor ini memberikan dukungan ACL sebagian. Selama pratinjau pribadi, domain pengguna diverifikasi, tetapi verifikasi pengguna terperinci tidak didukung.

Sebelum memulai

Sebelum menyiapkan konektor:

1. Selain daftar yang diizinkan konektor pihak ketiga, konektor ini mengharuskan project Anda ditambahkan ke daftar yang diizinkan tambahan. Untuk ditambahkan ke daftar yang diizinkan ini, hubungi tim akun Vertex AI Search Anda.

2. Administrator Notion harus membuat atau mendapatkan hal berikut untuk berintegrasi dengan Vertex AI Search:

   • Token API instance Notion
   • ID Workspace

3. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

Membuat konektor Notion

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Notion ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Notion untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Notion Anda, lalu klik Lanjutkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Okta

Gunakan prosedur berikut untuk menyinkronkan data dari Okta ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan konektor, pastikan Anda memiliki URL domain dan akses administrator ke instance Okta. Gunakan langkah-langkah berikut untuk mendapatkan URL instance, client ID, dan token API Okta.

1. Untuk mendapatkan URL instance Okta, lakukan hal berikut:

   1. Login ke halaman login Okta dengan kredensial administrator Anda.
   2. Klik ikon profil Anda atau buka langsung konsol Admin. URL instance Okta Anda akan muncul sebagai subdomain di kolom URL.

2. Untuk membuat client ID dan token API, lakukan langkah-langkah berikut:

   1. Login ke URL instance Okta dengan akun administrator Anda.
   2. Buka dasbor Admin.
   3. Klik ikon Applications, lalu pilih Applications.
   4. Klik Create app integration.
   5. Pilih OIDC - OpenID Connect.
   6. Pilih Web application sebagai jenis aplikasi, lalu klik Next.
   7. Masukkan nama di kolom App integration name.
   8. Scroll untuk melihat Tugas, pilih Lewati penetapan grup untuk saat ini.
   9. Klik Simpan.
   10. Di jendela Kredensial klien, klik Edit.
   11. Pilih Kunci publik / Kunci pribadi.
   12. Di bagian Kunci publik, klik Tambahkan kunci.
   13. Klik Generate new key, lalu klik Done dan Save.
   14. Dialog akan muncul; klik Simpan.
   15. Di bagian Setelan umum, klik Edit.
   16. Pilih Kredensial klien, lalu klik Simpan.

Membuat konektor Okta

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Okta ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Okta untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Okta Anda, lalu klik Lanjutkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan OneDrive

Gunakan prosedur berikut untuk menyinkronkan data dari OneDrive ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

2. Siapkan informasi autentikasi OneDrive berikut:

   1. Client ID, rahasia klien, dan tenant ID. Untuk informasi tentang cara menyiapkan parameter ini, lihat Panduan memulai: Mendaftarkan aplikasi dengan platform identitas Microsoft dalam dokumentasi Microsoft.

   2. Tentukan cakupan untuk akses. Peran administrator diperlukan. Untuk informasi selengkapnya, lihat Panduan memulai: Mengonfigurasi aplikasi klien untuk mengakses API web dalam dokumentasi Microsoft.

   3. Konfigurasikan cakupan berikut:

      Melihat cakupan

      • Files.Read.All (Application)
      • Group.Read.All (Application)
      • User.Read.All (Application)

Membuat konektor OneDrive

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari OneDrive ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri OneDrive untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi OneDrive Anda.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk penyimpanan data Anda.

9. Pilih frekuensi sinkronisasi untuk penyimpanan data Anda.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi dan datastore disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Salesforce

Gunakan prosedur berikut untuk menyinkronkan data dari Salesforce ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

2. Siapkan informasi autentikasi berikut. Untuk informasi tentang cara menyiapkan client ID dan secret klien di Salesforce, lihat Mengonfigurasi aplikasi terhubung untuk alur kredensial klien OAuth 2.0 dalam dokumentasi Salesforce.

   • URL Instance
   • ID Konsumen
   • Rahasia konsumen

Batasan berikut berlaku:

1. Menggunakan paket Enterprise atau Developer. Akun uji coba tidak didukung.
2. Pastikan Anda menggunakan Sales Cloud. Service Cloud tidak didukung.
3. Tambahkan Google Cloud ke daftar yang diizinkan CORS Salesforce. Lanjutkan ke langkah berikutnya jika Anda telah menyelesaikan tugas ini.
   1. Ikuti petunjuk dalam dokumentasi Salesforce untuk mengonfigurasi daftar yang diizinkan CORS.
   2. Masukkan https://console.cloud.google.com/ sebagai URL asal dan simpan konfigurasi Anda.

Membuat konektor Salesforce

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Salesforce ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Salesforce untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Salesforce Anda.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk penyimpanan data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Lihat Mempratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan ServiceNow

Gunakan prosedur berikut untuk menyinkronkan data dari ServiceNow ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi, pastikan Anda memiliki hal berikut:

1. Instance ServiceNow: Buat instance ServiceNow dengan mengikuti petunjuk di dokumentasi Developer ServiceNow.

2. Google Cloud project: Siapkan project Google Cloud dengan akun admin yang dapat mengelola konfigurasi tingkat organisasi, sehingga memastikan organisasi dapat menyiapkan kumpulan tenaga kerja.

3. Kumpulan tenaga kerja: Pastikan organisasi Anda disiapkan untuk mengelola kumpulan tenaga kerja.

Menyiapkan ServiceNow

ServiceNow menawarkan dua situs utama:

1. Situs ServiceNow utama: Situs untuk instance ServiceNow Anda.

   • Mengelola pengguna, grup, dan tugas administrasi sistem.
   • URL: URL untuk instance ServiceNow Anda.
   • Login menggunakan kredensial administrator Anda.

2. Situs developer:

   • Mengonfigurasi pusat informasi, menyiapkan alur kerja, dan mengembangkan aplikasi kustom.
   • URL: https://developer.service-now.com.
   • Login menggunakan ID ServiceNow Anda.

Catatan: Untuk penyiapan berikut, gunakan situs ServiceNow Utama untuk konfigurasi OAuth dan izin.

Untuk membuat endpoint OAuth, lakukan hal berikut:

1. Login ke instance ServiceNow utama dengan hak istimewa administrator.
2. Buka Semua > System OAuth > Application registry.
3. Klik Baru, lalu pilih Buat endpoint OAuth API untuk klien eksternal. Ambil client ID dan rahasia klien.

4. Isi informasi yang diperlukan:

   1. Name: Nama unik.
   2. URL Alihan: https://vertexaisearch.cloud.google.com/console/oauth/servicenow_oauth.html.

5. Klik Kirim untuk membuat kredensial.

6. Setelah pengiriman, klik nama untuk melihat secret klien.

7. Rahasia disamarkan. Klik ikon gembok di sampingnya untuk menampilkan secret.

8. Simpan salinan client ID dan rahasia untuk digunakan jika diperlukan.

9. Buka developer.service-now.com, lalu klik Kelola sandi instance.

10. Simpan salinan nama pengguna dan sandi untuk digunakan jika diperlukan.

11. Pada tahap ini, kelima informasi yang diperlukan untuk menyiapkan penyimpanan data ServiceNow sudah tersedia. Jika tidak ada masalah dengan penggunaan peran Admin untuk mengambil data, lanjutkan untuk membuat penyimpanan data.

Menyiapkan peran dan izin

Anda harus memiliki peran Admin keamanan untuk membuat dan mengelola pengguna. Jika Anda tidak memiliki peran ini, tingkatkan peran Anda ke security_admin dengan mengklik Tingkatkan peran di bagian profil Anda. Pilih peran security_admin, lalu klik Update. Peran security_admin diperlukan untuk membuat peran dan mengelola pengguna.

1. Buat peran khusus dengan aturan ACL:

   1. Buka Semua > Administrasi pengguna > Peran.
   2. Klik Baru untuk membuat peran baru.
   3. Pilih nama, lalu klik Kirim.
   4. Buka Keamanan sistem > Kontrol Akses (ACL) untuk membuat aturan ACL baru.
   5. Klik Baru untuk membuat aturan ACL baru.
   6. Pilih peran, seperti sys_user_role.
   7. Klik Kirim dan tetapkan peran.

   8. Ulangi proses ini hingga semua akses tabel diberikan. Konektor memerlukan akses ke tabel berikut agar setiap entity berhasil dijalankan:

      1. Insiden: incident.
      2. Item katalog: sc_cat_item, sc_cat_item_user_criteria_mtom, sc_cat_item_user_criteria_no_mtom, sc_cat_item_user_mtom, sc_cat_item_user_no_mtom.
      3. Pengetahuan: kb_knowledge, kb_knowledge_base, kb_uc_can_read_mtom, kb_uc_can_contribute_mtom.
      4. Lampiran: Semua item yang tercantum.
      5. Identitas: sys_user_role, sys_user_has_role, sys_user_group, sys_user_grmember, sys_user.
      6. Diperbarui saat kriteria baru diambil: core_company, cmn_location, cmn_department.
      7. Kriteria pengguna: user_criteria.

   9. Pastikan semua ACL diperbarui dengan membuka sys_security_acl_role_list.do di kotak penelusuran.

   10. Pilih peran yang akan diverifikasi.

   11. Pastikan semua ACL yang diperlukan ditetapkan ke peran yang dipilih.

2. Berikan peran ke akun layanan:

   1. Buka Semua > Administrasi Pengguna > Pengguna, lalu pilih pengguna.
   2. Cari pengguna yang akan diberi peran dan pilih pengguna tersebut.

3. Jika tidak ada pengguna yang tersedia, buka Keamanan sistem > Pengguna dan grup > Pengguna.

4. Klik Baru untuk membuat akun layanan baru di tabel Pengguna.

5. Pastikan untuk mencentang kotak Hanya akses layanan web.

6. Buka tabel Roles di bagian bawah halaman.

7. Klik Edit di sebelah kanan.

8. Berikan peran yang dibuat sebelumnya dan tetapkan kepada pengguna. Bergantung pada jenis peran yang dibuat, pilih peran yang sesuai dan tetapkan.

9. Dapatkan nama pengguna dan sandi untuk pengguna. Dari halaman yang sama, klik Set password.

10. Buat sandi secara otomatis dan simpan untuk digunakan nanti:

    1. ID Pengguna: manager.
    2. Sandi: Masukkan sandi yang dibuat otomatis.

Mengonfigurasi kumpulan tenaga kerja

Ikuti petunjuk untuk menyiapkan kumpulan tenaga kerja dengan salah satu konfigurasi berikut:

1. Penyiapan OIDC Azure
2. Penyiapan SAML Azure
3. Penyiapan Okta & OIDC
4. Penyiapan Okta & SAML

Membuat konektor ServiceNow

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari ServiceNow ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri ServiceNow untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi ServiceNow Anda.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk konektor data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data, lalu klik nama konektor data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Lihat Mempratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan SharePoint Data Center di Server lokal

Gunakan prosedur ini untuk membuat aplikasi penelusuran dan penyimpanan data SharePoint Data Center di Agent Builder, yang menyinkronkan data SharePoint lokal dengan Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah menyiapkan sumber data dan mengimpor data untuk pertama kalinya, Anda dapat memilih seberapa sering penyimpanan data disinkronkan dengan sumber tersebut.

Sebelum memulai

Sebelum menyiapkan koneksi, lakukan hal berikut:

1. Lampiran layanan (hanya diperlukan untuk jenis tujuan pribadi): Gunakan langkah-langkah berikut untuk membuat lampiran layanan guna transfer data yang aman.

   1. Menentukan jenis endpoint: Pilih endpoint Publik atau Pribadi.

   2. Untuk endpoint Publik: Jika Jenis tujuan Pusat Data SharePoint adalah Publik, Anda tidak perlu membuat penyiapan untuk lampiran layanan. Sebagai gantinya, Anda dapat menggunakan URL publik di kolom Domain URL di konsol Google Cloud saat membuat konektor.

   3. Untuk endpoint Pribadi:

      1. Gunakan private service connect (PSC) untuk mengaktifkan koneksi dari instance pribadi ke Google Cloud
      2. Buat jaringan Virtual Private Cloud dan subnet yang diperlukan.
      3. Buat instance virtual machine (VM) dan instal layanan backend.
      4. Opsional: Siapkan probe health check untuk memantau kondisi backend.
      5. Tambahkan load balancer untuk merutekan traffic ke VM atau backend.
      6. Menentukan aturan firewall untuk mengizinkan traffic antara endpoint PSC dan backend
      7. Publikasikan endpoint dengan membuat lampiran layanan PSC.

2. Nama pengguna dan sandi: Dapatkan kredensial yang valid untuk autentikasi dari administrator SharePoint Anda.

3. Opsional untuk jenis tujuan pribadi: Domain URL: Pertahankan URL domain instance Pusat Data SharePoint jika instance berada di balik proxy atau koneksi berbasis SSL.

4. Opsional: Nama domain dasar: Berikan nama domain dasar untuk instance SharePoint.

5. Opsional: Port tujuan: Identifikasi port yang digunakan untuk komunikasi dengan Pusat Data SharePoint.

6. Gunakan panduan konfigurasi berikut untuk membuat koneksi dengan Private Service Connect(PSC). Sesuaikan atau tambahkan resource sesuai kebutuhan. Pastikan lampiran layanan PSC dikonfigurasi dengan benar untuk terhubung ke instance pribadi dan memenuhi persyaratan untuk layanan yang dipublikasikan.

   1. Konfigurasikan setelan jaringan:

      1. Tempatkan lampiran layanan PSC dan load balancer di subnet yang berbeda dalam jaringan Virtual Private Cloud yang sama.

      2. Sistem backend harus tetap tertutup untuk jaringan publik karena alasan keamanan. Namun, pastikan server dapat menerima traffic dari sumber berikut:

         • Untuk load balancer berbasis proxy/HTTP(s) (ILB proxy L4, ILB L7), konfigurasikan backend untuk menerima permintaan dari subnet proxy di jaringan Virtual Private Cloud.

         • Untuk informasi selengkapnya, lihat dokumentasi Subnet khusus proxy untuk load balancer berbasis Envoy.

   2. Sesuaikan aturan firewall:

      1. Aturan masuk:

         • Izinkan traffic dari subnet lampiran layanan PSC ke subnet load balancer internal (ILB).
         • Pastikan ILB dapat mengirim traffic ke backend.
         • Izinkan pemeriksaan health check menjangkau backend.

      2. Aturan keluar: Mengaktifkan traffic keluar secara default, kecuali jika aturan penolakan tertentu berlaku.

7. Pertimbangan tambahan: Pastikan untuk menyimpan semua komponen, termasuk lampiran layanan PSC dan load balancer, di region yang sama.

Membuat pengguna SharePoint Data Center

Untuk membuat pengguna Pusat Data SharePoint, dapatkan nama pengguna dan sandi dari administrator. Administrator harus mengikuti langkah-langkah berikut untuk membuat pengguna baru di instance SharePoint Data Center.

1. Klik menu Start.
2. Buka Windows administrative tools > Active directory users and computers.
3. Luncurkan aplikasi Active directory users and computers.
4. Luaskan unit organisasi Anda dan buka penampung Pengguna untuk menambahkan pengguna baru.
5. Klik kanan Users, lalu pilih New > User.
6. Pada dialog Objek baru: pengguna:
   1. Masukkan Nama depan, Nama lengkap, dan Nama login pengguna.
   2. Klik Berikutnya.
7. Pada dialog Objek baru: pengguna:
   1. Isi informasi yang diperlukan:
      1. Password
      2. Konfirmasi sandi
   2. Pilih opsi berikut:
      1. Pengguna tidak dapat mengubah sandi
      2. Sandi tidak memiliki batas waktu
   3. Klik Berikutnya.
8. Klik Selesai.
9. Cari pengguna yang dibuat di bagian Users, klik dua kali, lalu pilih Properties.
10. Pada dialog Properties:
    1. Tambahkan alamat email untuk pengguna.
    2. Klik Terapkan.

Mengonfigurasi koleksi situs di SharePoint

1. Login ke konsol administrator SharePoint.
2. Di halaman Administrasi pusat, buka Pengelolaan aplikasi.
3. Klik Buat koleksi situs.
4. Di halaman Buat koleksi situs, masukkan informasi yang diperlukan di kolom Judul dan Deskripsi.
5. Di bagian Alamat situs, masukkan nama URL untuk situs.
6. Di bagian Administrator kumpulan situs utama, klik opsi Jelajahi di samping kolom Nama pengguna.
7. Di dialog Select people, masukkan nama pengguna administrator, lalu klik ikon search.
8. Pilih pengguna, lalu klik Oke. Halaman Situs berhasil dibuat akan muncul, dan URL situs akan ditampilkan.
9. Salin URL dan buka di tab baru. Situs akan muncul.

Login dengan pengguna yang dibuat

1. Gunakan kredensial pengguna yang dibuat untuk login ke situs SharePoint.
2. Verifikasi akses dan izin untuk pengguna.

Membuat konektor SharePoint Data Center On-premises

Konsol

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri SharePoint data center untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Anda, lalu klik Lanjutkan.

6. Dari menu drop-down Jenis tujuan, pilih Publik atau Pribadi.

   1. Untuk jenis tujuan Publik, Anda tidak perlu membuat penyiapan untuk lampiran layanan. Sebagai gantinya, Anda dapat menggunakan URL publik di kolom Domain URL di konsol Google Cloud.

   2. Untuk jenis tujuan Pribadi, masukkan semua informasi yang diperlukan:

      1. Jika instance Anda memiliki URL domain:
         • Service attachment: Masukkan lampiran layanan Anda.
         • Opsional: Nama domain dasar: Masukkan domain dasar Anda.
         • URL Domain: Masukkan URL domain Anda.
         • Opsional: Destination port: Masukkan port tujuan Anda.
      2. Jika instance Anda tidak memiliki URL domain:
         • Service attachment: Masukkan lampiran layanan Anda.
         • Opsional: Destination port: Masukkan port tujuan Anda.

7. Klik Lanjutkan.

8. Opsional: Advanced options: Pilih dan aktifkan Proxy settings dan SSL settings, jika diperlukan.

9. Di bagian Entity to sync, pilih semua entity yang diperlukan untuk disinkronkan, lalu klik Continue.

10. Pilih region untuk konektor data Anda dan masukkan nama untuk konektor data Anda.

11. Pilih frekuensi sinkronisasi.

Untuk mengelola status konektor, lakukan hal berikut:

1. Untuk jenis tujuan pribadi:

   1. Kirim detail konektor.
   2. VAIS mengirimkan permintaan koneksi ke PSC Anda.
   3. Buka konektor Anda untuk melihat pesan guna mengizinkan projectId di PSC.
   4. Izinkan koneksi di PSC:
      1. Konektor tetap dalam status Error hingga Anda menyetujui permintaan.
      2. Setelah disetujui, konektor akan berpindah ke status Aktif selama sinkronisasi berikutnya berjalan.
   5. Jika PSC Anda dikonfigurasi untuk menerima semua koneksi, konektor akan otomatis berpindah ke status Aktif setelah dibuat.

2. Untuk jenis tujuan publik:

   1. Kirim detail konektor.
   2. Konektor akan otomatis memasuki status Aktif setelah dikirim.

Untuk memverifikasi status penyimpanan data dan aktivitas penyerapan, lakukan tindakan berikut:

1. Buka konektor di daftar penyimpanan data dan pantau statusnya hingga berubah menjadi Aktif.
2. Setelah status konektor berubah menjadi Aktif, klik entitas yang diperlukan dan konfirmasi bahwa semua entitas yang dipilih telah diserap. Status penyimpanan data bertransisi dari Membuat menjadi Berjalan saat sinkronisasi dimulai dan berubah menjadi Aktif setelah penyerapan selesai, yang menunjukkan bahwa penyimpanan data telah disiapkan. Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.
• Lihat Mempratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan SharePoint Online

Gunakan prosedur berikut untuk menyinkronkan data dari SharePoint Online ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

2. Berikan izin administrator. Untuk mengetahui informasi tentang cara memberikan izin, lihat Memberikan izin administrator seluruh tenant ke aplikasi dalam dokumentasi Microsoft Entra.

3. Siapkan informasi autentikasi Sharepoint Online berikut untuk digunakan selama penyiapan:

   1. URL instance. Dalam bentuk http://DOMAIN_OR_SERVER/[sites/]WEBSITE.

   2. Autentikasi gabungan memerlukan ID tenant dan client ID, sedangkan OAuth memerlukan ID tenant, client ID, dan secret klien. Untuk mendaftarkan aplikasi, pilih Accounts in this organizational directory only untuk audiens login, lalu temukan informasi autentikasi ini. Untuk mengetahui informasi selengkapnya, lihat Panduan memulai: Mendaftarkan aplikasi dengan platform identitas Microsoft dalam dokumentasi Microsoft Entra.

   3. Saat mendaftarkan aplikasi, gunakan https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html sebagai URL callback web.

   4. Saat mengonfigurasi izin aplikasi, tambahkan izin aplikasi berikut untuk Graph API:

      Melihat cakupan

      • GroupMember.Read.All
      • Sites.FullControl.All
      • User.Read.All

   5. Saat mengonfigurasi izin aplikasi, tambahkan izin yang didelegasikan berikut untuk Sharepoint REST API:

      Melihat cakupan

      • AllSites.FullControl

4. Tabel berikut menjelaskan peran yang direkomendasikan untuk konfigurasi dan batasannya.

Melihat peran

Peran	Pendaftaran aplikasi klien	Mengambil konten semua entity	Mengambil ACL	Mengambil identitas	Catatan
Admin Situs	Tidak	Ya	Ya	Ya
Administrator Koleksi Situs	Tidak	Ya	Ya	Ya
Administrator global	Ya	Tidak	Ya	Tidak	Batasan: Administrator global tidak dapat mengambil entitas identitas atau komentar dan lampiran.
Pemilik situs	Tidak	Ya	Ya	Tidak	Batasan: Pemilik situs terkait dengan pusat administrator Microsoft 365 / pusat administrator Entra, bukan khusus untuk SharePoint.
Administrator aplikasi	Ya	T/A	T/A	T/A	Peran administrator aplikasi terkait dengan pusat administrator Microsoft 365 / pusat administrator Entra. Hal ini tidak hanya berlaku untuk Sharepoint.

Gunakan metode ini untuk kontrol terperinci atas izin SharePoint REST API, yang memungkinkan Anda membatasi akses resource di akun pengguna. Pastikan untuk membuat pengguna SharePoint baru, yang mungkin akan menambah biaya pemberian lisensi. Gunakan metode token refresh OAuth 2.0 untuk menyiapkan pendaftaran aplikasi Entra dan mengaktifkan akses aman ke SharePoint.

Mengonfigurasi pendaftaran aplikasi Entra

Siapkan pendaftaran aplikasi Entra untuk mengaktifkan akses aman ke SharePoint. Pilih antara Kredensial gabungan untuk akses berbasis token atau Token refresh OAuth 2.0 untuk kontrol terperinci. Gunakan langkah-langkah berikut untuk mengonfigurasi pendaftaran aplikasi, memberikan izin, dan membuat autentikasi.

1. Kredensial gabungan: Siapkan kredensial gabungan untuk mengizinkan Google mengakses SharePoint dengan aman menggunakan token yang ditandatangani secara kriptografis, sehingga tidak memerlukan akun utama pengguna yang sebenarnya. Untuk mengonfigurasi izin dan memberikan akses, lakukan hal berikut:

   1. Dapatkan client ID akun layanan:

      1. Di konsol Google Cloud, buka halaman Agent Builder.
      2. Di menu navigasi, klik Penyimpanan data.
      3. Klik Create data store.
      4. Di halaman Pilih sumber data, scroll atau telusuri SharePoint Online untuk menghubungkan sumber pihak ketiga Anda.
      5. Perhatikan ID subjek.

   2. Daftarkan aplikasi di Microsoft Entra:

      1. Buka Pusat administrator Entra.

      2. Buat pendaftaran aplikasi:

         • Jenis akun yang didukung: Akun di direktori organisasi saja.
         • Tetap gunakan setelan default lainnya, lalu klik Register.

      3. Catat Client ID dan Tenant ID.

   3. Tambahkan kredensial gabungan:

      1. Buka Certificates & secrets > Federated credentials > Add credential.

      2. Gunakan setelan berikut:

         • Penerbit: https://accounts.google.com
         • ID subjek: Gunakan ID subjek yang dicatat.
         • Name: Berikan nama unik.

      3. Klik Tambahkan untuk memberikan akses.

   4. Tetapkan izin API:

      1. Tambahkan dan berikan izin administrator untuk izin berikut:

         • GroupMember.Read.All (Aplikasi): Membaca semua keanggotaan grup.
         • Sites.Read.All (Aplikasi): Membaca semua situs.
         • User.Read.All (Aplikasi): Membaca semua profil lengkap pengguna.
         • Sites.FullControl.All (Aplikasi): Kontrol penuh atas semua situs.

      2. Gunakan Sites.Selected untuk menetapkan izin situs tertentu, bukan Sites.FullControl.All. Sites.Selected tidak dapat dikonfigurasi langsung melalui UI. Setelah memilih Sites.Selected, Anda harus memanggil Microsoft Graph API untuk secara eksplisit memberikan peran fullcontrol ke aplikasi untuk situs yang ingin Anda crawl.

      3. Berikan Sites.Read.All untuk meng-crawl semua sub-situs di bawah URL situs root.

2. Token refresh OAuth 2.0: Konfigurasikan autentikasi OAuth 2.0 menggunakan rahasia klien dan token refresh dari pengguna SharePoint untuk mengaktifkan kontrol terperinci atas akses SharePoint API. Untuk menyiapkan pendaftaran aplikasi, menambahkan secret klien, dan menetapkan izin API, lakukan hal berikut:

   1. Membuat pendaftaran aplikasi:

      1. Buka Pusat administrator Entra.

      2. Buat pendaftaran aplikasi:

         • Jenis akun yang didukung: Akun di direktori organisasi saja.
         • URI Pengalihan: https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html.

      3. Catat Client ID dan Tenant ID.

   2. Tambahkan rahasia klien:

      1. Buka Certificates & secrets > New client secret.

      2. Perhatikan string rahasia.

   3. Tetapkan izin API:

      1. Tambahkan dan berikan izin administrator untuk izin berikut:

         • GroupMember.Read.All: Membaca semua keanggotaan grup.
         • Sites.FullControl.All: Kontrol penuh atas semua koleksi situs.
         • User.Read.All: Membaca profil lengkap semua pengguna.
         • AllSites.FullControl: Kontrol penuh atas semua situs.

      2. Gunakan akun pengguna khusus dengan akses terbatas ke situs tertentu.

      3. Pastikan akun memiliki akses Pemilik ke situs yang dipilih.

Membuat konektor SharePoint Online

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Sharepoint Online ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri SharePoint Online untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Sharepoint Online Anda, lalu klik Autentikasi.

6. Masukkan URL situs SharePoint:

   • Untuk satu situs: https://<domain_name>.sharepoint.com/sites/<site_name>.
   • Untuk semua situs tingkat pertama: https://<domain_name>.sharepoint.com.

7. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

8. Pilih region untuk penyimpanan data Anda.

9. Masukkan nama untuk penyimpanan data Anda.

10. Pilih frekuensi sinkronisasi untuk penyimpanan data Anda.

11. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

12. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses penyerapan dapat memerlukan waktu beberapa menit atau jam.

Menguji mesin telusur

Setelah mengonfigurasi mesin telusur, uji kemampuannya. Hal ini memastikannya menampilkan hasil yang akurat berdasarkan akses pengguna.

1. Mengaktifkan aplikasi web:

   1. Buka konfigurasi integrasi aplikasi dan alihkan ke Aktifkan aplikasi web.

2. Menguji aplikasi web:

   1. Klik Buka di samping link aplikasi web dan login dengan pengguna di kumpulan tenaga kerja Anda.

   2. Verifikasi bahwa hasil penelusuran dibatasi untuk item yang dapat diakses oleh pengguna yang login.

Catatan: Jika Anda mengalami masalah saat login dengan Microsoft ID, pastikan pengguna ditambahkan ke pengguna aplikasi Enterprise di Microsoft Entra.

Mengonfigurasi kumpulan tenaga kerja

Dengan kumpulan tenaga kerja, Anda dapat mengelola dan mengautentikasi pengguna dari penyedia identitas eksternal, seperti Azure atau Okta, dalam konsol Google Cloud. Untuk mengonfigurasi kumpulan tenaga kerja dan mengaktifkan aplikasi web agar akses pengguna lancar, lakukan hal berikut:

1. Buat kumpulan tenaga kerja di tingkat organisasi di Google Cloud dengan mengikuti panduan penyiapan yang sesuai:

   1. Penyiapan OIDC Azure
   2. Penyiapan SAML Azure
   3. Penyiapan Okta & OIDC
   4. Penyiapan Okta & SAML

2. Konfigurasikan kumpulan tenaga kerja di Agent Builder > Settings untuk wilayah tempat Anda membuat aplikasi.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Lihat Mempratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Slack

Gunakan prosedur berikut untuk menyinkronkan data dari Slack ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Siapkan kontrol akses untuk sumber data Anda. Untuk informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

2. Hubungi pemilik ruang kerja untuk memberikan izin menginstal aplikasi baru di ruang kerja Anda.

3. Siapkan informasi autentikasi Slack berikut:

   1. ID Ruang Kerja: Dapatkan ID Ruang Kerja dengan mengikuti petunjuk di Menentukan sumber Slack untuk penyimpanan data Anda dalam dokumentasi Slack.

   2. Token akses: Buat aplikasi klien dan tentukan cakupan yang diperlukan. Untuk informasi selengkapnya, lihat Panduan memulai dan Cara mendapatkan dan menggunakan token Slack API dengan cepat dalam dokumentasi Slack.

   3. Saat menetapkan cakupan izin OAuth 2.0, konfigurasikan cakupan berikut:

      Melihat cakupan

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • team:read
      • users:read
      • files:read

4. Secara default, Slack membatasi crawling dan sinkronisasi konten dari channel pribadi, pesan grup, dan pesan langsung.

Mengonfigurasi aplikasi Slack

Dapatkan token akses untuk mengizinkan Vertex AI Search menyerap dokumen dari ruang kerja Slack Anda.

Catatan: Buat aplikasi Slack dan pilih antara bot (buat token bot) atau token pengguna (buat token pengguna) berdasarkan persyaratan Anda.

1. Buat token bot untuk mengakses channel pribadi, pesan instan (IM), dan pesan instan multi-pihak (MPIM) dengan aman. Token bot tidak dapat meng-crawl ke channel publik yang bukan bagiannya, dan bergabung ke channel publik akan menghasilkan pesan bergabung.

   1. Login ke Aplikasi Slack API.
   2. Klik Create new app.
   3. Pilih Dari awal.
   4. Masukkan nama untuk aplikasi Anda dan pilih ruang kerja untuk integrasi.
   5. Klik Create app.
   6. Klik OAuth & izin.
   7. Di bagian Cakupan token bot, tambahkan cakupan yang diperlukan berikut:

      Melihat cakupan

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • team:read
      • users:read
      • files:read

   Secara default, bot membaca dari saluran #general dan #random.

   1. Untuk mengaktifkan crawling, lakukan tindakan berikut:

      1. Untuk channel publik, berikan cakupan channels:join untuk mengizinkan bot bergabung secara otomatis.
      2. Untuk channel pribadi, undang bot secara manual.

   2. Klik Instal ke ruang kerja nama pengguna Anda.

   3. Ikuti petunjuk di layar untuk menginstal aplikasi dan mengambil token bot.

2. Buat token pengguna untuk mengakses semua saluran publik tanpa bergabung terlebih dahulu. Token pengguna tidak dapat meng-crawl saluran pribadi, IM, atau MPIM kecuali jika pengguna memiliki akses.

   1. Login ke Aplikasi Slack API.
   2. Klik Create new app.
   3. Pilih Dari awal.
   4. Masukkan nama untuk aplikasi Anda dan pilih ruang kerja untuk integrasi.
   5. Klik Create app.
   6. Klik OAuth & izin.

   7. Di bagian Cakupan token pengguna, tambahkan cakupan yang diperlukan berikut:

      Melihat cakupan

      • users:read.email
      • channels:history
      • channels:read
      • groups:history
      • groups:read
      • im:history
      • im:read
      • mpim:history
      • mpim:read
      • users:read
      • files:read

   8. Klik Instal ke ruang kerja nama pengguna Anda.

   9. Ikuti petunjuk di layar untuk menginstal aplikasi dan mengambil token pengguna.

Membuat konektor Slack Cloud

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Slack ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Slack untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Slack Anda.

   • Instance ID (ID Ruang Kerja): Dapatkan dari ruang kerja Slack Anda dengan login melalui browser. ID ruang kerja adalah segmen setelah /client di URL.
   • Token autentikasi: Gunakan token yang diperoleh dari bagian sebelumnya.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk penyimpanan data Anda.

9. Pilih frekuensi sinkronisasi untuk penyimpanan data Anda.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama penyimpanan data untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

• Untuk melampirkan penyimpanan data ke aplikasi, buat aplikasi dan pilih penyimpanan data Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Lihat Mempratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Trello

Gunakan prosedur berikut untuk menyinkronkan data dari Trello ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Perhatian: Konektor ini memberikan dukungan ACL sebagian. Selama pratinjau pribadi, domain pengguna diverifikasi, tetapi verifikasi pengguna terperinci tidak didukung.

Perhatian: Konektor ini memberikan dukungan ACL sebagian. Selama pratinjau pribadi, domain pengguna diverifikasi, tetapi verifikasi pengguna terperinci tidak didukung.

Sebelum memulai

Sebelum menyiapkan konektor, pastikan langkah-langkah berikut telah selesai:

1. Pastikan Anda memiliki akses administrator Trello. Administrator Trello harus membuat kunci dan token API di bagian berikut.
2. Pastikan project Anda ditambahkan ke daftar yang diizinkan untuk menggunakan Trello.
3. Siapkan kontrol akses untuk sumber data Anda. Untuk informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

Administrator Trello harus melakukan langkah-langkah berikut:

1. Buat kunci API di Trello:

   1. Login ke instance Trello menggunakan kredensial pengguna pengujian yang disediakan di Trello.

   2. Di halaman Admin Power-up Trello, buka Akses Admin Power-up.

   3. Klik Baru untuk membuat Power-up baru.

   4. Isi detail yang diperlukan:

      Catatan: URL konektor iframe hanya diperlukan jika Anda ingin membuat Power-up. Jika tidak, kosongkan kolom ini.

   5. Klik Berikutnya untuk melanjutkan, lalu buat kunci API. Salin kunci API dan secret.

2. Buat token API di Trello:

   1. Klik link Buat token di sebelah kanan untuk membuat Token API.

      1. Klik Izinkan untuk memberikan akses ke token API Anda.
      2. Pastikan semua entity yang diperlukan memiliki izin yang benar dalam cakupan.

   2. Salin token API yang dibuat. Gunakan token ini untuk konektor Trello di Vertex AI Search.

Untuk informasi selengkapnya tentang Trello API, lihat pengantar API.

Membuat konektor Trello

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Trello ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Trello untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Trello Anda, lalu klik Lanjutkan.

6. Opsional: Untuk merutekan traffic HTTP, klik Add destination dan masukkan nama host atau alamat IP server proxy. Kemudian, klik Lanjutkan.

7. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

8. Pilih region untuk penyimpanan data Anda.

9. Masukkan nama untuk konektor data Anda.

10. Pilih frekuensi sinkronisasi.

11. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

12. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan WordPress

Gunakan prosedur berikut untuk menyinkronkan data dari WordPress ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Perhatian: Kontrol akses untuk WordPress tidak didukung.

Sebelum memulai

Sebelum menyiapkan koneksi, pastikan Anda memiliki hal berikut:

• Nama pengguna dan sandi: Dapatkan kredensial dari administrator WordPress.
• URL Situs: Gunakan URL ini untuk pembuatan penyimpanan data.

Membuat pengguna WordPress

Untuk membuat pengguna WordPress, dapatkan nama pengguna dan sandi dari administrator. Administrator harus login dan mengikuti langkah-langkah berikut untuk membuat pengguna baru di WordPress.

1. Login sebagai administrator:

   1. Buka platform hosting Anda dan login dengan kredensial administrator untuk mengakses situs WordPress.
   2. Klik ikon Situs.
   3. Klik WordPress admin untuk situs Anda.

2. Buat pengguna baru:

   1. Di halaman admin WordPress, buka tab Pengguna.
   2. Klik Tambahkan baru.
   3. Isi semua detail yang diperlukan, termasuk:
      • Nama pengguna
      • Alamat email
      • Opsional: Nama depan dan nama belakang
      • Peran
      • Sandi (jika diminta)
   4. Klik Tambahkan pengguna baru untuk menyimpan perubahan.

Membuat konektor WordPress

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari WordPress ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Buat penyimpanan data.

4. Di halaman Pilih sumber data, scroll atau telusuri WordPress untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi WordPress Anda, lalu klik Lanjutkan.

6. Di kolom URL, masukkan URL situs WordPress Anda, lalu klik Lanjutkan.

7. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

8. Pilih region untuk penyimpanan data Anda.

9. Masukkan nama untuk konektor data Anda.

10. Pilih frekuensi sinkronisasi.

11. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

12. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Workday

Gunakan prosedur berikut untuk menyinkronkan data dari Workday ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Perhatian: Kontrol akses untuk Workday tidak didukung.

Sebelum memulai

Sebelum membuat konektor Workday:

1. Administrator Workday harus membuat atau mendapatkan hal berikut untuk berintegrasi dengan Vertex AI Search:

   1. Client-ID. Dapatkan dari halaman Lihat Klien API di Workday.
   2. Rahasia klien. Dapatkan dari halaman Lihat Klien API di Workday.
   3. Token refresh. Dapatkan dari halaman Lihat Klien API di Workday.
   4. Opsional: Server Proxy. Nama host atau alamat IP proxy untuk merutekan traffic HTTP.
   5. Opsional: URL dasar. URL dasar untuk koneksi Workday.
   6. Opsional: URL API. URL lengkap ke endpoint API yang akan digunakan untuk membuat permintaan SOAP. Contoh: https://<var>host</var>.workday.com/ccx/service/<var>tenant</var>/<var>service</var>
   7. Tenant Workday. Tenant untuk akun. Misalnya, abc_cms1. Anda bisa mendapatkan nama tenant di detail konfigurasi instance Workday.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

Membuat konektor Workday

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Workday ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Workday untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Workday Anda, lalu klik Lanjutkan.

6. Opsional: Masukkan informasi tujuan Workday Anda, lalu klik Lanjutkan.

7. Masukkan tenant Workday Anda, lalu klik Lanjutkan.

8. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

9. Pilih region untuk penyimpanan data Anda.

10. Masukkan nama untuk konektor data Anda.

11. Pilih frekuensi sinkronisasi.

12. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

13. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Zendesk

Gunakan prosedur berikut untuk menyinkronkan data dari Zendesk ke Vertex AI Search.

Pratinjau: Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan konektor pihak ketiga.

Setelah Anda menyiapkan sumber data dan mengimpor data untuk pertama kalinya, penyimpanan data akan menyinkronkan data dari sumber tersebut dengan frekuensi yang Anda pilih selama penyiapan.

Sebelum memulai

Sebelum menyiapkan koneksi:

1. Selain daftar yang diizinkan konektor pihak ketiga, konektor ini mengharuskan project Anda ditambahkan ke daftar yang diizinkan tambahan. Untuk ditambahkan ke daftar yang diizinkan ini, hubungi tim akun Vertex AI Search Anda.

2. Siapkan kontrol akses untuk sumber data Anda. Untuk mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

3. Administrator Zendesk harus membuat atau mendapatkan hal berikut untuk berintegrasi dengan Vertex AI Search:

   1. Token akses. Token API instance Zendesk Anda.
   2. URI instance.

Membuat konektor Zendesk

Konsol

Untuk menggunakan konsol Google Cloud guna menyinkronkan data dari Zendesk ke Vertex AI Search, ikuti langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Agent Builder.

   Agent Builder

2. Di menu navigasi, klik Penyimpanan data.

3. Klik Create data store.

4. Di halaman Pilih sumber data, scroll atau telusuri Zendesk untuk menghubungkan sumber pihak ketiga Anda.

5. Masukkan informasi autentikasi Zendesk Anda, lalu klik Lanjutkan.

6. Pilih entitas yang akan disinkronkan, lalu klik Lanjutkan.

7. Pilih region untuk penyimpanan data Anda.

8. Masukkan nama untuk konektor data Anda.

9. Pilih frekuensi sinkronisasi.

10. Klik Buat. Vertex AI Search membuat penyimpanan data dan menampilkan penyimpanan data Anda di halaman Penyimpanan data.

11. Untuk memeriksa status penyerapan, buka halaman Penyimpanan data dan klik nama konektor untuk melihat detailnya di halaman Data. Status konektor berubah dari Membuat menjadi Berjalan saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Aktif untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, proses transfer dapat memerlukan waktu beberapa menit atau beberapa jam.

Langkah berikutnya

• Untuk melampirkan konektor ke aplikasi, buat aplikasi dan pilih konektor Anda dengan mengikuti langkah-langkah di Membuat aplikasi penelusuran.

• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi disiapkan, lihat Mendapatkan hasil penelusuran. Jika Anda menggunakan kontrol akses pihak ketiga, lihat Melihat pratinjau hasil untuk aplikasi dengan kontrol akses pihak ketiga.