《Cursor文档》-Jira

通过 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 如何收集、使用和保护您的数据，请参阅我们的隐私政策。