Jira

通过 Cherri Code 与 Jira 的集成，您可以将 Jira 工作项分配给 Cherri Code，或在 Jira 中提及 @Cherri Code，让 云端代理 处理这些工作项。

快速入门

要求

安装 Jira 集成前，请确保您具备：

• 已启用 Rovo 的 Jira Commercial Cloud
• 要安装此应用的 Jira 站点的管理员权限
• 要连接的 Cherri Code 团队的管理员权限
• 已连接到 Cherri Code 的 GitHub、GitLab、Azure DevOps 或 Bitbucket，以便访问代码仓库和 PR

安装

1. 以 Cherri Code 管理员身份前往 Cherri Code 集成

2. 点击 Jira 旁的 连接

3. 继续前往 Atlassian Marketplace 中的 Cherri Code 应用页面

4. 点击 立即获取

5. 选择要安装 Cherri Code 的 Jira 站点，然后点击 评审

6. 查看应用信息，然后点击 立即获取

7. 安装完成后，你将进入 Cherri Code Jira 应用的配置页面。等待几分钟，让 Atlassian 将安装通知发送给我们，然后点击 连接到 Cherri Code 按钮。

8. 将 Jira 站点连接到你的 Cherri Code 团队

   • 如果希望启用用户级身份验证 (让团队成员能更好地查看和控制其智能体) ，而非使用服务账户运行智能体，请打开 要求个人身份验证 开关。

9. 在 Cherri Code 中完成其余云端代理设置：

   • 连接 GitHub、GitLab、Azure DevOps 或 Bitbucket
   • 启用基于用量的定价
   • 确认隐私设置
   • 选择默认代码仓库、模型和基准分支 (在 Cherri Code 仪表盘的云端代理设置中)

10. 返回 Jira，从工作项中开始使用 Cherri Code

    • 如果启用了用户级身份验证，每位用户还需要完成下方的更多设置

身份验证模式

启用 要求个人身份验证 开关后，您可以在 Cherri Code Jira 集成的管理员仪表盘中选择 Jira 对云端代理进行身份验证的方式。

连接各用户：

1. 在 Jira 工作项上启动一个智能体
2. 系统会显示连接账户的提示
3. 点击链接，将 Jira 账户连接到与团队关联的 Cherri Code 账户
4. 在 Cherri Code 中完成剩余的云端代理设置：
   • 如果尚未连接代码仓库提供商，请连接 GitHub、GitLab、Azure DevOps 或 Bitbucket
   • 选择默认仓库、模型和基准分支 (在 Cherri Code 仪表盘的 我的设置 云端代理设置中)

使用方法

打开 Jira 工作项，然后将其分配给 Cherri Code，或在评论中提及 @Cherri Code。Cherri Code 会利用工作项的标题、描述、评论和可用的代码仓库设置启动云端代理。

你可以让 Cherri Code 修复缺陷、添加功能、更新测试，或调查工作项中描述的任务。

委派工作项

当工单中已清晰说明任务时，可将 Jira 工作项分配给 Cherri Code。

1. 打开 Jira 工作项
2. 点击负责人字段
3. 选择 Cherri Code
4. 查看由该工作项启动的云端代理

提及 Cherri Code

如需添加具体指令，请在 Jira 评论中提及 @Cherri Code。你还可以在同一条评论中指定代码仓库、分支或模型。

示例：

• @Cherri Code 请调查此回归问题
• @Cherri Code repo=acme/backend branch=release 在正式发布前修复此问题
• @Cherri Code model=gpt-5.6-sol 并更新相关测试

后续指示

从 Jira 工作项中打开 Rovo chat，继续与 Cherri Code 对话。

状态更新和交接

云端代理启动后，Jira 会在工作项中显示智能体状态。Cherri Code 会在处理过程中发布进度，并在任务完成后提供摘要。

如果 Cherri Code 创建了 PR，完成状态更新会附上该 PR 的链接，供评审使用。

配置

在仪表盘 -> Cloud Agents的_团队设置_或_我的设置_中管理默认设置和隐私选项。

设置

默认模型

当 Jira 工作项或评论中未指定模型时，将使用此模型。有关可用选项，请参阅设置。

代码仓库选择

Cherri Code 会根据以下信息选择代码仓库：

