> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> 将 Jira 任务指派给 Devin，并将其转为 PR

<div id="setting-up-the-integration">
  ## 设置集成
</div>

1. 在 app.devin.ai 的 Devin 账户中，前往 [Settings > Connections > Jira](https://app.devin.ai/settings/connections/jira)，然后点击“Connect”。
2. 你将被重定向到 Jira，在那里查看权限并授予 Devin 访问权限。
3. 连接完成后，在设置页面配置你的 **playbook 标签**，并可选设置 **自动化触发器**。

<Tip>
  连接后，我们建议连接一个 **服务账户**，这样 Devin 的评论将显示为机器人发布，而不是显示为你的个人账户。请参阅下方的[连接服务账户](#connecting-a-service-account)。
</Tip>

<div id="how-to-trigger-devin-from-jira">
  ## 如何从 Jira 中触发 Devin
</div>

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

<div id="assign-the-ticket-to-devin">
  ### 将工单分配给 Devin
</div>

直接在 Jira 中将工单分配给 Devin 服务账户。Devin 将使用你在 [Jira 集成设置](https://app.devin.ai/settings/connections/jira) 中配置的**默认 playbook**开始处理该工单。

<div id="add-a-playbook-label">
  ### 添加 playbook 标签
</div>

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

<div id="add-the-devin-label">
  ### 添加 "devin" 标签
</div>

为任意 Jira 问题 添加 `devin` 标签 (你可能需要先在 Jira 项目中创建此标签) 。Devin 将使用**默认 playbook**开始处理该工单。

<Note>
  该集成采用单词边界匹配 (不区分大小写) ，因此任何将 **devin** 作为独立单词包含在内的标签都会触发它——例如 `devin`、`Devin`、`devin-workshop` 或 `devin-task`。而像 `devinworkshop` 或 `devin_workshop` 这样把 “devin” 作为更长单词一部分的标签，则不会触发。
</Note>

<div id="mention-devin-in-a-comment">
  ### 在评论中提及 Devin
</div>

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

<div id="configuring-the-integration">
  ## 配置集成
</div>

<div id="session-mode">
  ### 会话模式
</div>

会话模式开关用于控制 Devin 如何响应 Jira 触发：

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

<div id="playbook-labels">
  ### Playbook 标签
</div>

Playbook 标签可让你控制哪些 Devin [playbooks](/zh/product-guides/using-playbooks) 可作为 Jira 标签使用。添加 playbook 后，其宏 (例如 `!plan`) 会成为一个标签，你可以将其分配给 Jira 问题，以通过该 playbook 触发 Devin。标签必须在你的 Jira 项目中手动创建——请从集成设置中复制标签名称。

* **默认 playbook**：其中一个 playbook 会被标记为默认项。当某个问题在没有特定 playbook 标签的情况下被触发时 (例如仅使用 `devin` 标签，或将该问题分配给 Devin) ，Devin 会使用这个默认 playbook。
* **添加 playbooks**：点击“添加 playbook”以添加更多 playbooks。只有带有宏的 playbook 才能添加。
* **移除 playbooks**：移除某个 playbook 后，其标签将不再作为触发条件使用。

<div id="automation-triggers">
  ### 自动化触发器
</div>

自动化触发器可让 Devin 在工单满足特定条件时自动开始处理，无需手动分配或添加标签。你可以根据以下条件配置触发器：

* **Projects**：仅对特定 Jira 项目中的工单激活。
* **Labels**：仅当工单带有特定标签时激活。
* **Statuses**：仅当工单进入特定状态时激活 (例如 "To Do"、"In Progress") 。
* **Playbook**：可选指定 Devin 在触发的会话中应使用哪个 playbook。

触发器采用**边沿检测**机制，这意味着只有当工单从“不匹配”变为“匹配”触发条件时才会激活 (例如添加标签或状态发生变化时) ，而不会对已匹配的工单激活。

<div id="enterprise-jira-project-mapping">
  ### Enterprise：Jira 项目映射
</div>

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

<div id="interacting-with-devin-in-jira">
  ## 在 Jira 中与 Devin 交互
</div>

一旦 Devin 开始处理某个工单，它就会通过 Jira 反馈进展：

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

<div id="connecting-a-service-account">
  ## 连接服务账户
</div>

使用管理员账户连接 Jira 后，你还可以选择通过 OAuth 2.0 客户端凭据连接服务账户。这样，Devin 的评论将以专用机器人身份显示，而不是显示在你的个人账户下。

1. 在你的 Atlassian 组织的管理员设置中，使用以下 **Classic scopes** 创建一个 OAuth 2.0 服务账户：
   * `read:me`
   * `read:jira-user`
   * `read:jira-work`
   * `write:jira-work`
2. 确保该服务账户具有 Jira 的 **User** 应用角色。在 [Atlassian Admin](https://admin.atlassian.com) 中，前往 **Directory > Service accounts**，选择该服务账户，点击 **⋯ > Allow access**，并将 Jira 角色设置为 **User**。你也可以在首次创建服务账户时进行此设置。没有此角色，服务账户将无法访问 Jira 资源。
3. 在 [Settings > Connections > Jira](https://app.devin.ai/settings/connections/jira) 中，点击 **Connect service account**，然后输入客户端 ID 和客户端密钥。