Menyiapkan penyimpanan data Jira Cloud

Pratinjau publik: Fitur penelusuran dan tindakan gabungan berada dalam pratinjau publik. Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

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

Sebelum memulai

Pastikan hal berikut sebelum Anda menyiapkan koneksi gabungan Jira Cloud:

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

• Untuk menerapkan kontrol akses sumber data dan mengamankan data di Google Gemini Enterprise, konfigurasi penyedia identitas Anda.

• Untuk menyiapkan penyimpanan data Jira Cloud, Anda harus menggunakan model pengelolaan pengguna Atlassian terpusat yang baru. Jika menggunakan model asli, Anda harus memigrasikan pengelolaan pengguna sebelum melanjutkan. Untuk mengetahui informasi selengkapnya, lihat Peran administrator situs.

• Buat aplikasi OAuth 2.0, dapatkan ID dan rahasia klien, serta konfigurasi izin aplikasi minimum dengan izin administrator Jira Cloud. Pastikan Anda memiliki akses administrator organisasi Jira ke instance dan project Jira. Dengan akses administrator organisasi, Anda dapat menyiapkan izin minimum dan memberikan hak akses ke grup pengguna.

• Opsional: Untuk mengambil alamat email pengguna dari Jira Cloud, meskipun setelan membatasi visibilitas email, instal aplikasi User Identity Accessor for Jira Cloud dengan hak istimewa Administrator situs Jira untuk menginstal dan mengonfigurasinya agar dapat mengambil alamat email pengguna dengan aman. Anda mungkin tidak perlu menginstal aplikasi ini jika alamat email sudah dapat diakses secara publik.

  Catatan: Atlassian memperbarui elemen antarmuka pengguna, dan beberapa elemen yang disebutkan dalam dokumentasi ini diganti namanya (misalnya, Produk diganti namanya menjadi Aplikasi). Untuk mengetahui informasi selengkapnya, lihat Perubahan terminologi Administrasi Atlassian dari "produk" menjadi "aplikasi".

Membuat penyimpanan data Jira Cloud

Untuk membuat penyimpanan data Jira Cloud, 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 Jira Cloud, lalu klik Select.

