Menyiapkan penyimpanan data GitHub

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

Sebelum memulai

Sebelum menyiapkan koneksi GitHub, pastikan Anda telah menyiapkan hal berikut:

  • Berikan 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 edit Edit.
    3. Berikan peran Discovery Engine Editor kepada pengguna. Untuk mengetahui informasi selengkapnya, lihat Peran dan izin IAM.

  • Login ke akun GitHub Anda dan dapatkan kredensial autentikasi.

  • Buat aplikasi GitHub untuk menggunakan konektor ini. Untuk mengetahui informasi selengkapnya, lihat Membuat aplikasi GitHub.

Membuat penyimpanan data GitHub

Untuk membuat penyimpanan data GitHub, 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 Buat penyimpanan data.

  5. Di bagian Source, telusuri GitHub, lalu pilih.

  6. Di bagian Data > Authentication settings:

    1. Masukkan detail kredensial klien:

      • Client ID: Client ID OAuth untuk aplikasi Anda.
      • Rahasia Klien: Rahasia klien OAuth untuk aplikasi Anda.

      Untuk mengetahui informasi selengkapnya tentang kredensial, lihat Konfigurasi GitHub.

    2. Jika pengguna Anda login melalui penyedia identitas (IdP), seperti dengan Pengguna Terkelola GitHub Enterprise (EMU), masukkan detail login SSO GitHub. Jika tidak, biarkan kolom ini kosong.

      • GitHub SSO Scope: Namespace GitHub yang membatasi login. Jika IdP Anda dikonfigurasi di tingkat perusahaan, pilih enterprises. Jika IdP Anda dikonfigurasi di tingkat organisasi, pilih orgs.

      • GitHub SSO Slug: Slug perusahaan atau organisasi GitHub Anda, misalnya octocorp untuk URL perusahaan https://github.com/enterprises/octocorp. Masukkan slug saja, bukan URL lengkap.

    3. Klik Verify Auth dan selesaikan verifikasi otorisasi GitHub.

  7. Di bagian Data> Advanced options:

    1. Masukkan nama organisasi GitHub Anda di kolom Organization Name. Hal ini diperlukan untuk menentukan cakupan penelusuran dan tindakan.

    2. Klik Lanjutkan.

  8. Di bagian Data > Entities to search:

    1. Pilih entity yang diperlukan.

    2. Klik Lanjutkan.

  9. Di bagian Actions:

    1. Untuk Select GitHub actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi penyimpanan data.

      Untuk mengelola daftar tindakan, lihat Mengelola tindakan.

    2. Klik Lanjutkan.

  10. Jika alur pembuatan penyimpanan data menampilkan bagian Advanced options, Anda dapat mencentang kotak Enable Static IP Addresses di dalamnya. Hal ini memastikan penyimpanan data menggunakan kumpulan alamat IP tetap untuk traffic keluar, yang cocok untuk daftar yang diizinkan di sistem sumber. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi egress IP statis.

  11. 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, konfigurasi 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.

  12. Klik Lanjutkan.

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

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

Di halaman Data Stores, klik nama penyimpanan data Anda untuk melihat statusnya. Setelah status penyimpanan data berubah dari Creating menjadi Active, konektor GitHub siap digunakan.

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 GitHub dan mengirim kueri penelusuran ke Gemini Enterprise:

  • Gemini Enterprise mengirim kueri penelusuran Anda langsung ke GitHub 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 (GitHub 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.

Langkah berikutnya