1. 显式值：Jira 评论或工作项中的 repo、branch 或 model 值
2. 工作项内容：标题、描述和评论中的仓库名称、服务名称或关键词
3. 路由规则：自定义关键词到仓库的映射
4. 最近的智能体活动：你最近使用过的仓库
5. 默认代码仓库：未找到匹配项时使用的后备选项

如需使用特定代码仓库，请在评论中指定。例如：@Cherri Code repo=acme/mobile-app fix the login bug。你的团队服务账户或用户账户 (取决于你启用的模式) _必须_有权访问此代码仓库，否则将无法启动云端代理。

基准分支

云端代理使用的起始分支。留空则使用代码仓库的默认分支 (推荐) 。

分支前缀

云端代理创建的分支名称前缀。

选项

使用 @Cherri Code 提及时，可通过以下选项自定义云端代理行为：

Cherri Code 会忽略代码块中的选项，并原样保留提示词中的代码。

路由规则

通过路由规则，您可以定义自动映射到特定仓库的关键字。当 Jira 工作项或评论包含特定关键字时，Cherri Code 会将云端代理路由到相应的代码仓库。

路由规则可让您指定智能体应根据哪些项目、工作项、关键字和其他数据，为不同工作项选择相应的仓库。

设置路由规则

1. 前往 仪表盘 -> Cloud Agents
2. 找到 路由规则 部分
3. 添加关键词与代码仓库的映射关系

示例规则

配置这些规则后：

• 标题为 Fix the frontend nav bug 的工作项将被路由到 acme/web-app
• 包含 @Cherri Code update the mobile onboarding flow 的评论将被路由到 acme/mobile-app
• 包含 @Cherri Code add rate limiting to the api 的评论将被路由到 acme/backend-services

路由规则如何生效

Cherri Code 会按以下顺序评估 Jira 工作项和评论：

1. 显式值：Jira 评论或工作项中的 repo、branch 或 model 值
2. 工作项内容：标题、描述和评论中的仓库名称、服务名称或关键词
3. 路由规则：自定义关键词到仓库的映射
4. 最近的智能体活动：你最近使用过的仓库
5. 默认代码仓库：未找到匹配项时使用的后备选项

隐私

云端代理支持隐私模式。

详细了解隐私模式，或管理您的隐私设置。

权限

安装过程中，Jira 会显示 Cherri Code app 所请求的权限。Cherri Code 使用这些权限来：

• 识别启动或管理云端代理的 Jira 用户
• 读取工作项的字段、描述、评论及相关上下文
• 发布状态更新、完成摘要和 PR 链接
• 在工作项被分配给 Cherri Code 或提及 @Cherri Code 时接收事件

安装 app 前，请先在 Atlassian Marketplace 中查看权限提示。

常见问题

支持哪些 Jira 站点？

Cherri Code Jira 集成支持已启用 Rovo 的 Atlassian 商业云站点。不支持 Atlassian HIPAA、FedRAMP 和政府云实例。

是否需要启用按用量计费？

需要。云端代理需要启用按用量计费。在 Cherri Code 中完成云端代理设置时，请启用按用量计费。

谁可以安装 Jira 集成？

同时拥有 Jira 管理员和 Cherri Code 团队管理员权限的用户需要完成初始设置。

用户需要关联自己的 Cherri Code 账户吗？

这取决于您选择的身份验证模式。服务账户身份验证会通过一个服务账户运行所有云端代理，并使用团队设置。用户级身份验证会将每位 Jira 用户与 Cherri Code 关联，用户可在 Cherri Code 仪表盘中查看从 Jira 启动的正在运行的云端代理，并使用各自的路由、模型、仓库和默认设置。

Cherri Code 创建 PR 前还需要设置什么？

将 GitHub、GitLab、Azure DevOps 或 Bitbucket 连接到 Cherri Code，并确保云端代理设置中包含团队要使用的仓库、模型和基准分支。

用户如何继续与 Cherri Code 对话？

在 Jira 工作项中打开 Rovo chat，即可继续与 Cherri Code 对话。或者，在 Cherri Code 中打开云端代理并继续对话。

免责声明

Cherri Code 可能会出错。请仔细核对代码和回复。

隐私政策

有关 Cherri Code 如何收集、使用和保护您的数据，请参阅我们的隐私政策。