跳转到主要内容

​
设置集成

  1. 在 app.devin.ai 的 Devin 账户中，前往 Settings > Integrations > Jira，然后点击“Connect”。
  2. 你将被重定向到 Jira，在那里查看权限并授予 Devin 访问权限。
  3. 连接完成后，在设置页面配置你的 playbook 标签，并可选设置 自动化触发器。
连接后，我们建议连接一个 服务账户，这样 Devin 的评论将显示为机器人发布，而不是显示为你的个人账户。请参阅下方的连接服务账户。

​
如何从 Jira 中触发 Devin

有四种方式可以从 Jira 工单中发起 Devin 会话：

​
将工单分配给 Devin

直接在 Jira 中将工单分配给 Devin 服务账户。Devin 将使用你在 Jira 集成设置 中配置的默认 playbook开始处理该工单。

​
添加 playbook 标签

给工单添加一个 playbook 标签 (例如 !plan、!implement、!triage) 。Devin 会使用与该标签匹配的特定 playbook 启动一个会话。这些标签对应于你在集成设置中配置的 playbook 标签。你需要在 Jira 项目中手动创建这些标签——从集成设置中复制标签名称。

​
添加 “devin” 标签

为任意 Jira 问题 添加 devin 标签 (你可能需要先在 Jira 项目中创建此标签) 。Devin 将使用默认 playbook开始处理该工单。
该集成采用单词边界匹配 (不区分大小写) ，因此任何将 devin 作为独立单词包含在内的标签都会触发它——例如 devin、Devin、devin-workshop 或 devin-task。而像 devinworkshop 或 devin_workshop 这样把 “devin” 作为更长单词一部分的标签，则不会触发。

​
在评论中提及 Devin

在工单评论中提及 @Devin 并提供具体指示。Devin 将开启一个会话，并将你的评论作为任务指示，且不会应用 playbook。如果该工单已存在会话，你的消息将被转发到现有会话。

​
配置集成

​
会话模式

会话模式开关用于控制 Devin 如何响应 Jira 触发：
  • 直接创建会话 (默认启用) ：Devin 会创建一个完整会话并处理该工单，同时将进展更新回传到 Jira。
  • 仅做范围界定 (已禁用) ：Devin 只会分析工单，并发布一条范围界定评论，其中包含摘要、实施计划和置信度评估。然后，你可以点击提供的链接手动启动会话。

​
Playbook 标签

Playbook 标签可让你控制哪些 Devin playbooks 可作为 Jira 标签使用。添加 playbook 后，其宏 (例如 !plan) 会成为一个标签，你可以将其分配给 Jira 问题，以通过该 playbook 触发 Devin。标签必须在你的 Jira 项目中手动创建——请从集成设置中复制标签名称。
  • 默认 playbook：其中一个 playbook 会被标记为默认项。当某个问题在没有特定 playbook 标签的情况下被触发时 (例如仅使用 devin 标签，或将该问题分配给 Devin) ，Devin 会使用这个默认 playbook。
  • 添加 playbooks：点击“添加 playbook”以添加更多 playbooks。只有带有宏的 playbook 才能添加。
  • 移除 playbooks：移除某个 playbook 后，其标签将不再作为触发条件使用。

​
自动化触发器

自动化触发器可让 Devin 在工单满足特定条件时自动开始处理，无需手动分配或添加标签。你可以根据以下条件配置触发器：
  • Projects：仅对特定 Jira 项目中的工单激活。
  • Labels：仅当工单带有特定标签时激活。
  • Statuses：仅当工单进入特定状态时激活 (例如 “To Do”、“In Progress”) 。
  • Playbook：可选指定 Devin 在触发的会话中应使用哪个 playbook。
触发器采用边沿检测机制，这意味着只有当工单从“不匹配”变为“匹配”触发条件时才会激活 (例如添加标签或状态发生变化时) ，而不会对已匹配的工单激活。

​
Enterprise：Jira 项目映射

对于拥有多个 Devin 组织的 Enterprise 部署，管理员可以将 Jira 项目映射到特定的 Devin 组织。这样可确保每个 Jira 项目的工单都会被路由到对应的 Devin 组织。要使 Jira 集成在 Enterprise 环境中正常工作，必须配置此映射。

​
在 Jira 中与 Devin 交互

一旦 Devin 开始处理某个工单，它就会通过 Jira 反馈进展：
  • PR 链接：当 Devin 创建拉取请求时，PR URL 会自动作为远程链接添加到 Jira 问题 中，并以评论形式发布。
  • 会话链接：系统会提供一个指向 Web 应用中 Devin 会话的直接链接，便于你实时跟踪进度。
  • 后续消息：在评论中提及 @Devin，即可向 Devin 提供额外指示或提出问题。

​
连接服务账户

使用管理员账户连接 Jira 后，你还可以选择通过 OAuth 2.0 客户端凭据连接服务账户。这样，Devin 的评论将以专用机器人身份显示，而不是显示在你的个人账户下。
  1. 在你的 Atlassian 组织的管理员设置中，使用以下 Classic scopes 创建一个 OAuth 2.0 服务账户：
    • read:me
    • read:jira-user
    • read:jira-work
    • write:jira-work
  2. 在 Settings > Integrations > Jira 中，点击 Connect service account，然后输入客户端 ID 和客户端密钥。