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 Discovery Engine Editor (roles/discoveryengine.editor). Peran ini diperlukan agar pengguna dapat membuat penyimpanan data. Untuk memberikan peran ini, lakukan hal berikut:

    1. Di konsol Google Cloud , 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 konsol Google Cloud , buka halaman Gemini Enterprise.

    Gemini Enterprise

  2. Pilih atau buat project Google Cloud .

  3. Di menu navigasi, klik Penyimpanan data.

  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.
      • Client Secret: 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 GitHub Enterprise Managed Users (EMU), masukkan detail login SSO GitHub. Jika tidak, kosongkan kolom ini.

      • Cakupan SSO GitHub: 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 organisasi atau perusahaan 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 entitas 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 dimasukkan ke 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 Nama konektor data Anda, masukkan nama untuk konektor Anda.
    3. Jika Anda memilih us atau eu sebagai lokasi, konfigurasikan Setelan enkripsi:
      • Opsional: Jika Anda belum mengonfigurasi kunci satu region, klik Buka halaman setelan 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:
        • Dalam 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 Penagihan, pilih Harga umum atau Harga yang dapat dikonfigurasi. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project dan Lisensi.

  14. Klik Create. Gemini Enterprise akan membuat penyimpanan data Anda dan menampilkannya 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 dari penggunaan penyimpanan data gabungan.

Eksekusi kueri

Setelah Anda mengizinkan GitHub dan mengirim kueri penelusuran ke Gemini Enterprise:

  • Gemini Enterprise mengirimkan kueri penelusuran Anda langsung ke GitHub API.
  • Gemini Enterprise menggabungkan hasil tersebut dengan hasil dari sumber data lain yang terhubung 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 akan 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