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

# Pylon 集成

> 将 Pylon 连接到 Devin，即可将支持工单升级给工程团队、将问题交给 Devin 会话处理，并通过 Pylon 事件触发自动化。

<Note>
  Pylon 集成目前处于 Beta 阶段。如需申请访问权限，请联系 [mitchell.tan@cognition.ai](mailto:mitchell.tan@cognition.ai)。
</Note>

借助 Pylon 集成，你可以直接在 Pylon 中启动 Devin 会话、询问代码库相关问题并触发自动化。Devin 会将会话进展同步回关联的 Pylon 问题。

连接 Pylon 后，你可以：

* **委派问题**：从 Pylon 问题启动会话，工单内容会自动纳入上下文。
* **提问**：在 Pylon 中询问与代码库相关的问题。你还可以允许没有 Devin 账户的人员提问。
* **触发自动化**：在问题被创建、添加标签或状态变更时自动启动会话。
* **使用 Pylon 工具**：允许 Devin 读取问题、账户和联系人信息，还可按需为问题和账户开启写入权限。

<Warning>
  客户支持工单属于不可信内容，可能包含提示注入攻击。连接该集成时，Devin 会自动创建一个限制性的 [Pylon 安全 Profile](#security-profile)。启用工作流程前，请先检查该配置。
</Warning>

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

你必须同时是 Pylon 和 Devin 的 Admin，才能连接此集成。

1. 前往 [Settings > Connections > Pylon](https://app.devin.ai/settings/connections/pylon)，然后点击 **Connect**。
2. 登录 Pylon，并授权 Devin 访问。
3. 返回 Devin，检查[访问控制](#access-control)设置，并启用所需的功能。
4. 检查自动创建的 [Pylon 安全 Profile](#security-profile)，确认其适用于你的工作流程。

此连接通过 Pylon 托管的 MCP 服务器提供内置工具，无需另行安装 Pylon MCP。

<Note>
  如果使用 Enterprise 套餐，请在主组织中管理 Pylon，相关设置将应用于整个企业。如果你的企业下有多个组织，请在使用此集成前，先在[会话路由](#session-routing)中选择一个组织。
</Note>

<h2 id="connecting-your-pylon-user-account">
  关联你的 Pylon 用户账户
</h2>

将你的 Pylon 账户关联到你的 Devin 账户，这样交给 Devin 处理的会话就会记在你名下。

前往 [Settings > Connections > Pylon](https://app.devin.ai/settings/connections/pylon) 并点击 **Link user profile**，或在 [Personal Connections](https://app.devin.ai/account/connections) 中关联你的账户。

<h2 id="access-control">
  访问控制
</h2>

在 Pylon 连接页面中配置以下设置。

| 设置 | 作用 |
| - | - |
| **用户匹配** | **Pylon-connected users only** 要求每位成员[关联其 Pylon 账户](#connecting-your-pylon-user-account)。**Email or Pylon-connected user** 还会识别 Pylon 邮箱与某个 Devin 账户成员邮箱一致的发送者。 |
| **无 Devin 账户也可提问** | 允许没有 Devin 账户的人提问。回答仅基于已建立索引的仓库，不会修改代码、执行命令或调用工具。如果 Enterprise 套餐下有多个组织，请在 **If not linked, route to** 中选择负责回答的组织。 |
| **Pylon 自动化触发器** | 允许 Pylon 事件[触发自动化](#triggering-devin-from-pylon)。 |
| **Pylon MCP 访问** | **Read only** 允许会话读取 Pylon 问题、账户和联系人。**Read and write** 还允许会话创建问题，并更新问题和账户字段。 |
| **Pylon 后续消息** | 允许 Pylon 机器人将更新 (例如客户的新回复) 转发到已关联的 Devin 会话。 |

<Note>
  Devin 的 Pylon 工具无法创建客户消息草稿，也无法回复客户。写入操作仅限于问题和账户字段。
</Note>

<h3 id="security-profile">
  安全 Profile
</h3>

连接 Pylon 后，系统会创建一个名为 **Pylon 安全 Profile** 的 Profile，并将其设为委派会话的默认 Profile。企业账户会获得一个共享的企业 Profile；其他账户则获得一个组织 Profile。

该 Profile 的初始设置如下：

| 设置 | 默认值 |
| - | - |
| **网络访问** | 除 Devin 必需的目标地址和已允许的 MCP 连接外，还允许访问 `usepylon.com` 和 `*.usepylon.com`。其他出站流量一律阻止。 |
| **Git 访问** | 只读：Devin 可以克隆和拉取仓库，但不能推送分支或创建拉取请求。 |
| **Devin MCP 访问** | 只读：Devin 可以读取自身资源，但不能创建子会话，也不能修改 playbooks 等资源。 |
| **GitHub CLI 令牌** | 不提供给会话。 |
| **MCP 服务器允许列表** | 不受此 Profile 限制。**Devin MCP 只读**并不会使第三方 MCP 工具变为只读；Pylon 的写入操作由 **Pylon MCP 访问** 单独控制。 |
| **强制级别** | [强制](/zh/product-guides/security-profiles#mandatory-vs-recommended-enforcement)。 |

如需更改所选 Profile，请在 Pylon 连接页面中使用 **Security → Default 安全 Profile**。如需编辑该 Profile 的限制，请打开[安全 Profile](/zh/product-guides/security-profiles)。上述操作分别需要具备在组织级别或企业级别管理安全 Profile 的权限。重新连接 Pylon 不会覆盖现有的 Profile 修改和默认选择。

**适用范围：**

* **委派会话**在创建时使用已配置的 Pylon 默认 Profile。
* **自动化**有各自独立的 Profile 选择。添加 Pylon 触发器时，如果你有权选择已配置的 Pylon Profile，且尚未选择其他 Profile 或选择不使用 Profile，编辑器会自动预选该 Profile。保存前请检查该自动化的 **安全 Profile**。更改 Pylon 默认 Profile 不会替换自动化中已保存的 Profile。
* **仅提问**类问题使用已索引的仓库，不会启动基于虚拟机的会话。

你可以选择其他 Profile、继承组织或企业默认值，或选择不使用 Profile。但 Profile 层级中其他位置的强制限制仍然有效。

<Note>
  默认的 Pylon Profile **不**允许创建拉取请求。如果你的工作流程需要此功能，须由获得授权的 Admin 配置合适的 Git 访问权限。若复现问题时需要下载依赖或调用外部服务，可能还需添加额外的网络目标地址。请仅授予工作流程所需的最小权限。
</Note>

<h3 id="session-routing">
  会话路由
</h3>

会话路由**仅适用于 Enterprise 套餐**。在 **会话路由** 下，选择用于运行 Pylon 会话的 **组织**。拥有多个组织的 Enterprise 账户必须先选择一个组织，才能使用该集成；在此之前，Pylon 事件将一律被拒绝。单组织账户会自动使用其所属组织。

<h2 id="working-with-devin-in-pylon">
  在 Pylon 中使用 Devin
</h2>

<h3 id="delegate-an-issue">
  将问题交给 Devin
</h3>

在 Pylon 问题右侧打开 Devin 面板，然后描述任务。该工单已自动纳入上下文，你还可以附加截图或日志文件。

要使用完整会话，你需要拥有一个可通过[用户匹配](#access-control)识别的 Devin 账户，且该账户有权访问所选组织。如果不满足任一条件，Devin 会在问题中说明原因。

Devin 会将其计划、命令、文件编辑、拉取请求和会话链接发布到该问题中。当它暂停并等待回复时，也会通知你。这些更新会自动发布，无需配置 Pylon 触发器。

* **跟进**：在该问题的 Devin 会话线程中回复，补充更多指示。
* **归档**：回复 `archive` (或 `@Devin archive`) 即可归档该会话。
* **在其他位置继续**：在 Devin Web 应用中，或在 Pylon 关联的 Slack 会话线程中继续使用同一会话。

<h3 id="ask-about-your-codebase">
  询问代码库相关问题
</h3>

在 Pylon 中提出代码库相关问题，例如“webhook 签名验证是如何工作的？”Devin 会基于已建立索引的仓库直接作答，无需启动完整会话，也不会做出任何更改。如需让没有 Devin 账户的人员也能使用此功能，请启用 **无 Devin 账户也可提问**。

<h3 id="slack-threads">
  Slack 会话线程
</h3>

[连接 Slack](/zh/integrations/slack)，并邀请 Devin 加入你的升级处理频道。Devin 可以监听与 Pylon 问题关联的 Slack 会话线程，并在会话中接收其中的回复。在受监听的会话线程中回复 `@Devin archive`，即可归档该会话。

<h2 id="triggering-devin-from-pylon">
  从 Pylon 触发 Devin
</h2>

使用[自动化](/zh/product-guides/automations)，即可通过 Pylon 事件启动会话。首先，在[访问控制](#access-control)中启用 **Pylon 自动化触发器**。

1. 前往 **自动化**，创建一个新的自动化。
2. 添加触发器，选择 **Pylon**，然后选择一个事件：
   * **问题已创建**：有新问题提交时触发。可选择按 **Title** 进行过滤。
   * **Tag added**：问题被添加标签时触发。选择要匹配的 **Added Tag**。
   * **状态已更改**：问题变为某个状态时触发。选择要匹配的 **Status**。
3. 添加 **Start session** action，并为 Devin 编写指示。
4. 检查该自动化的[安全 Profile](#security-profile)、网络访问和工具，然后保存。

以下两个模板可帮助你快速上手：

* **Triage Customer Bug Tickets**：调查新提交的问题，尝试复现 bug，并向支持团队报告发现项。
* **Investigate Support Escalations**：调查已添加标签的问题，尝试复现 bug，提出修复建议，并在内部 Slack 会话线程中报告发现项。

<Tip>
  建议仅在添加升级标签时触发，而不是每个新问题都触发，以免常规工单进入工程工作流程。
</Tip>

<h2 id="escalating-support-tickets-to-engineering">
  将支持工单升级给工程团队
</h2>

典型的升级流程如下：

1. 客户在 Pylon 中报告问题。
2. Pylon 技能或基于问题类型的 AI 检测识别出一个具备足够复现细节的 bug，并添加升级标签。
3. 该标签触发 Devin 自动化。
4. Devin 读取工单，检查已连接的日志和监控工具，并尝试复现故障。如果安全 Profile 允许，Devin 还可以创建 pull request。
5. Devin 将发现项发布到 Slack，并在 Pylon 问题中发布进度更新。
6. 工程师审查调查结果，并在 Slack 会话线程中跟进。

<h3 id="set-up-the-pylon-side">
  配置 Pylon 端
</h3>

使用 Pylon 技能或基于问题类型的 AI 检测，为需要升级处理的工单添加标签，并在 Devin 自动化的 **Added Tag** 过滤器中使用同一标签。对于缺少复现细节的 bug 和非 bug 类工单，请分别定义不同的处理路径。

<h3 id="set-up-the-devin-automation">
  设置 Devin 自动化
</h3>

1. 打开[自动化模板库](https://app.devin.ai/automations/templates)，选择 **Investigate Support Escalations**。
2. 在预配置的 **Pylon → Tag added** 触发器中，将 **Added Tag** 设置为你的升级标签。
3. 检查提示和[安全 Profile](#security-profile)。该模板会指示 Devin 调查根本原因、尝试复现问题、提出修复建议，并在 Pylon 的内部 Slack 会话线程中报告发现项。
4. 按下文说明配置 Slack 访问权限，然后点击 **Create automation**。

只列出 Devin 能够访问的工具和仓库。接入 [Datadog](/zh/enterprise/integrations/datadog) 或 [Sentry](/zh/enterprise/integrations/sentry) 等可观测性工具，让会话能够检查生产环境的运行情况。

<h3 id="post-findings-in-pylons-internal-slack-thread">
  在 Pylon 的内部 Slack 会话线程中发布发现项
</h3>

一种常见的工作流程是：先让 Pylon 将工单摘要发布到内部 Slack 频道，再由 Devin 在同一会话线程中回复其发现项。

1. [连接 Slack](/zh/integrations/slack)，并邀请 Devin 加入 Pylon 发布消息的内部频道。
2. 为该自动化配置 **Slack** 工具，并授予其该频道的访问权限。
3. 在自动化提示中，指示 Devin 在 Pylon 创建的会话线程中发布发现项，而不是另发一条新的顶层消息。**Investigate Support Escalations** 模板已包含此指令：

   > 如果某个频道中存在 Pylon 已发布过更新的内部 Slack 会话线程，请找到该顶层会话线程，并在其中发布你的发现项。

<h3 id="automatic-updates-in-pylon">
  Pylon 中的自动更新
</h3>

当发生特定事件 (例如创建 pull request) 时，该集成会自动在关联的 Pylon 问题中发布内部备注。你无需为这些备注配置 Pylon 触发器。

<h4 id="optional-custom-pylon-triggers">
  可选的自定义 Pylon 触发器
</h4>

如需在内置更新之外执行其他操作，可在 Pylon 的触发器构建器中搜索 **devin**，找到以下条件：

* Devin 创建了 pull request
* Devin 合并了 pull request
* Devin 关闭了 pull request
* Devin 正在等待回复

你可以利用这些条件，在 pull request 创建时更新问题状态，在其合并后通知账户负责人，或在 Devin 需要回复时将问题指派给相关人员。有关 Pylon 端的配置，请参阅[通过 Devin 实现 Agent 间升级](https://support.usepylon.com/articles/6981171768-agent-to-agent-escalation-via-devin)。

<h2 id="disconnecting-pylon">
  断开 Pylon 连接
</h2>

前往 [Settings > Connections > Pylon](https://app.devin.ai/settings/connections/pylon)，点击 **Disconnect** 并确认。断开后，Pylon 事件将不再触发 Devin 自动化。


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