Menghubungkan sumber data pihak ketiga

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

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

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

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:

  • 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 penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

Menghubungkan Jira Cloud

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

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

  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:

    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 penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

Menghubungkan Salesforce

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

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 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: Nama domain instance Salesforce Anda. Telusuri My domain, salin domain yang diakhiri dengan my.salesforce.com, lalu tambahkan https:// di awal.
    • Client ID: Salin client ID dari aplikasi yang terhubung dengan mengklik Kelola detail pelanggan. Jika token refresh diaktifkan, pastikan token diperbarui dan berikan token terbaru saat membuat penyimpanan data.
    • Rahasia klien: Salin rahasia klien dari aplikasi yang terhubung dengan mengklik Kelola detail pelanggan. Jika token refresh diaktifkan, pastikan token diperbarui dan berikan token terbaru saat membuat penyimpanan data.
  • Agar izin pengguna diterapkan dengan benar, pengguna Salesforce harus memberikan izin berbagi.

  • Menggunakan paket Enterprise atau Developer. Akun uji coba tidak didukung.

  • Pastikan Anda menggunakan Sales Cloud. Service Cloud tidak didukung.

  • Tambahkan Google Cloud ke daftar yang diizinkan CORS Salesforce. Jika Anda telah menyelesaikan tugas ini, buka bagian Membuat aplikasi.

Buat aplikasi

Salesforce mendukung aplikasi berikut:

  1. Aplikasi terhubung.
  2. Aplikasi klien eksternal.

Membuat aplikasi terhubung

Untuk menyiapkan aplikasi terhubung di Salesforce untuk integrasi dengan Google Cloud, lakukan hal berikut:

  1. Login ke Salesforce.
  2. Klik ikon roda gigi, lalu buka Penyiapan.
  3. Di bagian menu Penyiapan, buka Pengelola aplikasi.
  4. Klik Aplikasi terhubung baru.
  5. Untuk mengonfigurasi aplikasi terhubung:

    a. Di halaman pembuatan aplikasi terhubung, lakukan hal berikut:

    • Centang Aktifkan setelan OAuth.
    • Tetapkan URL callback ke: https://vertexaisearch.cloud.google.com/console/oauth/salesforce_oauth.html.
    • Pilih cakupan OAuth berikut:
      • Akses Lengkap (full).
      • Menjalankan permintaan kapan saja (refresh_token, offline_access).

    b. Aktifkan alur:

    • Alur kredensial klien.
    • Alur kredensial dan kode otorisasi.
    • Kredensial pengguna dalam isi POST untuk alur kredensial dan kode otorisasi.
    • Untuk Alur kredensial klien, tetapkan nama pengguna Anda di kolom Jalankan sebagai. Anda harus memiliki izin baca ke semua entitas yang dapat diekstrak oleh konektor.

Setelah membuat aplikasi terhubung, lakukan hal berikut:

  1. Mengedit kebijakan aplikasi:

    • Buka App Manager dan edit aplikasi yang baru dibuat.
    • Tetapkan IP Relaxation ke Relax IP restrictions.
    • Konfigurasikan Kebijakan Token Refresh ke Valid until revoked atau setelan yang lebih ketat sesuai kebutuhan.
    • Pastikan Pengguna yang Diizinkan ditetapkan ke All users may self-authorize.
  2. Konfigurasikan batasan IP:

    • Jika Penerapan rentang IP tingkat organisasi diaktifkan, tetapkan Rentang IP Tepercaya di bagian Keamanan > Akses Jaringan. Untuk informasi selengkapnya, lihat dokumentasi Penerapan IP berkelanjutan dan pelonggaran IP aplikasi terhubung.
    • Nonaktifkan Terapkan rentang IP login pada setiap permintaan jika tidak ada batasan IP yang diperlukan.
  3. Konfigurasikan aplikasi terhubung OAuth:

  4. Simpan aplikasi yang terhubung:

    • Simpan dan keluar dari aplikasi yang terhubung.
    • Di kotak penelusuran, telusuri Setelan OAuth dan OpenId Connect.
    • Aktifkan Izinkan alur kredensial dan kode otorisasi serta Alur nama pengguna-sandi OAuth.

Membuat aplikasi klien eksternal

