Connect Box

Halaman ini menjelaskan cara menghubungkan Box ke Gemini Enterprise. Konektor ini mendukung penyerapan data dan penelusuran gabungan. Lihat bagian untuk mengetahui pendekatan yang ingin Anda gunakan:

• Menghubungkan Box (penyerapan data)
• Menghubungkan Penelusuran Gabungan dengan Box

Menghubungkan Box (penyerapan data)

Pratinjau: Anda harus berada dalam daftar yang diizinkan untuk menghubungkan sumber data Box menggunakan penyerapan data.

Gunakan prosedur berikut untuk menyinkronkan data dari Box ke Gemini Enterprise.

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 Anda:

1. Anda harus memiliki akses administrator ke instance Box, dengan autentikasi dua faktor 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 di 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 App type sebagai Custom app.
4. Masukkan App name.
5. Tetapkan properti berikut:
   1. Purpose: Integration
   2. Categories: AI
   3. External system: Google Cloud Gemini Enterprise

6. Pilih Authentication method sebagai Server authentication (with JWT).

   

   Pilih Autentikasi server (dengan JWT).

7. Klik Create app.

Mengonfigurasi aplikasi Box

1. Di Konsol Developer Box, pilih Platform app , lalu buka tab Configuration.

2. Di bagian App access level, pilih App + Enterprise access.

   Catatan: App + Enterprise access diperlukan untuk mengambil file, komentar, dan tugas dari akun pengguna individual. Selain itu, tingkat akses ini diperlukan untuk fungsi sinkronisasi inkremental. Stream peristiwa Enterprise mengandalkan tingkat ini untuk mengidentifikasi dan mengambil file, komentar, dan tugas baru serta yang diubah secara efisien.

3. Di bagian Application scopes, pilih cakupan berikut:

   1. Read all files and folders stored in Box diperlukan untuk mengambil komentar dan tugas serta untuk melihat pratinjau file, meskipun tidak cukup untuk mendownload file.

   2. Write all files and folders stored in Box diperlukan untuk mendownload file, dan memilihnya akan otomatis memberikan akses Read all files ; meskipun cakupan ini luas dan secara teknis memungkinkan pembuatan dan pengubahan file, cakupan ini hanya digunakan untuk mendownload file.

   3. Manage users diperlukan untuk mengambil daftar pengguna, yang memungkinkan pengambilan file, komentar, dan tugas dari akun pengguna individual.

   4. Manage groups juga diperlukan untuk mengambil daftar grup dan anggotanya; hal ini penting untuk kontrol akses, karena item yang dibagikan dengan grup Box harus memiliki anggota yang diidentifikasi.

   5. Kelola properti perusahaan adalah cakupan yang diperlukan untuk fungsi sinkronisasi inkremental, karena cakupan ini memfasilitasi penggunaan stream peristiwa Enterprise untuk melacak perubahan.

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

   Catatan: Make API calls using the as-user header diperlukan untuk mengambil file, komentar, dan tugas dari akun pengguna individual. Fitur ini sangat penting karena akun layanan administrator tidak secara inheren memiliki akses ke semua file milik pengguna; Header as-user memungkinkan sistem membuat permintaan API sebagai pengguna tertentu untuk mengakses datanya. Memilih opsi ini otomatis memberikan akses Manage users.

   

   Mengonfigurasi aplikasi Box.

5. Di bagian Add and manage public keys, klik Generate a public/private keypair.

   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 sandi. Pastikan untuk menyimpan file ini untuk digunakan nanti.

   3. Secara opsional, untuk membuat kunci Anda sendiri, lihat panduan penyiapan pasangan kunci Box.

      

      Mengelola kunci.

6. Klik Save changes.

Memberikan otorisasi aplikasi Box

1. Di Konsol Developer Box, pilih Platform app , lalu buka tab Authorization.
2. Klik Review and submit.

3. Di dialog Review app authorization submission, klik Submit.

   

   Memberikan otorisasi aplikasi Box.

   Jika permintaan otorisasi berhasil dikirim, pesan konfirmasi berikut akan ditampilkan:

   

   Permintaan otorisasi berhasil dikirim.

