Menyiapkan penyimpanan data Box

Pratinjau pribadi: Pembuatan dan penggunaan penyimpanan data menggunakan penyerapan data berada dalam pratinjau pribadi. Anda harus berada dalam daftar yang diizinkan untuk menggunakan penyimpanan data penyerapan data. Untuk ditambahkan ke daftar yang diizinkan, hubungi tim akun Anda atau tim penjualan.

Halaman ini menjelaskan cara membuat penyimpanan data dan menghubungkan Box ke Gemini Enterprise.

Sebelum memulai

Sebelum menyiapkan koneksi Box, pastikan Anda melakukan hal berikut:

1. Memberikan peran Editor Discovery Engine (roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:
   1. Di Google Cloud konsol, buka halaman IAM.

      Buka IAM

   2. Temukan akun pengguna, lalu klik ikon edit Edit.
   3. Berikan peran Discovery Engine Editor kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.
2. Membuat dan mengotorisasi akun aplikasi Box.
3. Mengonfigurasi Box dan menetapkan izin yang diperlukan. Untuk mengetahui daftar cakupan yang diperlukan untuk penelusuran dan penyerapan data, lihat Izin yang diperlukan.
4. Mendapatkan informasi autentikasi untuk digunakan selama pembuatan penyimpanan data.
5. Menyiapkan Google Cloud project dengan akun administrator yang dapat mengelola konfigurasi tingkat organisasi, sehingga organisasi dapat menyiapkan kumpulan tenaga kerja.
6. Memastikan organisasi Anda disiapkan untuk mengelola a kumpulan tenaga kerja.

Membuat penyimpanan data Box

Untuk membuat penyimpanan data Box, lakukan langkah-langkah berikut:

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

   Gemini Enterprise

2. Pilih atau buat a Google Cloud project.

3. Di menu navigasi, klik Data stores.

4. Klik Create data store.

5. Di bagian Source, telusuri Box, lalu klik Select.

6. Di bagian Data:

   1. Di bagian Connector mode, pilih Federated search atau Data ingestion sebagai mode koneksi.

   2. Klik Continue.

   3. Di bagian Authentication settings, konfigurasikan autentikasi berdasarkan mode koneksi yang Anda pilih.

      • Jika Anda memilih Federated Search, masukkan detail berikut:

        • Client ID: ID unik untuk aplikasi Box Anda.
        • Client secret: Kunci rahasia yang terkait dengan aplikasi Box Anda.

      • Jika Anda memilih Data ingestion, masukkan detail berikut:

        • Enterprise ID: ID unik untuk perusahaan Box Anda.
        • Client ID: ID publik untuk aplikasi Box Anda.
        • Client secret: Kunci rahasia yang terkait dengan aplikasi Box Anda.
        • Instance URI: URL dasar untuk Box instance API Anda.
        • Private key: Kunci pribadi yang digunakan untuk mengautentikasi aplikasi Box Anda.
        • Key ID: ID untuk kunci pribadi.
        • Frasa sandi: Frasa sandi yang digunakan untuk mendekripsi kunci pribadi.

        Untuk mengetahui daftar cakupan yang diperlukan untuk penelusuran, tindakan, dan penyerapan data, lihat Cakupan yang diperlukan. Untuk mengetahui informasi tentang cara mendapatkan informasi autentikasi, lihat Mendapatkan informasi autentikasi Box.

      • Jika Anda memilih Federated Search, klik Login dan selesaikan proses login.

   4. Klik Continue.

   5. Di bagian Advanced options:

      • Jika Anda memilih Federated search, pilih Impersonate user mode sebagai Admin atau User, lalu klik Continue.
      • Opsional. Jika Anda memilih Data ingestion, centang kotak Enable static IP addresses untuk mengizinkan sekumpulan alamat IP statis di sistem Anda.

   6. Klik Continue.

   7. Di bagian Entities to search (jika Anda memilih Federated search) atau Entities to sync (jika Anda memilih Data ingestion):

      1. Pilih semua entity yang diperlukan.
      2. Jika Anda memilih Data ingestion, lanjutkan dengan langkah-langkah berikut:
         1. Opsional: Untuk menyinkronkan project tertentu, lakukan hal berikut:
            1. Klik Filter.
            2. Untuk memfilter entity dari indeks, centang kotak Exclude from the index, atau untuk memastikan entity disertakan dalam indeks, centang kotak Include to the index.
            3. Masukkan kunci. Tekan tombol Enter setelah setiap kunci.
            4. Klik Save.
         2. Untuk mengonfigurasi jadwal sinkronisasi, lakukan hal berikut:
            1. Di daftar Sync frequency, pilih frekuensi sinkronisasi.
               • Untuk menjadwalkan sinkronisasi penuh data entity dan identitas secara terpisah, luaskan menu di bagian Full sync , lalu pilih Custom options.
            2. Di daftar Incremental sync frequency, pilih frekuensi sinkronisasi inkremental. Untuk mengetahui informasi selengkapnya, lihat Jadwal sinkronisasi.

7. Klik Continue.

8. Di bagian Actions:

   • Jika Anda memilih Federated search, di bagian Select Box actions to enable, pilih tindakan yang akan diaktifkan untuk penyimpanan data.

   • Jika Anda memilih Data ingestion:

     1. Di bagian Authentication settings, berikan detail autentikasi berikut:

        • Client ID: ID publik untuk aplikasi Box Anda.
        • Client secret: Kunci rahasia yang terkait dengan aplikasi Box Anda.

        Untuk mengetahui informasi selengkapnya tentang cara mendapatkan kredensial ini, lihat Mendapatkan informasi autentikasi Box.

     2. Klik Login dan login ke Box untuk memverifikasi akun Anda.

     3. Klik Continue.

     4. Di bagian Advanced options, centang kotak Enable static IP addresses untuk mengizinkan sekumpulan alamat IP statis di sistem Anda.

     5. Klik Continue.

     6. Di bagian Select Box actions to enable, pilih tindakan yang akan diaktifkan untuk penyimpanan data.

   Catatan: Jika Anda melewatkan langkah menambahkan tindakan ini, Anda dapat menambahkannya nanti. Untuk mengetahui informasi selengkapnya, lihat Menambahkan tindakan.

   Untuk mengelola daftar tindakan, lihat Mengelola tindakan.

9. Klik Continue.

10. Di bagian Configuration:

    1. Dari daftar Multi-region, pilih lokasi untuk konektor data Anda.
    2. Di kolom Your data connector name, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasikan Encryption settings:
       • Opsional: Jika Anda belum mengonfigurasi kunci satu region, klik Go to settings page untuk melakukannya. Untuk mengetahui informasi selengkapnya, lihat Mendaftarkan kunci satu region untuk konektor pihak ketiga.
       • Pilih Google-managed encryption key atau Cloud KMS key.
       • Jika Anda memilih Cloud KMS key:
         • Di daftar Key management type, pilih jenis yang sesuai.
         • Di daftar Cloud KMS key, pilih kunci.
       Untuk mengetahui informasi selengkapnya, lihat Kunci enkripsi yang dikelola pelanggan.

11. Klik Continue.

12. Di bagian Billing, pilih General pricing atau Configurable pricing. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

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

Untuk memverifikasi status penyimpanan data, lakukan hal berikut:

1. Buka penyimpanan data di daftar penyimpanan data dan pantau statusnya hingga berubah menjadi Active.
2. Saat status penyimpanan data berubah dari Creating menjadi Active, konektor Box siap digunakan.

Untuk penyimpanan data penyerapan yang dibuat dengan Box, status penyimpanan data akan bertransisi dari Creating menjadi Running setelah inisiasi sinkronisasi. Kemudian, status akan berubah menjadi Active setelah penyerapan selesai, yang menandakan bahwa penyimpanan data telah sepenuhnya dikonfigurasi. Bergantung pada volume data, penyerapan mungkin memerlukan waktu beberapa jam.

Jika telah membuat penyimpanan data gabungan Box, Anda harus mengotorisasi Gemini Enterprise ke Box sebelum menjalankan kueri.

Penanganan data dan eksekusi kueri

Bagian ini menjelaskan cara Gemini Enterprise mengelola kueri Anda dan implikasi privasi penggunaan penyimpanan data gabungan.

Eksekusi kueri

Setelah Anda mengotorisasi Box dan mengirim kueri penelusuran ke Gemini Enterprise:

• Gemini Enterprise mengirim kueri penelusuran Anda langsung ke Box API.
• Gemini Enterprise menggabungkan hasil dengan hasil dari sumber data terhubung lainnya dan menampilkan hasil penelusuran yang komprehensif.

Penanganan data

Saat menggunakan penelusuran gabungan pihak ketiga, aturan penanganan data berikut berlaku:

• String kueri Anda dikirim ke backend penelusuran pihak ketiga (Box API).
• Pihak ketiga ini dapat mengaitkan kueri dengan identitas Anda.
• Jika beberapa sumber data penelusuran gabungan diaktifkan, kueri mungkin dikirim ke semua sumber data tersebut.
• Setelah data mencapai sistem pihak ketiga, data tersebut akan diatur oleh persyaratan layanan dan kebijakan privasi sistem tersebut.

Catatan: Untuk meningkatkan akurasi, LLM dapat menulis ulang kueri Anda sebelum dikirim ke Box. Kueri yang ditulis ulang ini dapat menggabungkan informasi dari histori kueri sesi Anda. Akibatnya, bagian dari histori kueri Anda mungkin juga disertakan dalam kueri yang dikirim ke Box API.

Langkah berikutnya

• Untuk menyediakan antarmuka pengguna untuk membuat kueri data Anda, buat aplikasi dan hubungkan ke penyimpanan data gabungan Box.
• Untuk melihat dan mengelola daftar tindakan, lihat Melihat dan mengelola tindakan.
• Untuk melihat pratinjau tampilan hasil penelusuran setelah aplikasi Anda disiapkan, lihat Mendapatkan hasil penelusuran.
• Untuk mengaktifkan pemberitahuan untuk penyimpanan data, lihat Mengonfigurasi pemberitahuan untuk penyimpanan data pihak ketiga.