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: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 Confluence Cloud
   • Menghubungkan Jira Cloud
   • Menghubungkan Salesforce
   • Menghubungkan ServiceNow
   • Menghubungkan SharePoint Online
   • Menghubungkan Slack
   • Menghubungkan Dropbox
   • Kotak Connect
   • Menghubungkan OneDrive

Menghubungkan Confluence Cloud

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

Pratinjau: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 menyiapkan koneksi:

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

• Siapkan informasi autentikasi berikut:

  • URL instance. Dalam bentuk https://EXAMPLE.atlassian.net—misalnya, https://google.atlassian.net.

  • ID instance. Ini adalah cloudid dan dapat ditemukan dengan membuka https://EXAMPLE.atlassian.net/_edge/tenant_info dan menyalin nilai cloudId.

• Aktifkan OAuth 2.0 dan dapatkan client ID dan secret klien.

  Gunakan https://vertexaisearch.cloud.google.com/console/oauth/confluence_oauth.html sebagai URL callback. Untuk informasi tentang cara mengaktifkan OAuth 2.0 untuk Confluence Cloud dan mendapatkan client ID serta secret klien, lihat aplikasi OAuth 2.0 (3LO) dalam dokumentasi Developer Atlassian.

• Saat menetapkan cakupan izin OAuth 2.0, konfigurasikan cakupan berikut:

  Melihat cakupan

  • read:attachment:confluence
  • read:configuration:confluence
  • read:content-details:confluence
  • read:content.metadata:confluence
  • read:group:confluence
  • read:space:confluence
  • read:user:confluence

• 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.

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 New data store.

4. Di halaman Select a data source, buka bagian Third-party sources, lalu pilih Confluence.

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 Create. 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 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 Hasil pratinjau untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Jira Cloud

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

Pratinjau: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 admin yang diperlukan ke instance Jira. Buat Client ID dan Client Secret melalui Atlassian Developer Console, konfigurasikan cakupan OAuth 2.0 yang diperlukan, dan siapkan izin untuk pengguna. Terakhir, 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) dalam dokumentasi Developer Atlassian.

1. Login ke developer.atlassian.com.
2. Klik ikon profil di sudut kanan atas, lalu pilih Developer Console.
3. Klik Create, lalu pilih OAuth 2.0 Integration.
4. Masukkan nama untuk aplikasi.
   • Centang kotak persyaratan dan ketentuan.
   • Klik Create.

5. Anda akan menemukan lima opsi: Ringkasan, Distribusi, Izin, Otorisasi, dan Setelan. Mulai dengan Otorisasi:

   a. Klik Authorization.

   b. Di tabel Jenis otorisasi, pilih Tambahkan untuk OAuth 2.0 (3LO).

6. Di kolom URL Callback, masukkan https://vertexaisearch.cloud.google.com/console/oauth/jira_oauth.html, lalu klik Simpan perubahan.

   CATATAN: Jika Anda melihat peringatan: Aplikasi Anda tidak memiliki API. Menambahkan API ke aplikasi Anda., hal ini akan dibahas di bagian berikutnya.

7. Pilih Izin:

   a. Buka Jira API, klik Tambahkan, lalu klik Konfigurasi.

   CATATAN: Saat Anda mengklik Tambahkan, tombol akan berubah menjadi Konfigurasi.

   b. 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

   Pastikan 7 cakupan dipilih, lalu simpan perubahan Anda.

8. Klik Distribusi, pilih Edit, lalu lakukan tindakan berikut:

   • Pilih tombol pilihan Berbagi terlebih dahulu untuk mengaktifkan pengeditan kolom lain.
   • Isi kolom yang tersisa.
   • Pilih Ya saat ditanya: Does your app store personal data?

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

Mengambil URL instance dan ID instance

Untuk mendapatkan URL instance:

1. Buka atlassian.net, lalu login dengan akun admin Anda.
2. Pilih aplikasi yang ingin Anda sinkronkan. Misalnya, sinkronkan aplikasi pertama.
3. Temukan URL instance, yang merupakan subdomain di kolom URL. Tampilannya akan terlihat seperti: Assign appropriate permissions.