4. Login ke Pengelola aplikasi platform admin Boxdengan akun administrator Anda.

5. Pilih Platform app yang telah Anda konfigurasi.

6. Klik tiga titik (...) di baris yang sesuai.

7. Pilih Authorize app dari daftar drop-down.

8. Di dialog Authorize app, klik Authorize untuk menyelesaikan proses otorisasi.

   

   Klik Otorisasi.

Siapkan informasi autentikasi Box berikut:

• Enterprise ID: Dapatkan dari tab General settings.

  

  Mendapatkan Enterprise ID.

• Client ID dan Client secret: Dapatkan dari tab Configuration di bagian OAuth 2.0 credentials.

  

  Mendapatkan konfigurasi klien.

• Private key, Key ID, dan Passphrase: Parameter ini telah dibuat dan didownload ke file lokal dari tab Configuration di bagian Add and manage public keys saat mengonfigurasi aplikasi.

  

  Menambahkan dan mengelola kunci publik.

Membuat konektor Box

Konsol

Untuk menggunakan Google Cloud konsol guna menyinkronkan data dari Box ke Gemini Enterprise, ikuti langkah-langkah berikut:

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

   Gemini Enterprise

2. Di menu navigasi, klik Data Stores.

3. Klik Create Data Store.

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

5. Masukkan informasi autentikasi Anda di Authentication settings. Di kolom Private key, salin dan tempel nilai kunci pribadi berikut.

    -----BEGIN ENCRYPTED PRIVATE KEY-----\nMIIFLTBXBgkqhkiG9w0BBQ0wSjApBgkqhkiGK7wbIkVf2jW\n-----END ENCRYPTED PRIVATE KEY-----\n
   

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

7. Pilih Sync frequency untuk Full sync dan Incremental sync frequency untuk Incremental data sync. Untuk mengetahui informasi selengkapnya, lihat Jadwal sinkronisasi.

   Jika Anda ingin menjadwalkan sinkronisasi penuh data entitas dan identitas secara terpisah, luaskan menu di bagian Full sync , lalu pilih Custom options.

   

   Menetapkan jadwal terpisah untuk sinkronisasi entitas penuh dan sinkronisasi identitas penuh.

8. Pilih region untuk penyimpanan data Anda.

9. Masukkan nama untuk penyimpanan data Anda.

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

11. Untuk memeriksa status penyerapan Anda, buka halaman Data Stores , lalu klik nama penyimpanan data Anda untuk melihat detailnya di halaman Data. Connector state akan berubah dari Creating menjadi Running saat mulai menyinkronkan data. Setelah penyerapan selesai, status akan berubah menjadi Active untuk menunjukkan bahwa koneksi ke sumber data Anda telah disiapkan dan menunggu sinkronisasi terjadwal berikutnya.

    Bergantung pada ukuran data Anda, 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 penyimpanan data Anda disiapkan, lihat Mendapatkan hasil penelusuran.

• Untuk mengaktifkan pemberitahuan untuk penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.

Menghubungkan Penelusuran Gabungan dengan Box

Gunakan prosedur berikut untuk menelusuri akun Box Anda menggunakan penelusuran gabungan.

Tentang penggabungan data

Dengan penggabungan data, Gemini Enterprise akan langsung mengambil informasi dari sumber data pihak ketiga menggunakan API, bukan menyalin data ke Gemini Enterprise. Dengan pendekatan ini, Anda dapat langsung mengakses sumber data eksternal, tanpa menunggu penyerapan.

Sebelum memulai

Sebelum membuat penyimpanan data Box di Gemini Enterprise, Anda harus mendaftarkan aplikasi OAuth 2.0 di Konsol Developer Box.

Untuk mendaftarkan aplikasi, lakukan hal berikut:

1. Login ke Konsol Developer Box dengan akun administrator Anda.

2. Klik Create Platform App.

   

   Membuat Aplikasi Platform baru.

3. Klik Custom App.

