Ringkasan

Konektor Jira Cloud untuk Gemini Enterprise memberikan akses ke data Jira Cloud Anda, sehingga Anda dapat berinteraksi dengan project, masalah, dan informasi pengguna Anda.

Versi Jira Cloud yang didukung

Konektor Jira Cloud mendukung Jira Cloud REST API versi 2.

Tindakan yang didukung

Jika konektor Jira Cloud diaktifkan, pengguna akhir dapat menggunakan perintah bahasa alami di Gemini Enterprise untuk melakukan tindakan berikut.

Tindakan Deskripsi
Buat komentar Membuat komentar baru pada masalah Jira tertentu untuk menambahkan masukan, info terbaru, atau catatan.
Perbarui komentar Mengedit teks komentar yang ada.
Buat masalah Membuat masalah baru dalam project Jira Cloud. Untuk membuatnya, Anda harus memberikan ringkasan, project ID, dan ID jenis masalah.
Masalah update Memperbarui masalah yang ada di Jira Cloud. Anda harus memberikan ID masalah untuk mengidentifikasinya, dan Anda dapat mengubah berbagai kolom seperti ringkasan, deskripsi, dan penerima tugas.

Selain itu, tindakan hanya baca tambahan juga tersedia.

Cakupan yang diperlukan

Untuk mengizinkan Gemini Enterprise melakukan penelusuran dan tindakan menggunakan penyimpanan data Jira Cloud, Anda memerlukan cakupan berikut:

Mode koneksi Cakupan Tujuan
Penelusuran dan tindakan gabungan read:jira-user, read:jira-work Diperlukan untuk mengambil dan menampilkan hasil penelusuran dan detail pengguna secara real-time.
write:jira-work Mengizinkan asisten mengubah item kerja (misalnya, memperbarui kolom masalah).
write:comment:jira Memungkinkan asisten memposting komentar atau balasan baru langsung dari antarmuka penelusuran.
write:issue:jira Diperlukan untuk membuat masalah baru atau melakukan pengeditan besar pada masalah yang ada.
Khusus penelusuran gabungan read:jira-user, read:jira-work Diperlukan untuk menelusuri dan melihat masalah, project, dan profil pengguna.
Penyerapan dan tindakan data read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Diperlukan untuk penyerapan data skala penuh dan menyinkronkan metadata pengguna/grup.
read:issue-security-level:jira, read:issue-security-scheme:jira Penting untuk kontrol akses; memastikan data yang di-ingest mematuhi batas keamanan Jira.
read:audit-log:jira Digunakan untuk melacak perubahan dan melakukan sinkronisasi inkremental agar data yang di-ingest tetap terbaru.
write:jira-work Diperlukan untuk melakukan tindakan tulis pada item kerja dalam lingkungan yang di-ingest.
write:comment:jira Diperlukan untuk menambahkan komentar ke masalah menggunakan asisten.
write:issue:jira Memungkinkan pembuatan atau modifikasi masalah.
Penyerapan data read:jira-work, read:user:jira, read:group:jira, read:avatar:jira Diperlukan untuk meng-crawl dan mengindeks konten Jira serta hubungan pengguna.
read:issue-security-level:jira, read:issue-security-scheme:jira Diperlukan untuk memetakan izin sehingga hanya pengguna yang diberi otorisasi yang dapat menelusuri data yang di-ingest.
read:audit-log:jira Diperlukan agar mesin sinkronisasi dapat mengidentifikasi item mana yang telah diperbarui atau dihapus.

Untuk mengetahui informasi tentang cara mengonfigurasi cakupan ini, lihat Mengonfigurasi cakupan aplikasi minimum.

Batas laju untuk penyerapan data

Konektor Jira Cloud mendukung batas frekuensi default 12 kueri per detik (QPS) untuk penyerapan data. Batas frekuensi ini berlaku secara eksklusif untuk penyerapan data dari konektor Jira Cloud.

Batasan

Bagian ini menguraikan masalah umum dan batasan yang dapat memengaruhi penggunaan konektor Jira Cloud.

  • Penerapan perimeter Kontrol Layanan VPC pada penyimpanan data Jira Cloud yang ada tidak didukung. Untuk menerapkan Kontrol Layanan VPC, Anda harus menghapus dan membuat ulang penyimpanan data. Untuk mengetahui informasi selengkapnya tentang Kontrol Layanan VPC dan cara menggunakan tindakan setelah mengaktifkan Kontrol Layanan VPC, lihat Mengamankan aplikasi Anda dengan Kontrol Layanan VPC.

  • Penyimpanan data Jira Cloud hanya didukung di lokasi Global, AS, dan Uni Eropa.

  • Saat membuat aplikasi baru atau menambahkan penyimpanan data ke aplikasi yang sudah ada, sebaiknya tambahkan penyimpanan data dengan tindakan yang termasuk dalam satu jenis konektor. Misalnya, jangan mengaitkan dua penyimpanan data Jira Cloud dengan tindakan yang diaktifkan ke aplikasi yang sama.

Berikut adalah batasan untuk konektor penyerapan Jira Cloud:

  • Untuk data tidak terstruktur, setiap jenis media memiliki batasan yang berbeda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan data untuk sumber data kustom.

  • Untuk data terstruktur, setiap dokumen tidak boleh berukuran lebih dari 500 KB.

  • Peran aplikasi dengan peran spesifik yang tidak kosong tidak dapat diberi izin tingkat keamanan Browse project.

  • Izin dokumen yang ditentukan oleh kolom kustom pengguna atau kolom kustom grup tidak didukung.

  • Jira Cloud tidak mengizinkan batasan apa pun pada tingkat log aktivitas.

  • Jira Cloud tidak mengindeks lampiran PDF yang melebihi 2.000 halaman.

  • Lampiran yang ditambahkan ke komentar pribadi tidak mewarisi batasan akses (ACL) pada komentar.

  • Hanya 20 komentar sebelumnya untuk masalah di Jira Cloud yang diambil.

  • Tabel sprint tidak dapat diproses.

  • Model pengelolaan pengguna lama tidak didukung untuk integrasi dengan Jira Cloud. Hanya model pengelolaan pengguna terpusat yang didukung. Untuk mengetahui informasi selengkapnya, lihat Panduan penggabungan Organisasi Atlassian.

  • Saat membuat kueri entitas Jira (misalnya, masalah), data terkait seperti komentar dan lampiran tidak otomatis disertakan. Hal ini karena keduanya disimpan dan diindeks sebagai entitas terpisah. Penelusuran berdasarkan konten lampiran untuk menemukan masalah induk tidak didukung.

Langkah berikutnya