Connector：连接外部系统
Connector 提供可复用的外部系统能力。
Connector 提供可复用的外部系统能力。添加并完成授权或配置后，会形成属于当前用户的连接（Connection）；连接测试成功后才可调用。
v1.0.1 中，同一用户对同一个 Connector 只有一个 Connection。重新授权、更新凭证或切换账户会更新这条连接，不会保留多个并存账户。不同 Connector 可以分别添加并拥有各自的连接。
添加并测试连接
- 打开“探索（Explore）→ Connectors”，查看目标卡片与详情中的能力标识、能力说明和授权要求。
- 点击“添加（Add）”，在安装弹窗核对 Connector 名称、能力及所需配置，并明确确认添加。
- 根据声明完成下表中的流程。
- 系统执行“测试连接（Test Connection）”。核对连接状态与测试结果；只有通过测试后，Connector 才进入可调用状态。
| 授权要求 | 首次添加 | 后续维护 |
|---|---|---|
| 无授权（No Authorization） | 确认后直接测试连接 | 检查连接状态并按需重新测试 |
| 静态凭证（Static Credential） | 在安全表单填写声明的字段，例如 API Key、Access Token 或用户名／密码组合；完成必填项后提交 | 使用“更新配置（Update configuration）”，重新填写所需凭证并测试 |
| OAuth 2.0 | 点击“继续授权（Continue to Authorize）”，在外部页面完成授权并返回原 Connector 详情 | 使用“重新授权（Reconnect）”，检查返回后的账户摘要和测试结果 |
无授权表示不需要凭证，不是第三种凭证类型。OAuth Connector 不要求手工填写 OAuth Token。
安全填写和更新凭证
字段名称、类型、说明和必填规则由当前 Connector 的安全表单提供。不要将密钥、Token 或密码发送到普通聊天消息。
- 静态凭证保存后，配置区显示 Configured 与更新时间。再次编辑时敏感字段为空，不回显旧值。
- 保存期间等待处理完成，避免重复提交。失败时可在当前弹窗重试或取消；关闭或刷新会清除未提交的值。
- “由管理员配置（Configured by Admin）”的字段仅显示
****，用户无法复制、编辑、替换或清除；需要修改时联系管理员。 - 配置保存成功只说明凭证已提交，仍需检查真实连接测试结果。
为 Skill 绑定 Connector
在 Skill 配置中，为每项 Connector Requirement 明确选择能力匹配的 Connector。如果尚未添加或授权，完成引导后返回 Skill 配置，确认绑定。仅添加 Connector 不会自动为所有 Skill 完成绑定。
Skill 运行时只使用其绑定的 Connection。该连接失效后进入“等待授权（Awaiting Authorization）”，不会自动改用其他 Connector。已经授权且可用的 Connector 也可直接供智能体调用，不要求必须安装一个专门的 Skill；调用仍受用户权限及其能力范围约束。
维护、断开和移除
- 从探索齿轮进入用户能力管理，打开 Connectors 分类中的目标卡片。
- 检查非敏感账户摘要、Connection Status、最近检查时间，以及使用该连接的 Connector Binding。
- 按凭证类型选择 Update configuration 或 Reconnect，完成后运行 Test Connection，重新读取状态。
- 要停止连接，选择“解绑（Disconnect）”。连接变为已断开，凭证被撤销或删除，依赖它的 Skill 会等待授权。
- 要移除整个 Connector，选择“移除（Remove）”，检查受影响绑定并确认。系统解除绑定、断开连接并移除安装；后续相关 Skill 需重新授权。Policy Locked 的能力不提供移除。
也可从左下角账号菜单的“凭证管理（Credential Management）”集中查看和维护各 Connector 的凭证状态。该列表与 Connector 配置页使用同一连接状态，不提供凭证明文查看或导出。
常见问题
授权取消或失败后怎么办？
OAuth 返回未授权状态时，可重试授权；此时不会形成可调用连接。静态凭证失败时按非敏感错误提示检查表单并重试。
已填写凭证但连接失败怎么办？
查看 Test Connection 的错误原因，核对外部账户、所需权限和服务可用性；按类型更新配置或重新授权后再测试。持续失败时向管理员提供非敏感错误及发生时间。
切换账户会保留旧账户供选择吗？
不会。同一 Connector 复用原 Connection 并替换账户摘要与凭证。切换前检查当前绑定，确认依赖该连接的技能应使用新账户。
可以添加 MCP 连接吗？
v1.0.1 不支持 MCP 分类、配置、连接管理或能力发现。