> ## 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.

# PagerDuty 集成

> 将 PagerDuty 连接到 Devin，即可由事件触发自动化，并让 Devin 会话访问事件、服务和值班计划。

连接 PagerDuty 后，事件一旦触发，Devin 就能立即着手处理。PagerDuty 事件可触发 Devin [自动化](/zh/product-guides/automations)，而 PagerDuty MCP 服务器则让 Devin 会话能够访问事件、服务和值班计划。

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

1. 在 PagerDuty 中，前往 **Integrations > API Access Keys**，点击“Create New API Key”。创建一个具有完全访问权限的 **General Access** 密钥并复制。不接受用户 API 令牌。
2. 在 app.devin.ai 的 Devin 账户中，前往 [Settings > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty)，然后点击“Connect”。
3. 选择你的 **API region** (美国或欧盟) ，然后填写：
   * **Actor email**：Devin 的事件备注和更新将归属于此 PagerDuty 用户，建议使用专用的服务用户。
   * **General Access REST API key**：你在步骤 1 中创建的密钥。
4. 点击“Connect”。Devin 会自动在 PagerDuty 中创建 webhook 订阅，以接收事件通知。

<div id="configure-webhook-subscriptions">
  ## 配置 webhook 订阅
</div>

连接后，Devin 会在 PagerDuty 中创建一个账户级的 webhook 订阅，用于将以下事件发送给 Devin：

* `incident.triggered`
* `incident.acknowledged`
* `incident.resolved`
* `incident.priority_updated`
* `incident.reassigned`
* `incident.service_updated`

设置页面的 **Webhook** 部分会显示该订阅的状态。如果自动设置失败，请点击“Retry webhook setup”，或手动添加 webhook：

1. 在 **Webhook** 部分，点击“Add webhook”并复制 webhook URL。
2. 在 PagerDuty 中，前往 **Integrations > Generic Webhooks (v3)**，添加一个指向该 URL 的 webhook，并将作用域设置为 **Account**。
3. 选择上面列出的事件类型。
4. 复制 PagerDuty 仅显示一次的签名密钥，粘贴到 Devin 中，然后点击“Save”。

<Note>
  断开 PagerDuty 连接会停止事件推送，并删除 Devin 创建的 webhook 订阅，但不会移除 PagerDuty MCP 服务器。
</Note>

<div id="setting-up-the-pagerduty-mcp-server">
  ## 设置 PagerDuty MCP 服务器
</div>

PagerDuty MCP 服务器通过 OAuth 让每位成员登录。PagerDuty 不支持自动注册 OAuth 客户端，因此需要由 Admin 在 PagerDuty 中注册一个 OAuth app，并将其 client ID 和 secret 提供给 Devin。

<div id="register-an-oauth-app-in-pagerduty">
  ### 在 PagerDuty 中注册 OAuth app
</div>

1. 在 [Settings > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty) 中，点击 **MCP 服务器** 部分的“Set up with OAuth”。复制设置页面上显示的 **OAuth callback URL**。
2. 在 PagerDuty 中，前往 **Integrations > App Registration**，点击“New App”。输入名称 (例如 `Devin`) ，并选择 **OAuth 2.0**。
3. 选择 **Scoped OAuth**，并将 Devin 提供的 OAuth callback URL 添加为 **Redirect URL**。
4. 在权限作用域中，选择所有 **Read Access** 作用域。Devin 不需要写入权限。
5. 复制 **Selected Permission Scope** 的值，安装 MCP 服务器时需要填写。
6. 完成 app 注册，然后复制 **client ID** 和 **客户端密钥**。

<div id="install-the-mcp-server">
  ### 安装 MCP 服务器
</div>

1. 在 Devin 设置页面，选择你所在区域对应的 **server URL**：美国 (`mcp.pagerduty.com`) 或欧盟 (`mcp.eu.pagerduty.com`) 。
2. 填入 PagerDuty 应用的 **OAuth client ID** 和 **OAuth 客户端密钥**。
3. 将 PagerDuty 应用中的 **Selected Permission Scope** 值粘贴到 **OAuth scope** 中。
4. 保存安装配置。

<Note>
  PagerDuty 的 MCP 访问始终为个人级别，Devin 不会为其使用共享的组织令牌。每位成员都必须先连接自己的 PagerDuty 用户账户，Devin 才能在其会话中使用 PagerDuty 工具。
</Note>

<div id="connecting-your-pagerduty-user-account">
  ## 连接你的 PagerDuty 用户账户
</div>

除了组织级集成外，每位团队成员还需将自己的 PagerDuty 账户关联到 Devin 账户。这样 Devin 就能以该成员的身份使用 PagerDuty MCP 服务器。创建 PagerDuty 自动化同样需要完成此关联。

要连接你的用户账户，请前往 [Personal Connections](https://app.devin.ai/account/connections)，点击 PagerDuty 旁边的“Connect”，并在 PagerDuty 中授权访问。请使用你的组织所连接的那个 PagerDuty 账户下的用户。

<div id="triggering-devin-from-pagerduty">
  ## 从 PagerDuty 触发 Devin
</div>

Devin 通过[自动化](/zh/product-guides/automations)开始处理 PagerDuty 事件。连接 PagerDuty 后，你无需为每个自动化单独设置 webhook。

1. 进入 **Automations**，创建一个新的自动化。
2. 添加触发器，选择 **PagerDuty**，然后选择一个事件：
   * **Incident triggered**：新事件被创建。
   * **Incident acknowledged**：有人确认了某个事件。
   * **Incident resolved**：某个事件已解决。
   * **Incident updated**：某个事件的优先级、指派或服务发生变更。
3. 可根据需要添加条件，缩小匹配的事件范围：
   * **Service**、**Team** 和 **Priority**：选项从你的 PagerDuty 账户加载。
   * **Urgency** (`high` 或 `low`) 和 **Status**。
   * **Title**、**Escalation policy** 和 **Assignee**。
   * **Change** (`priority`、`assignment` 或 `service`) ：仅适用于 **Incident updated**。
4. 添加 **Start session** 动作，写明给 Devin 的指示，然后保存。

例如，若要排查结账服务上的高紧急度事件，可使用 **Incident triggered** 事件，并设置条件 **Service** 为 `checkout-api`、**Urgency** 为 `high`。然后添加类似这样的提示："调查此事件。检查 checkout-api 最近的部署和错误日志，找出可能的根本原因。"

<Note>
  要创建或编辑带有 PagerDuty 触发器的自动化，你必须先[连接你的 PagerDuty 用户账户](#connecting-your-pagerduty-user-account)。你的 PagerDuty 用户必须属于你的组织所连接的那个 PagerDuty 账户。
</Note>