Gemini Enterprise 的 Jira Cloud 連接器可存取 Jira Cloud 資料，讓您與專案、問題和使用者資訊互動。
支援的 Jira Cloud 版本
Jira Cloud 連接器支援 Jira Cloud REST API 第 2 版。
支援的動作
啟用 Jira Cloud 連接器後，終端使用者就能在 Gemini Enterprise 中使用自然語言指令，執行下列動作。
| 動作 | 說明 |
|---|---|
| 建立註解 | 在指定的 Jira 問題中建立新留言，新增意見回饋、最新消息或附註。 |
| 更新留言 | 編輯現有留言的文字。 |
| 建立問題 | 在 Jira Cloud 專案中建立新問題。如要建立問題，請提供摘要、專案 ID 和問題類型 ID。 |
| 更新問題 | 更新 Jira Cloud 中的現有問題。您需要提供問題 ID 來識別問題，並可修改摘要、說明和指派對象等各種欄位。 |
除了上述動作外，您也可以執行其他唯讀動作。
必要範圍
如要讓 Gemini Enterprise 使用 Jira Cloud 資料存放區執行搜尋和動作，您需要下列範圍：
| 連線模式 | 範圍 | 目的 |
|---|---|---|
| 聯合搜尋和動作 | read:jira-user、read:jira-work |
必須使用這項權限，才能即時擷取及顯示搜尋結果和使用者詳細資料。 |
write:jira-work |
允許助理修改工作項目 (例如更新問題欄位)。 | |
write:comment:jira |
讓助理直接透過搜尋介面發布新留言或回覆。 | |
write:issue:jira |
建立新問題或對現有問題進行重大編輯時，必須具備這項權限。 | |
| 僅限聯盟搜尋 | read:jira-user、read:jira-work |
必須具備這項權限，才能搜尋及查看問題、專案和使用者設定檔。 |
| 資料擷取和動作 | read:jira-work、read:user:jira、read:group:jira、read:avatar:jira |
用於全面擷取資料，以及同步處理使用者/群組中繼資料。 |
read:issue-security-level:jira、read:issue-security-scheme:jira |
存取控管的關鍵，可確保擷取的資料遵守 Jira 的安全界線。 | |
read:audit-log:jira |
用於追蹤變更及執行增量同步，確保擷取的資料為最新狀態。 | |
write:jira-work |
必須在擷取環境中對工作項目執行寫入動作。 | |
write:comment:jira |
使用助理在問題中新增留言時，必須提供留言。 | |
write:issue:jira |
可建立或修改問題。 | |
| 資料擷取 | read:jira-work、read:user:jira、read:group:jira、read:avatar:jira |
檢索 Jira 內容和使用者關係並建立索引時，必須使用此權限。 |
read:issue-security-level:jira、read:issue-security-scheme:jira |
必須對應權限，確保只有授權使用者可以搜尋擷取的資料。 | |
read:audit-log:jira |
同步引擎必須使用這項資訊，才能判斷哪些項目已更新或刪除。 |
如要瞭解如何設定這些範圍，請參閱「設定最低應用程式範圍」。
資料擷取的頻率限制
Jira Cloud 連接器支援資料擷取作業的預設頻率限制，即每秒 12 次查詢 (QPS)。這些速率限制僅適用於從 Jira Cloud 連接器擷取資料。
限制
本節說明可能影響 Jira Cloud 連接器使用的已知問題和限制。
系統不支援對現有 Jira Cloud 資料儲存庫強制執行 VPC Service Controls 周邊範圍。如要強制執行 VPC Service Controls，您必須刪除並重新建立資料儲存庫。如要進一步瞭解 VPC Service Controls，以及啟用 VPC Service Controls 後如何使用動作，請參閱「使用 VPC Service Controls 保護應用程式」。
Jira Cloud 資料儲存庫僅支援全球、美國和歐盟地區。
建立新應用程式或在現有應用程式中新增資料儲存庫時，建議您新增的資料儲存庫包含屬於單一連結器類型的動作。舉例來說，請勿將兩個 Jira Cloud 資料儲存庫與已啟用動作的相同應用程式建立關聯。
Jira Cloud 擷取連接器有以下限制：
如果是非結構化資料，每種媒體類型都有不同的限制。詳情請參閱「準備自訂資料來源的資料」。
如果是結構化資料，每份文件的大小不得超過 500 KB。
無法為具有特定非空白角色的應用程式角色授予
Browse project或安全層級權限。系統不支援依據使用者自訂欄位或群組自訂欄位決定的文件權限。
Jira Cloud 不允許設定任何工作記錄層級的限制。
Jira Cloud 不會為超過 2,000 頁的 PDF 附件建立索引。
新增至私人附註的連結不會沿用附註的存取限制 (ACL)。
系統只會擷取 Jira Cloud 問題的前 20 則留言。
無法擷取梯次資料表。
舊版使用者管理模型不支援與 Jira Cloud 整合。系統僅支援集中式使用者管理模式。詳情請參閱「Atlassian 組織整合指南」。
查詢 Jira 實體 (例如問題) 時，系統不會自動納入相關資料，例如註解和附件。這是因為系統會將這些項目儲存為個別實體並建立索引。系統不支援根據附件內容搜尋父項問題。
後續步驟
- 如要使用 Jira Cloud 建立及設定連接器，請參閱「設定 Jira Cloud 資料儲存庫」。