连接器 — 接入知识库的外部渠道
连接器把您的客户与同事已经在使用的信息渠道 — WhatsApp、Telegram、Discord、Slack — 连接到与内部聊天相同的知识库。对话保留在您的服务器上：应用使用管理员填写的凭据调用渠道的 API，回答则来自文档知识库。
连接器把您的客户与同事已经在使用的信息渠道 — WhatsApp、Telegram、Discord、Slack — 连接到与内部聊天相同的知识库。对话保留在您的服务器上：应用使用管理员填写的凭据调用渠道的 API，回答则来自文档知识库。
仅 Enterprise 版可用（Community 许可证中connectors_enabled: false— Community 管理面板显示 UpgradePrompt；参见 Administration）。参考：packages/shared/src/schemas/connector.schema.ts（表单字段）、packages/server/src/routes/connectors.ts（限制 + 路由）、CHANGELOG.mdv0.28.1、packages/shared/src/constants/license.ts。来源行：FACT-CENSUS.mdF-CONN-1、F-CONN-2、F-LIC-1。
创建连接器
路径：Settings → Conversations → Connectors（New connector 按钮）。表单要求：
| 字段 | 说明 |
|---|---|
| 名称 | 连接器实例的标识符 |
| 平台 | telegram、discord、slack、whatsapp — 创建后不可变 |
| 机器人令牌 / 凭据 | 渠道的机密令牌 — 创建后不可变（仅创建时填写；PUT 不触碰） |
| Workspace | 绑定的 workspace，不可变 |
| 知识档案绑定 | 为回答供料的文档档案 |
| 欢迎消息 | 渠道向新到的对话发送的第一条消息（最多 4000 字符） |
| 兜底消息 | 搜索找不到有效来源时的回复（最多 4000 字符） |
| Fallback locale | 兜底消息的语言 |
| Rate limit | 0 = 不限（路由的哨兵值），N = 最多 N 次请求 |
| Daily session limit | 0 = 不限，N = 每天最多 N 个会话 |
档案的决定即决定语料库：从渠道而来的每个问题都会经过与内部聊天相同的 RAG 流水线（混合检索、来源引用、综合摘要）— 引用后的答复原路发送回来源渠道。
编辑连接器（v0.28.1）
管理面板中的连接器卡片带有一个溢出菜单，其第一项为 Edit：打开一个在可变表面上预填充的对话框：
- 通过 `PUT /api/connectors/:id` 可变：名称、档案绑定、欢迎/兜底消息、fallback locale、rate limit、daily session limit（留空 = null；
0= 不限）。 - 按架构不可变：平台、机器人令牌、workspace。更换渠道或令牌 = 新建连接器。
isEnabled开关保留在卡片上（Switch）；Telegram 的pollMode保留在 webhook 按钮上。- PUT 记录审计事件
chat_connector.updated（与 DELETE 分支同级）。
平台适配器
每个平台由专用适配器承载，各自使用自己的注册凭据：
| 平台 | 凭据 | 说明 |
|---|---|---|
| Telegram | 机器人令牌（@BotFather） | 同时支持轮询模式与 webhook（卡片上的专用按钮） |
| Discord | 机器人令牌（Developer Portal）+ 消息 intents | 适配器读取该机器人被授权的频道 |
| Slack | 机器人令牌 + signing secret（Slack app） | 消息事件经已配置的 webhook 传递 |
| Business API 供应商（机密令牌） | 适配器调用供应商的 API |
凭据经服务器传输并保留在服务器上；创建后，机密令牌绝不在界面中回显。
限制与兜底消息
Rate limit 与 daily session limit 保护 workspace 不受外部流量影响：0 = 不限；N = 每个连接器的上限。兜底消息（带有可配置的 fallback locale）是语料库检索产生不出可引用内容时的回复 — 在配置了兜底时，外部渠道永远不会收到没有来源的回答。
停用与审计
isEnabled（卡片上的 Switch）暂停路由，但不删除配置。- 连接器的 DELETE 是一个独立且经审计的操作（事件
chat_connector.deleted，与updated同级）。 - 所有针对连接器的管理操作都会进入事件日志（参见 Administration）。
无需触碰服务器即可激活 Enterprise 版
Enterprise 许可证只需在面板中粘贴密钥（Settings → Security → License，GET/PUT/DELETE /api/license/instance）：probe-first 验证密钥（invalid/expired/plugin_bound/community_tier — 被拒绝的密钥绝不持久化）、SystemConfig 中的 AES-256-GCM 密文、运行时经 setCachedLicense 应用。参见 API reference；F-LIC-1。
本指南介绍连接器适配器的操作面；工程深潜见孪生博文：
Provenance
| 章节 | 来源 |
|---|---|
| 版本级开关 / UpgradePrompt | packages/shared/src/constants/license.ts（connectors_enabled）— F-CONN-1 |
| Edit 表面 + 不可变项 + 审计 | CHANGELOG.md v0.28.1（Added, Q1-quick；许可证见 Phase 221）— F-CONN-2, F-LIC-1 |
| 表单字段 / 限制 | packages/shared/src/schemas/connector.schema.ts（welcomeMessage/fallbackMessage 最多 4000、fallbackLocale、rateLimitPerMinute/sessionLimitPerDay - limiter 将 0 译为不限） |
---
运维参考 — Simmetric Chat v0.28.1（文档更新于 2026-10-02，普查 SHA `aca5b8ff`）。