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 來識別問題，並可修改摘要、說明和指派對象等各種欄位。 |
| 變更問題狀態 | 變更 Jira Cloud 中現有問題的狀態。您必須提供問題 ID 才能識別問題。 |
必要範圍
如要讓 Gemini Enterprise 使用 Jira Cloud 資料儲存庫執行搜尋和動作，您需要下列範圍：
如要讓 Gemini Enterprise 使用 Jira Cloud 資料儲存庫執行搜尋和動作，您需要下列範圍：
傳統範圍
| 連線模式 | 權限 | 目的 |
|---|---|---|
| 聯合搜尋和動作 | read:jira-user、read:jira-work |
允許助理即時擷取及顯示搜尋結果和使用者詳細資料。 |
write:jira-work |
允許助理修改工作項目 (例如更新問題欄位)，以及管理留言或問題。 | |
| 僅限聯合搜尋 | read:jira-user、read:jira-work |
允許助理搜尋及查看問題、專案和使用者設定檔。 |
| 資料擷取和動作 | read:jira-work |
允許助理對工作項目執行廣泛的資料檢索和建立索引作業。 |
write:jira-work |
允許助理在擷取的環境中，對工作項目執行寫入動作 (建立、更新、註解)。 | |
| 資料擷取 | read:jira-work |
允許 Google 助理檢索 Jira 內容並建立索引，以便搜尋。 |
精細範圍
| 連線模式 | 權限 | 目的 |
|---|---|---|
| 聯合搜尋和動作 | write:comment:jira |
允許資料商店直接從搜尋介面發布新留言或回覆。 |
write:issue:jira |
允許資料儲存庫建立新問題，或對現有問題進行重大編輯。 | |
write:attachment:jira |
允許資料儲存庫將附件新增至 Jira 議題。 | |
read:issue:jira |
允許資料存放區讀取問題。 | |
read:issue-type:jira |
允許資料儲存庫讀取問題類型。 | |
read:comment:jira |
允許資料儲存庫讀取留言。 | |
read:comment.property:jira |
允許資料存放區讀取問題留言屬性。 | |
read:project:jira |
允許資料存放區讀取專案。 | |
read:priority:jira |
允許資料儲存庫讀取優先順序。 | |
read:issue.transition:jira |
允許資料儲存庫讀取問題轉移。 | |
read:issue-meta:jira |
允許資料存放區讀取問題中繼資料。 | |
read:board-scope.admin:jira-software |
允許資料存放區讀取看板的設定、專案功能、篩選器、屬性和快速篩選器。 | |
read:board-scope:jira-software |
允許資料存放區讀取看板、看板上的問題、待處理事項中的問題、報表和版本。 | |
read:issue-details:jira |
允許資料存放區讀取問題詳細資料。 | |
read:jql:jira |
允許資料儲存庫讀取 Jira 查詢語言 (JQL) 查詢。 | |
| 僅限聯合搜尋 | read:issue:jira |
允許資料存放區讀取問題。 |
read:issue-type:jira |
允許資料儲存庫讀取問題類型。 | |
read:comment:jira |
允許資料儲存庫讀取留言。 | |
read:comment.property:jira |
允許資料存放區讀取問題留言屬性。 | |
read:project:jira |
允許資料存放區讀取專案。 | |
read:priority:jira |
允許資料儲存庫讀取優先順序。 | |
read:issue.transition:jira |
允許資料儲存庫讀取問題轉移。 | |
read:issue-meta:jira |
允許資料存放區讀取問題中繼資料。 | |
read:board-scope.admin:jira-software |
允許資料存放區讀取看板的設定、專案功能、篩選器、屬性和快速篩選器。 | |
read:board-scope:jira-software |
允許資料存放區讀取看板、看板上的問題、待處理事項中的問題、報表和版本。 | |
read:issue-details:jira |
允許資料存放區讀取問題詳細資料。 | |
read:jql:jira |
允許資料儲存庫讀取 Jira 查詢語言 (JQL) 查詢。 | |
| 資料擷取和動作 | 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:comment:jira |
允許使用資料儲存區在問題中新增留言。 | |
write:issue:jira |
允許助理建立或修改問題。 | |
| 資料擷取 | 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 資料儲存庫僅支援
global、us和eu位置。
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 資料儲存庫」。