6. Di bagian Data:

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

   2. Klik Lanjutkan.

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

      1. Berikan detail autentikasi berikut:

         • Client ID: ID untuk aplikasi OAuth 2.0 Anda.
         • Client secret: Kunci rahasia yang terkait dengan aplikasi OAuth 2.0 Anda.
         • Instance URI: URL dasar instance Jira Cloud Anda (Misalnya, https://your-domain.atlassian.net).
         • Instance ID: ID unik untuk instance Jira Cloud Anda.

         Untuk mengetahui informasi selengkapnya tentang cara mendapatkan kredensial ini, lihat Konfigurasi Jira Cloud.

      2. Jika Anda memilih Federated search, klik Login dan selesaikan login Atlassian.

      3. Klik Lanjutkan.

   4. Di bagian Destinations, masukkan URL ke endpoint Jira Cloud Anda.

   5. Klik Lanjutkan.

   6. Di bagian Entities to search (jika Anda memilih Federated search) atau Entities to sync (jika Anda memilih penyerapan data):

      1. Pilih semua entity yang diperlukan.
      2. Jika Anda memilih Federated search, lanjutkan ke langkah berikutnya.
      3. Jika Anda memilih Penyerapan data, lanjutkan dengan langkah-langkah berikut:
         1. Opsional: Untuk menyinkronkan project tertentu, lakukan hal berikut:
            1. Klik Filter.
            2. Untuk memfilter entity dari indeks, pilih Exclude from the index, atau untuk memastikan entity disertakan dalam indeks, pilih Include to the index.
            3. Masukkan kunci project. Tekan Enter setelah setiap kunci project. Untuk mengetahui informasi selengkapnya tentang cara mendapatkan kunci project, lihat Mendapatkan kunci project.
            4. Klik Simpan.
         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 Lanjutkan.

8. Di bagian Actions:

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

   • Jika Anda memilih Penyerapan data:

     1. Di bagian Authentication settings:

        1. Berikan detail autentikasi berikut:
           • Client ID: ID untuk aplikasi OAuth 2.0 Anda.
           • Client Secret: Kunci rahasia yang terkait dengan aplikasi OAuth 2.0 Anda.
           • Instance URI: URL dasar instance Jira Cloud Anda (Misalnya, https://your-domain.atlassian.net).
           • Instance ID: ID unik untuk instance Jira Cloud Anda.

        Untuk mengetahui informasi selengkapnya tentang kredensial, lihat Konfigurasi Jira Cloud.

        1. Klik Login dan login ke Jira Cloud untuk memverifikasi akun Anda.

     2. Klik Lanjutkan.

     3. Dari Select Jira Cloud actions to enable, pilih tindakan dari kategori untuk mengaktifkannya bagi 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 Lanjutkan.

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

11. Klik Lanjutkan.

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 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, penyimpanan data Jira Cloud siap digunakan.

Untuk penyimpanan data penyerapan yang dibuat dengan Jira Cloud, 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.

Setelah membuat penyimpanan data, buat aplikasi, hubungkan ke penyimpanan data Jira Cloud, dan izinkan Gemini Enterprise untuk mengakses Jira Cloud sebelum menjalankan kueri apa pun.

Mengaktifkan sinkronisasi real-time untuk penyerapan data

Pratinjau — Sinkronisasi real-time

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Sinkronisasi real-time hanya menyinkronkan entity dokumen dan tidak menyinkronkan data yang terkait dengan entity identitas. Tabel berikut menunjukkan peristiwa dokumen mana yang didukung dengan sinkronisasi real-time.

Entity Jira	Buat	Perbarui	Hapus	Perubahan izin
Masalah
Log kerja
Project
Komentar
Lampiran

Untuk mengaktifkan sinkronisasi real-time untuk penyimpanan data Jira Cloud, ikuti langkah-langkah berikut:

Membuat URL webhook

1. Buka halaman Gemini Enterprise, lalu di menu navigasi, klik Data Stores.
2. Pilih penyimpanan data Jira Cloud.

3. Klik View/Edit di baris Realtime sync.

4. Di dialog View and edit realtime sync parameters, lakukan hal berikut:

   1. Untuk mengaktifkan sinkronisasi real-time, klik tombol Enable realtime sync.
   2. Masukkan nilai di kolom Client secret , lalu salin. Anda akan memerlukan nilai ini lagi saat membuat webhook di konsol administrasi Jira.
   3. Klik Simpan.

5. Setelah status Realtime sync berubah menjadi Running, klik View/Edit.

6. Di dialog View and edit realtime sync parameters, lakukan hal berikut:

   1. Salin URL webhook.
   2. Klik Close.

Membuat webhook

1. Login ke konsol administrasi Jira.
2. Klik Settings , lalu pilih System.
3. Di panel System settings, pilih Webhooks.
4. Klik Create a webhook. Untuk mengetahui informasi tentang webhook, lihat Webhook.
5. Masukkan nama untuk webhook.
6. Pilih Status sebagai Enabled.
7. Di kolom URL, tempelkan URL yang disalin dari Gemini Enterprise dan tambahkan /{issue.id}.

8. Di kolom Secret, masukkan nilai yang sama dengan yang Anda masukkan saat membuat URL webhook di Gemini Enterprise.

   Catatan: Untuk memverifikasi konsistensi data dan mencegah error saat mengonfigurasi webhook di Jira, hanya pilih entity yang diaktifkan untuk sinkronisasi di penyimpanan data Anda.

9. Di bagian Issue related events, pilih opsi berikut:

   Entity	Dibuat	Diperbarui	Dihapus
   Masalah	Ya	Ya	Ya
   Log kerja	Ya	Ya	Ya
   Komentar	Ya	Ya	Ya
   Lampiran	Ya	Tidak	Ya

10. Di bagian Project related events, centang kotak created, updated, dan deleted untuk entity Project.

11. Klik Create.

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

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

Catatan: Untuk meningkatkan akurasi, LLM dapat menulis ulang kueri Anda sebelum dikirim ke Jira Cloud. 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 Atlassian API.

Langkah berikutnya

• Untuk menyediakan antarmuka pengguna untuk membuat kueri data Jira Cloud Anda, buat aplikasi dan hubungkan ke penyimpanan data Jira Cloud.
• Untuk mengelola daftar tindakan, lihat 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.