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

# Devin Oncall

> 设置 Devin Oncall，用于调查、修复和缓解告警、缺陷和事件，并依据值班洞察采取行动。

Devin Oncall 会调查、修复并缓解您的告警、缺陷和事件，还会从值班工作中提炼洞察，帮助您采取行动。一旦触发告警、缺陷报告或事件，Devin 便会立即着手处理，利用您的遥测数据、代码、部署、运行手册和过往事件找出根本原因、修复问题，并提交修复 PR。

Oncall 包含三款产品：

* **[Responders](#responders)**：在告警、缺陷报告和支持问题到来时，第一时间进行调查和修复。
* **[Incidents](#incidents)**：找出根本原因并实施缓解，推动每个事件直至解决。
* **[Reports](#reports)**：洞察告警、缺陷和事件背后的成因并据此采取行动，例如调整告警阈值、修复反复出现的同类问题。

<h2 id="setup">
  配置
</h2>

每个组织只需为 Oncall 完成一次性配置。在配置过程中，Devin 会借助您的遥测工具和代码来了解您的系统，并编写技能，供所有 Oncall 会话使用。

1. 在 sidebar 中打开 **Oncall**，然后点击 **Begin setup**。
2. 连接至少一个遥测工具。如果 Devin 的环境中已有可用的遥测工具，可跳过此步骤。
3. 点击 **Finish**。Devin 将开始了解您的系统，这通常需要 1-2 小时。Oncall 准备就绪后，您会收到通知。

配置完成后，即可使用 Responders、Incidents 和 Reports。

<Note>配置需要具备管理 Oncall 的权限。只有组织管理员才能为整个组织连接工具。</Note>

<h3 id="oncall-settings">
  Oncall 设置
</h3>

点击 Oncall 页面顶部的设置齿轮图标，即可打开所有 Oncall 会话共享的配置：

* **指示**：所有 Oncall 会话都会遵循的指导，使用 markdown 编写。你可以把它看作 Oncall 专用的 `AGENTS.md`。
* **技能**：Devin 在配置过程中为您的系统生成的技能。将 **Skill update frequency** 设为 **Weekly** 或 **Monthly** 可让技能保持最新，也可以点击 **Update skills now** 立即更新。

<h2 id="responders">
  响应器
</h2>

响应器会监听某个告警或报告来源，并让 Devin 调查每个新事件。Devin 会将重复事件归并为同一个问题，因此频繁触发的告警只需调查一次。

响应器适用于以下场景：

* 由您的监控工具发布到 Slack 或 Microsoft Teams 频道的生产告警。
* PagerDuty 事件：Devin 会将调查结果以事件备注的形式发布。
* 在 `#eng-bugs` 等频道中提交的缺陷报告和支持问题。

<h3 id="create-a-responder">
  创建响应器
</h3>

1. 在 **Oncall** 页面上，点击 **Create responder**。
2. 输入 **Name**，并选择 **Responder type**。类型创建后无法更改。
3. 添加一个或多个 **Triggers** (触发器) 。
4. 可选地调整会话设置、连接器和运行手册。
5. 点击 **Create responder**。

<Note>运行手册是可选的。Devin Oncall 本身已经懂得如何调查告警和 bug，因此仅当您的团队有特定步骤时才需要添加运行手册。</Note>

<h3 id="responder-types">
  响应器类型
</h3>

告警和缺陷报告的处理方式各不相同，因此每种响应器类型都会运行专为其设计的流程。类型还决定了该响应器的问题在看板上如何跟踪。

| 类型 | 适用场景 | Devin 的工作重点 |
| - | - | - |
| **Alerts** | 生产环境问题告警 | 快速评估影响范围和严重程度，然后找出根本原因并制定缓解措施 |
| **Support + Bugs** | 缺陷报告和支持类问题 | 复现问题、找出根本原因，并在代码中修复 |

<h3 id="triggers">
  触发条件
</h3>

每个响应器一次只监听一个集成，最多可配置 10 个触发条件。只要其中任意一个匹配，Devin 就会响应。

| 来源 | 触发条件 |
| - | - |
| **[Slack](/zh/integrations/slack)** | 频道中的消息，或提及用户组 (例如 `@oncall`) |
| **[Microsoft Teams](/zh/integrations/microsoft-teams)** | 频道中的消息 |
| **[PagerDuty](/zh/integrations/pagerduty)** | 事件被触发、确认、解决或更新 |

可为触发条件添加筛选条件，以缩小 Devin 响应的事件范围。

<h3 id="responder-settings">
  Responder 设置
</h3>

| 设置 | 作用 |
| - | - |
| **Agent 模式** | 此 responder 所启动会话的 Agent 模式 |
| **运行身份** | 会话运行时使用的身份 |
| **Connectors** | 此 responder 可使用的 MCP connector |
| **Runbook** | 可选。Devin Oncall 本身已懂得如何调查告警和 bug。你可以添加团队特有的指导，例如如何划分优先级、在哪里提交问题等 |
| **限额** | ACU 限额和调用次数限额，与[自动化](/zh/product-guides/automations#limits-and-safeguards)中的设置相同 |
| **Advanced** | 网络策略，以及元数据键值对，用于对 responder 进行分类管理并将其与报告相匹配 |

<h2 id="incidents">
  事件
</h2>

事件功能专为习惯为每个事件单独创建 Slack 频道的团队打造。Devin 会加入该频道，定位可能的根本原因，给出缓解建议，并随着事件进展持续调查。它会发布进展更新、在会话串中解答问题，并持续维护事件报告。

<h3 id="enable-incidents">
  启用事件
</h3>

1. 在 **Oncall** 页面中，打开 **Incidents** 选项卡并点击 **Enable incidents**。
2. 开启 **Enable incidents**。
3. 设置事件频道所使用的 **Slack channel prefix**，例如 `incident-`。
4. 选择一种 **Response mode**，然后保存。

Devin 加入名称以该前缀开头的 Slack 频道后，便会开始调查。你可以邀请 Devin 加入频道，也可以开启 **Auto-join incident channels**。

<Note>使用事件功能前，需先为你的组织连接 [Slack](/zh/integrations/slack)。在同一企业中，同一时间只能有一个组织启用事件功能。</Note>

<h3 id="response-modes">
  响应模式
</h3>

| 模式 | 行为 |
| - | - |
| **Proactive** | Devin 先发布可能的根本原因，随后持续调查、发布更新，并维护一份事件报告 |
| **One-shot RCA** | Devin 发布可能的根本原因及其置信度，然后停止。对于你点击了 **Start proactive mode** 的事件，它会作为事件处理队友继续调查 |

<h3 id="incident-settings">
  事件设置
</h3>

| 设置 | 作用 |
| - | - |
| **Auto-join incident channels** | 将 Devin 添加到名称与前缀匹配的新频道。仅支持自动加入 public channels |
| **Allow non-organization users participation** | 允许同一账户下其他组织的成员在事件频道中与 Devin 互动 |
| **Agent mode** | 主事件会话所用的模式。该会话贯穿整个事件过程，负责发布进展更新并维护事件报告 |
| **Initial investigation mode** | 首次调查所用的模式。该调查在事件发生时给出可能的根本原因 |
| **Thread session mode** | 在频道会话线程中回答问题、处理请求的会话所用的模式 |
| **Run as** | 事件会话运行时使用的身份 |
| **Connectors** | 事件会话可使用的 MCP 连接器 |
| **Runbook** | 可选。为每个事件会话提供的指示 |

**Incidents** 选项卡会列出所有事件及对应的会话链接。使用 **Stop** 可让 Devin 停止参与某个事件，使用 **Resume** 可让其恢复参与。

<h2 id="reports">
  报告
</h2>

报告会定期汇总你的值班情况，为你提供可落地的洞察：哪些告警阈值需要调整，哪些反复出现的问题类别需要修复，以及告警、bug 和事件背后的成因。

每份报告还会汇总已识别和已修复的问题、已调查的事件，以及 Devin 创建并合并的 PR。

你可以使用报告进行每周值班交接，也可以将报告的作用域限定到你的团队，例如账单或基础架构团队。

<h3 id="create-a-report">
  创建报告
</h3>

1. 在 **Oncall** 页面中，打开 **Reports** 选项卡，然后点击 **Create report**。
2. 输入 **Name**。
3. 在 **Responders match** 下，选择报告涵盖的响应人员：既可以逐个选择，也可以按元数据匹配。
4. 在 **Incidents match** 下，描述哪些事件应纳入报告。留空则不包含任何事件。
5. 设置 **Schedule**，并可选择添加 **Instructions**，说明报告应包含的内容。
6. 在 **Notifications** 下，选择用于发布报告的 Slack 或 Microsoft Teams 频道。
7. 点击 **Create report**。

报告为共享资源，因此以服务用户身份运行，而非以个人身份运行。打开报告即可查看历史运行实例，也可点击 **Generate report** 立即运行。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.