通過 Cursor 與 Jira 的集成,您可以將 Jira 工作項分配給 Cursor,或在 Jira 中提及 @Cursor,讓 雲端代理 處理這些工作項。
快速入門¶
要求¶
安裝 Jira 集成前,請確保您具備:
- 已啓用 Rovo 的 Jira Commercial Cloud
- 要安裝此應用的 Jira 站點的管理員權限
- 要連接的 Cursor 團隊的管理員權限
- 已連接到 Cursor 的 GitHub、GitLab、Azure DevOps 或 Bitbucket,以便訪問代碼倉庫和 PR
Cursor Jira 集成目前僅適用於 Cursor Teams 和
企業版方案。
Cursor Jira 集成目前不支持 Atlassian HIPAA 或
FedRAMP (包括 政府雲) 實例。
安裝¶
-
以 Cursor 管理員身份前往 Cursor 集成
-
點擊 Jira 旁的 連接
-
繼續前往 Atlassian Marketplace 中的 Cursor 應用頁面
-
點擊 立即獲取
-
選擇要安裝 Cursor 的 Jira 站點,然後點擊 評審
-
查看應用信息,然後點擊 立即獲取
-
安裝完成後,你將進入 Cursor Jira 應用的配置頁面。等待幾分鐘,讓 Atlassian 將安裝通知發送給我們,然後點擊 連接到 Cursor 按鈕。
-
將 Jira 站點連接到你的 Cursor 團隊
- 如果希望啓用用戶級身份驗證 (讓團隊成員能更好地查看和控制其智能體) ,而非使用服務賬戶運行智能體,請打開 要求個人身份驗證 開關。
- 在 Cursor 中完成其餘雲端代理設置:
- 連接 GitHub、GitLab、Azure DevOps 或 Bitbucket
- 啓用基於用量的定價
- 確認隱私設置
- 選擇默認代碼倉庫、模型和基準分支 (在 Cursor 儀表盤的雲端代理設置中)
-
返回 Jira,從工作項中開始使用 Cursor
- 如果啓用了用戶級身份驗證,每位用戶還需要完成下方的更多設置
身份驗證模式¶
啓用 要求個人身份驗證 開關後,您可以在 Cursor Jira 集成的管理員儀表盤中選擇 Jira 對雲端代理進行身份驗證的方式。
| 模式 | 工作方式 | 使用的設置 |
|---|---|---|
| 服務賬戶身份驗證 | 雲端代理使用服務賬戶運行。 | 僅使用團隊的雲端代理設置,包括路由、模型、倉庫和默認值。 |
| 用戶級身份驗證 | 所有云端代理均使用各用戶的賬戶運行。 | 使用各用戶的雲端代理設置,包括路由、模型、倉庫和默認值。用戶還可在自己的賬戶下查看正在運行的智能體。 |
連接各用戶:
- 在 Jira 工作項上啓動一個智能體
- 系統會顯示連接賬戶的提示
- 點擊鏈接,將 Jira 賬戶連接到與團隊關聯的 Cursor 賬戶
- 在 Cursor 中完成剩餘的雲端代理設置:
- 如果尚未連接代碼倉庫提供商,請連接 GitHub、GitLab、Azure DevOps 或 Bitbucket
- 選擇默認倉庫、模型和基準分支 (在 Cursor 儀表盤的 我的設置 雲端代理設置中)
使用方法¶
打開 Jira 工作項,然後將其分配給 Cursor,或在評論中提及 @Cursor。Cursor 會利用工作項的標題、描述、評論和可用的代碼倉庫設置啓動雲端代理。
你可以讓 Cursor 修復缺陷、添加功能、更新測試,或調查工作項中描述的任務。
委派工作項¶
當工單中已清晰說明任務時,可將 Jira 工作項分配給 Cursor。
- 打開 Jira 工作項
- 點擊負責人字段
- 選擇 Cursor
- 查看由該工作項啓動的雲端代理
提及 Cursor¶
如需添加具體指令,請在 Jira 評論中提及 @Cursor。你還可以在同一條評論中指定代碼倉庫、分支或模型。
示例:
@Cursor 請調查此迴歸問題@Cursor repo=acme/backend branch=release 在正式發佈前修復此問題@Cursor model=gpt-5.6-sol 並更新相關測試
後續指示¶
從 Jira 工作項中打開 Rovo chat,繼續與 Cursor 對話。
狀態更新和交接¶
雲端代理啓動後,Jira 會在工作項中顯示智能體狀態。Cursor 會在處理過程中發佈進度,並在任務完成後提供摘要。
如果 Cursor 創建了 PR,完成狀態更新會附上該 PR 的鏈接,供評審使用。
配置¶
在儀表盤 -> Cloud Agents的_團隊設置_或_我的設置_中管理默認設置和隱私選項。
設置¶
默認模型¶
當 Jira 工作項或評論中未指定模型時,將使用此模型。有關可用選項,請參閱設置。
代碼倉庫選擇¶
Cursor 會根據以下信息選擇代碼倉庫:
- 顯式值:Jira 評論或工作項中的
repo、branch或model值 - 工作項內容:標題、描述和評論中的倉庫名稱、服務名稱或關鍵詞
- 路由規則:自定義關鍵詞到倉庫的映射
- 最近的智能體活動:你最近使用過的倉庫
- 默認代碼倉庫:未找到匹配項時使用的後備選項
如需使用特定代碼倉庫,請在評論中指定。例如:@Cursor repo=acme/mobile-app fix the login bug。你的團隊服務賬戶或用戶賬戶 (取決於你啓用的模式) _必須_有權訪問此代碼倉庫,否則將無法啓動雲端代理。
基準分支¶
雲端代理使用的起始分支。留空則使用代碼倉庫的默認分支 (推薦) 。
分支前綴¶
雲端代理創建的分支名稱前綴。
選項¶
使用 @Cursor 提及時,可通過以下選項自定義雲端代理行爲:
| 選項 | 描述 | 示例 |
|---|---|---|
repo |
指定代碼倉庫 | repo=acme/web-app |
branch |
指定基準分支 | branch=main |
model |
指定模型 | model=opus |
路由規則¶
通過路由規則,您可以定義自動映射到特定倉庫的關鍵字。當 Jira 工作項或評論包含特定關鍵字時,Cursor 會將雲端代理路由到相應的代碼倉庫。
路由規則可讓您指定智能體應根據哪些項目、工作項、關鍵字和其他數據,爲不同工作項選擇相應的倉庫。
設置路由規則¶
- 前往 儀表盤 -> Cloud Agents
- 找到 路由規則 部分
- 添加關鍵詞與代碼倉庫的映射關係
示例規則¶
| 關鍵字 | 代碼倉庫 |
|---|---|
frontend |
acme/web-app |
mobile |
acme/mobile-app |
api |
acme/backend-services |
docs |
acme/documentation |
配置這些規則後:
- 標題爲
Fix the frontend nav bug的工作項將被路由到acme/web-app - 包含
@Cursor update the mobile onboarding flow的評論將被路由到acme/mobile-app - 包含
@Cursor add rate limiting to the api的評論將被路由到acme/backend-services
路由規則如何生效¶
Cursor 會按以下順序評估 Jira 工作項和評論:
- 顯式值:Jira 評論或工作項中的
repo、branch或model值 - 工作項內容:標題、描述和評論中的倉庫名稱、服務名稱或關鍵詞
- 路由規則:自定義關鍵詞到倉庫的映射
- 最近的智能體活動:你最近使用過的倉庫
- 默認代碼倉庫:未找到匹配項時使用的後備選項
隱私¶
雲端代理支持隱私模式。
不支持隱私模式 (舊版) 。雲端代理運行期間需要臨時存儲
代碼。
權限¶
安裝過程中,Jira 會顯示 Cursor app 所請求的權限。Cursor 使用這些權限來:
- 識別啓動或管理雲端代理的 Jira 用戶
- 讀取工作項的字段、描述、評論及相關上下文
- 發佈狀態更新、完成摘要和 PR 鏈接
- 在工作項被分配給 Cursor 或提及
@Cursor時接收事件
安裝 app 前,請先在 Atlassian Marketplace 中查看權限提示。
常見問題¶
支持哪些 Jira 站點?¶
Cursor Jira 集成支持已啓用 Rovo 的 Atlassian 商業雲站點。不支持 Atlassian HIPAA、FedRAMP 和政府雲實例。
是否需要啓用按用量計費?¶
需要。雲端代理需要啓用按用量計費。在 Cursor 中完成雲端代理設置時,請啓用按用量計費。
誰可以安裝 Jira 集成?¶
同時擁有 Jira 管理員和 Cursor 團隊管理員權限的用戶需要完成初始設置。
用戶需要關聯自己的 Cursor 賬戶嗎?¶
這取決於您選擇的身份驗證模式。服務賬戶身份驗證會通過一個服務賬戶運行所有云端代理,並使用團隊設置。用戶級身份驗證會將每位 Jira 用戶與 Cursor 關聯,用戶可在 Cursor 儀表盤中查看從 Jira 啓動的正在運行的雲端代理,並使用各自的路由、模型、倉庫和默認設置。
Cursor 創建 PR 前還需要設置什麼?¶
將 GitHub、GitLab、Azure DevOps 或 Bitbucket 連接到 Cursor,並確保雲端代理設置中包含團隊要使用的倉庫、模型和基準分支。
用戶如何繼續與 Cursor 對話?¶
在 Jira 工作項中打開 Rovo chat,即可繼續與 Cursor 對話。或者,在 Cursor 中打開雲端代理並繼續對話。
免責聲明¶
Cursor 可能會出錯。請仔細覈對代碼和回覆。
隱私政策¶
有關 Cursor 如何收集、使用和保護您的數據,請參閱我們的隱私政策。