4. Isi kolom yang wajib diisi.

   

   Berikan detail untuk aplikasi Anda.

5. Pilih User Authentication (OAuth 2.0).

   

   Pilih metode autentikasi.

6. Klik Create App.

7. Salin Client ID dan Client Secret. Hal ini diperlukan untuk membuat penyimpanan data penelusuran gabungan dengan Box di Gemini Enterprise.

   

   Catat kredensial OAuth 2.0.

8. Di bagian OAuth 2.0 Redirect URIs, tambahkan URI pengalihan berikut:

   • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html
   • https://vertexaisearch.cloud.google.com/oauth-redirect

   

   Berikan URI pengalihan.

9. Pilih cakupan aplikasi berikut:

   • Read all files and folders stored in Box
   • Write all files and folders stored in Box

   

   Pilih cakupan yang diperlukan.

10. Klik Save Changes.

Membuat konektor penelusuran gabungan dengan Box

Konsol

Gunakan langkah-langkah berikut untuk Google Cloud konsol guna melakukan penelusuran gabungan melalui Box dari Gemini Enterprise.

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

   Gemini Enterprise

2. Di menu navigasi, klik Data Stores.

3. Klik Create Data Store.

4. Di halaman Select a data source, scroll atau telusuri Box Federated untuk menghubungkan sumber pihak ketiga Anda.

   

   Menelusuri Box Federated

5. Di bagian Authentication settings:

   1. Masukkan Client ID dan Client secret.
   2. Klik Authenticate.

   3. Klik Continue.

      

      Masukkan informasi autentikasi

6. Pilih region untuk sumber data Anda.

7. Masukkan nama untuk sumber data Anda.

   

   Konfigurasikan konektor data Anda

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

Setelah penyimpanan data dibuat, buka halaman Data Stores , lalu klik nama penyimpanan data Anda untuk melihat statusnya. Jika Connector state berubah dari Creating menjadi Active, konektor penelusuran gabungan siap digunakan.

Otorisasi pengguna

Setelah membuat penyimpanan data penelusuran gabungan, Anda dapat melihatnya tercantum sebagai salah satu sumber data di panel pengelolaan sumber. Jika Anda belum pernah memberikan otorisasi Gemini Enterprise, Anda tidak dapat memilih sumber data. Sebagai gantinya, tombol Authorize akan muncul di sampingnya.

Untuk memulai alur otorisasi:

1. Klik Authorize. Anda akan dialihkan ke server otorisasi Box.

   

   Klik Otorisasi

2. Login ke akun Box Anda.

3. Klik Grant access. Setelah memberikan akses, Anda akan dialihkan kembali ke Gemini Enterprise untuk menyelesaikan alur otorisasi flow.

   Gemini Enterprise mendapatkan access_token, dan menggunakannya untuk mengakses penelusuran pihak ketiga.

Eksekusi kueri

Saat Anda memasukkan kueri penelusuran:

• Jika penelusuran gabungan Box diotorisasi, Gemini Enterprise akan mengirimkan kueri ke Box API.
• Gemini Enterprise menggabungkan hasil dengan hasil dari sumber lain dan menampilkannya.

Penanganan data

Saat menggunakan penelusuran gabungan pihak ketiga, string kueri Anda akan dikirim ke backend penelusuran pihak ketiga. Pihak ketiga ini dapat mengaitkan kueri dengan identitas Anda. Jika beberapa sumber data penelusuran gabungan diaktifkan, kueri dapat dikirim ke semua sumber tersebut.

Setelah data mencapai sistem pihak ketiga, data tersebut akan diatur oleh Persyaratan Layanan dan kebijakan privasi sistem tersebut (bukan oleh Google Cloudpersyaratan).

Catatan: LLM dapat menulis ulang kueri Anda sebelum dikirim. Kueri yang ditulis ulang ini dapat menggabungkan informasi dari histori kueri berbasis sesi Anda. Akibatnya, bagian dari histori tersebut juga dapat disertakan dalam data yang dikirim ke backend pihak ketiga.