Untuk mendapatkan 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 admin 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. Di bagian Akses produk grup pada halaman grup baru, klik Tambahkan produk ke grup.

6. Untuk Jira, pilih User access admin sebagai peran produk.

7. Untuk Jira Admin, pilih Product admin sebagai peran produk dan simpan perubahan Anda.

8. Di halaman Grup, klik Tambahkan anggota grup, lalu tambahkan pengguna atau akun yang akan diautentikasi oleh konektor.

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, buka bagian Sumber pihak ketiga, lalu pilih Jira.

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 Tentukan sumber Jira untuk penyimpanan data Anda.

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.

11. Klik Create. 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 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 Hasil pratinjau untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Salesforce

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

Pratinjau: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 menyiapkan koneksi:

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

• Siapkan informasi autentikasi berikut. Untuk informasi tentang cara menyiapkan ID dan secret konsumen 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:

• Untuk menyinkronkan pengguna sebagai entitas, pengguna harus memberikan izin berbagi.

Konsol

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

1. Tambahkan Google Cloud ke daftar yang diizinkan CORS Salesforce Anda. Jika Anda sudah melakukannya, lanjutkan ke langkah berikutnya.

   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.

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

   Agent Builder

3. Di menu navigasi, klik Penyimpanan Data.

4. Klik Create data store.

5. Di halaman Select a data source, buka bagian Third-party sources, lalu pilih Salesforce.

6. Masukkan informasi autentikasi Salesforce Anda.

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.

11. Klik Create. 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 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 Hasil pratinjau untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan ServiceNow

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

Pratinjau: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 menyiapkan koneksi:

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

• Siapkan informasi autentikasi berikut:

  • URL instance dalam bentuk https://<domain-name>.service-now.com/.
  • Client ID dan rahasia klien. Untuk mengetahui informasi tentang penyiapan endpoint dan cara mendapatkan client ID dan rahasia klien, lihat Membuat endpoint agar klien dapat mengakses instance dalam dokumentasi ServiceNow.

  • Nama pengguna dan sandi untuk salah satu jenis peran ServiceNow berikut:

    • Peran administrator. Lihat Peran sistem dasar dalam dokumentasi ServiceNow.

    • Peran ServiceNow kustom. Ini adalah alternatif penggunaan peran administrator. Untuk menggunakan peran ServiceNow kustom, buat aturan kontrol akses dengan kolom berikut:

      Melihat kolom

      • Jenis: record
      • Operasi: read
      • Nama (aturan kontrol akses terpisah diperlukan untuk setiap nama):
      • incident
      • sc_cat_item
      • kb_knowledge
      • kb_knowledge_base
      • kb_uc_can_read_mtom
      • kb_uc_can_contribute_mtom
      • sys_user_role
      • sys_user_has_role
      • sys_user_group
      • sys_user_grmember
      • Memerlukan peran: Nama peran khusus

      Untuk mengetahui informasi selengkapnya, lihat Membuat peran dan Membuat aturan ACL dalam dokumentasi 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 Select a data source, buka bagian Third-party sources, lalu pilih ServiceNow.

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 Create. 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 Hasil pratinjau untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Sharepoint Online

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

Pratinjau: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 menyiapkan koneksi:

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

• Berikan izin administrator. Untuk informasi tentang cara memberikan izin, lihat Memberikan izin admin seluruh tenant ke aplikasi dalam dokumentasi Microsoft.