Untuk membuat dan mengonfigurasi aplikasi klien eksternal di Salesforce guna mengaktifkan autentikasi berbasis OAuth untuk integrasi, lakukan hal berikut:

  1. Dapatkan client ID dan rahasia klien:

    • Login ke Salesforce.
    • Klik ikon roda gigi, lalu buka Penyiapan.
    • Buka Penyiapan > Aplikasi > Aplikasi klien eksternal.
    • Klik Aplikasi klien eksternal baru.
  2. Berikan informasi yang diperlukan:

    • Masukkan nama aplikasi dan alamat email Anda. Nama API akan otomatis diisi secara default.
    • Biarkan Distribution state sebagai Local.
  3. Aktifkan setelan OAuth:

    • Luaskan API (Aktifkan Setelan OAuth), lalu pilih Aktifkan OAuth.
    • Konfigurasi:
      • URL Callback: https://login.salesforce.com/services/oauth2/callback
      • Cakupan OAuth: Mengelola data pengguna melalui API (api).
      • Di Flow enablement, pilih Enable client credentials flow.
      • Klik Buat untuk membuat Aplikasi klien eksternal. Buka pengelola Aplikasi klien eksternal untuk melihat aplikasi yang Anda tambahkan ke daftar.
  4. Mengedit kebijakan aplikasi:

    • Buka aplikasi yang dibuat.
    • Buka Kebijakan, lalu klik Edit.
    • Di Alur OAuth dan peningkatan aplikasi klien eksternal, centang Aktifkan alur kredensial klien.
    • Masukkan nama pengguna Salesforce Anda di kolom Jalankan sebagai.
  5. Akses kredensial OAuth:

    • Klik Setelan.
    • Klik Setelan OAuth.
    • Klik Kunci dan rahasia konsumen untuk mengakses kredensial. Kode verifikasi dikirim ke alamat email Anda.
    • Masukkan kode verifikasi, lalu klik Verifikasi.
    • Salin Kunci konsumen dan gunakan sebagai client ID.
    • Salin Rahasia konsumen dan gunakan sebagai rahasia klien.

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 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 penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

Menghubungkan ServiceNow

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

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:

        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 penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

Menghubungkan Sharepoint Online

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

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:

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

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

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 penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

Menghubungkan Slack

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

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.

  • Hubungi pemilik Workspace untuk memberikan izin guna menginstal aplikasi baru di ruang kerja Anda.

  • Siapkan informasi autentikasi Slack berikut:

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

Membuat token bot

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 & Permissions.
  7. Di bagian Cakupan token bot, tambahkan cakupan yang diperlukan berikut:

    Secara default, bot membaca dari saluran #general dan #random. Untuk mengaktifkan crawling, lakukan hal berikut:

    • Untuk channel publik, berikan cakupan channels:join untuk mengizinkan bot bergabung secara otomatis.
    • Untuk channel pribadi, undang bot secara manual.
  8. Klik Instal ke ruang kerja nama pengguna Anda.

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

Membuat token pengguna

Buat token pengguna untuk mengakses semua channel publik tanpa bergabung terlebih dahulu. Token pengguna tidak dapat meng-crawl saluran, IM, atau MPIM pribadi 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 & Permissions.
  7. Di bagian Cakupan token pengguna, tambahkan cakupan yang diperlukan berikut:

  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 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 penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

Menghubungkan Dropbox

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

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 penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

Connect Box

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

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:

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

Membuat aplikasi Box

  1. Login ke Konsol Developer Box dengan akun administrator Anda.
  2. Klik Create new app.
  3. Pilih jenis Aplikasi kustom.
  4. Masukkan Nama aplikasi.
  5. Tetapkan Tujuan aplikasi: Integrasi, AI, atau Google Cloud Agent Builder.
  6. Pilih Server authentication with JWT.

Mengonfigurasi aplikasi Box

Konfigurasikan setelan untuk aplikasi Box Anda.

Membuat kunci publik/pribadi

  1. Buka Box Developer Console.
  2. Di tab Configuration, klik Generate a Public/Private Keypair.

    • Kunci publik akan otomatis diupload ke konsol dengan ID. ID ini digunakan saat membuat koneksi.
    • File konfigurasi dengan kunci pribadi dan frasa sandi dapat didownload secara lokal. Pastikan untuk menyimpan file konfigurasi ini untuk digunakan nanti.
    • Atau, untuk membuat kunci Anda sendiri, lihat panduan penyiapan pasangan kunci Box.

Mengonfigurasi izin yang diperlukan

  1. Di bagian Application scopes, pilih izin berikut:
    • Membaca semua file dan folder yang disimpan di Box.

Memberi otorisasi aplikasi

  1. Di tab Authorization, klik Review and submit, lalu tunggu persetujuan dari administrator Anda.
  2. Administrator dapat menyetujui aplikasi di Konsol Admin.

Setelah otorisasi, Box akan menyiapkan aplikasi sepenuhnya.

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

  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 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 penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya

Menghubungkan OneDrive

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

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:

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 penyerapan dapat memerlukan waktu beberapa menit atau jam.

Langkah berikutnya