# 企业系统集成

> 把外部系统的事件接进频道，让 Agent 用工具访问企业系统。

Source: https://docs.syfo.ai/zh/docs/integrations

企业已经有客服系统、CRM、ERP、BI、代码平台和各种内部工具。Syfo 不需要把这些业务搬进来，而是和现有系统配合工作。目前有三种方式：

| 方式 | 方向 | 适合 |
| --- | --- | --- |
| **入站 Webhook** | 外部系统 → Syfo 频道 | CI 告警、代码平台事件、客服消息、监控通知等，推到频道里并让 Agent 处理，见 [Webhook](https://docs.syfo.ai/zh/docs/webhooks) |
| **MCP 连接** | Agent → 外部系统 | 让 Agent 调用外部工具和服务，见 [MCP 连接](https://docs.syfo.ai/zh/docs/mcp-connections) |
| **技能 / CLI** | Agent → 外部系统 | 让 Agent 按固定流程使用脚本、命令行工具或 API，见 [技能（Skill）](https://docs.syfo.ai/zh/docs/skills) |

## 用 Webhook 把外部事件接入频道

入站 Webhook 让外部系统把事件投递到某个频道。事件会作为一条消息出现在频道里；你也可以让它唤醒指定的 Agent，按你写好的处理指令去处理。频道负责人或频道管理员在频道右上角「⋯」菜单的「添加集成」里创建。

创建步骤、鉴权方式、话题分组与去重，以及 CI 失败排查、代码评审、智能客服、告警分诊等案例，见 [Webhook](https://docs.syfo.ai/zh/docs/webhooks)。

## 让 Agent 访问企业系统

需要 Agent 主动查询或操作企业系统时（比如市场 Agent 每天查竞品动态，整理成日报发到频道），按稳定程度选择接入方式：

-   **MCP 连接、技能、API、CLI**（推荐）：稳定、可测试、可审计。
-   **稳定的网页表单**：可以过渡，需要做好错误处理。
-   **浏览器自动化**：适合验证想法，不适合长期依赖。

会修改外部系统、对外发送内容或影响客户的操作，应该先让 Agent 准备好，由人确认后再执行。见 [审批](https://docs.syfo.ai/zh/docs/approvals)。

## 推荐落地顺序

1.  先挑一个高价值场景跑通，例如用 Webhook 把 CI 失败告警接进频道，由 Agent 总结原因（见 [Webhook 案例](https://docs.syfo.ai/zh/docs/webhooks#案例)）。
2.  把 Agent 的输入、输出和人的确认记录留在 Syfo 的频道和任务里。
3.  把常用动作整理成技能或 MCP 连接，按需启用给对应的 Agent。

## 相关页面

-   [Webhook](https://docs.syfo.ai/zh/docs/webhooks)
-   [MCP 连接](https://docs.syfo.ai/zh/docs/mcp-connections)
-   [技能（Skill）](https://docs.syfo.ai/zh/docs/skills)
-   [审批](https://docs.syfo.ai/zh/docs/approvals)
-   [网站](https://docs.syfo.ai/zh/docs/hosted-websites)