• Siapkan informasi autentikasi Sharepoint Online berikut untuk digunakan selama penyiapan:

  • URL instance. Dalam bentuk http://DOMAIN_OR_SERVER/[sites/]WEBSITE. Untuk informasi selengkapnya tentang URL, lihat URL dan token di SharePoint dalam dokumentasi SharePoint.

  • Tenant ID, client ID, dan rahasia klien. Untuk mendaftarkan aplikasi, pilih Accounts in this organizational directory only untuk audiens login, lalu temukan informasi autentikasi ini. Untuk informasi selengkapnya, lihat Panduan memulai: Mendaftarkan aplikasi dengan platform identitas Microsoft dalam dokumentasi Microsoft.

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

  • Saat mengonfigurasi izin aplikasi, tambahkan izin aplikasi berikut untuk Graph API:

    Melihat cakupan

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

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

    Melihat cakupan

    • AllSites.FullControl

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

  Melihat peran

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

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, buka bagian Sumber pihak ketiga, lalu pilih Sharepoint Online.

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

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

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 Create. 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 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 Hasil pratinjau untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Slack

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

Pratinjau: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 menyiapkan koneksi:

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

• Siapkan informasi autentikasi Slack berikut:

  • ID Workspace. Untuk informasi tentang cara mendapatkan ID ruang kerja, lihat Menentukan sumber Slack untuk penyimpanan data Anda dalam dokumentasi Slack.
  • Token akses. Untuk informasi tentang cara membuat aplikasi klien dan menentukan cakupan, lihat Panduan memulai dan Cara mendapatkan dan menggunakan token Slack API dengan cepat dalam dokumentasi Slack.
  • 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

Batasan berikut berlaku:

• Perilaku default Slack membatasi crawling dan sinkronisasi konten dari saluran pribadi, pesan instan multipihak, dan pesan instan 1:1.

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, buka bagian Sumber pihak ketiga, lalu pilih Slack.

5. Masukkan informasi autentikasi Slack 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 Create. 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 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 Hasil pratinjau untuk aplikasi dengan kontrol akses pihak ketiga.

Menghubungkan Dropbox

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

Pratinjau: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 mengetahui informasi selengkapnya, lihat Menggunakan kontrol akses sumber data.

• Siapkan informasi autentikasi Dropbox berikut. Untuk informasi cara menyiapkan parameter ini, lihat Panduan OAuth di dokumentasi Dropbox.

  • ID Klien
  • Rahasia klien

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 Select a data source, buka bagian Third-party sources, lalu pilih Dropbox.

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 Create. 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 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 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.

Connect Box

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

Pratinjau: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

• Siapkan informasi autentikasi Box berikut. Untuk mengetahui informasi cara menyiapkan parameter ini, lihat JWT Auth dalam dokumentasi developer Box.

  • ID Perusahaan
  • ID Klien
  • Rahasia klien
  • ID kunci publik
  • Kunci pribadi
  • Frasa sandi

• Saat membuat endpoint JWT, konfigurasikan cakupan berikut:

  Melihat cakupan

  • root_readonly
  • root_readwrite
  • manage_managed_users
  • manage_app_users
  • manage_groups
  • manage_enterprise_properties
  • as_user
  • generate_access_token

Batasan berikut berlaku:

• Perubahan inkremental untuk komentar mungkin memerlukan waktu lebih lama untuk disinkronkan daripada interval frekuensi yang dikonfigurasi.
• Jika folder yang berisi entity disalin atau dipindahkan, perubahan inkremental mungkin memerlukan waktu lebih lama untuk disinkronkan daripada interval frekuensi yang dikonfigurasi.

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 Create data store.

4. Di halaman Pilih sumber data, buka bagian Sumber pihak ketiga, lalu pilih Box.

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 Create. 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 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 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 OneDrive

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

Pratinjau: Konektor pihak ketiga dalam pratinjau dengan daftar yang diizinkan. Anda harus tercantum dalam daftar yang diizinkan untuk menggunakan fitur ini.

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 mengetahui informasi tentang cara menyiapkan kontrol akses, lihat Menggunakan kontrol akses sumber data.

• Siapkan informasi autentikasi OneDrive berikut:

  • 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.

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

    Konfigurasikan cakupan berikut:

    Melihat cakupan

    • Files.Read.All Application
    • Group.Read.All Application
    • Sites.FullControl.All Application
    • User.Read Delegated
    • User.Read.All Application

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, buka bagian Sumber pihak ketiga, lalu pilih OneDrive.

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 Create. 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 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 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.