渠道概览与绑定
本页说明外部消息渠道与个人账号绑定的关系，以及管理员完成应用配置后，用户如何授权并绑定自己的渠道账号。
适用对象：渠道配置者和外部聊天平台使用者。
检索关键词：Channel binding、通道绑定、渠道接入、机器人。
1. 渠道绑定能解决什么问题
渠道绑定把您在外部聊天平台的账号与 AE 账号关联起来，让您在熟悉的聊天工具中发起请求，由系统识别您的身份，并在有权限的工作空间中使用 Agent。
- 从外部聊天入口使用 Agent：无需每次回到 AE 页面发起请求。
- 按业务选择执行环境：在普通私聊中选择工作空间和 Agent，后续消息沿用当前选择。
- 分清配置与使用职责：管理员负责接入和启用渠道实例，使用者负责绑定自己的账号；绑定不会自动授予更多资源权限。
同一种平台可以有多个渠道实例。操作时需要同时核对平台和实例名称，不能仅凭“飞书”或“Slack”等平台名判断绑定对象。
2. 绑定前准备与选择渠道实例
前置条件：管理员已在渠道管理中配置对应平台的应用消息渠道。账号绑定用于关联您在外部平台的身份；平台应用配置与个人账号绑定是两个步骤。
确认目标渠道已启用，您已登录正确的 AE 账号，并能使用自己的外部平台账号。新绑定或恢复绑定还需要已有且可用的个人默认空间；绑定操作不会自动创建或修复空间。
- 打开 AE 的用户菜单，进入“渠道绑定”。
- 展开需要使用的平台，找到管理员提供的渠道实例名称。实例较多时可使用列表中的搜索。
- 核对“已绑定”“未绑定”或“停用”等状态，再对目标实例执行绑定或管理操作。
未绑定且已停用、或尚未配置可用绑定方式的实例可能不出现在列表中；已经绑定的实例即使停用仍可能显示。“已绑定”表示身份已关联，不表示渠道当前可接收和执行消息。
3. 完成账号授权或绑定码验证
点击目标实例的“绑定”，按照实际出现的授权窗口或绑定码对话框完成操作。可用方式取决于平台及管理员配置，不是所有渠道都会弹出同一种授权窗口。
| 方式 | 如何完成 | 使用提示 |
|---|---|---|
| 账号授权 | 在打开的授权窗口中核对外部账号和权限，确认授权后返回 AE 查看绑定状态。 | 飞书、Lark、Slack、Discord 使用授权流程；其他部分平台也可在配置后提供授权方式。 |
| 绑定码验证 | 复制对话框提供的完整绑定命令，在对应机器人或接入账号的私聊中发送，等待绑定成功。 | 命令因平台而异：企业微信使用“绑定 绑定码”，钉钉、Mattermost、Google Chat、Zoom Team Chat、WhatsApp 使用“+bind 绑定码”。请直接复制实际生成的命令。 |
| Google Chat 文件授权 | 已绑定但尚未授权原生文件发送时，点击“授权文件”并完成授权；未绑定时可能显示“绑定并授权”。 | 需要管理员先配置相应授权方式。身份绑定与原生文件发送授权不是同一项权限。 |
绑定码仅用于验证本人的外部账号，不要转发给他人或发送到公共群聊。绑定码过期后，请重新发起绑定并使用新命令。完成后回到“渠道绑定”，确认目标实例显示“已绑定”。
Google Chat 多实例注意：同公司存在多个 Google Chat 实例时，当前绑定码流程不能保证绑定到菜单所选实例。优先使用已配置的账号授权方式；如果只能使用绑定码，请先让管理员确认目标实例，不要仅凭绑定成功提示判断绑定对象。
4. 在私聊中选择工作空间与 Agent
以下命令适用于普通私聊。空间选择决定后续请求在哪个工作空间中执行；Agent 选择决定使用哪个助手。选择会保存到当前渠道绑定，后续消息继续沿用，不只是对下一条消息生效。
飞书、Lark、Discord、钉钉、企业微信的会话命令前缀为“/”；Slack、Mattermost、Google Chat、Zoom Team Chat、WhatsApp 为“+”。绑定码命令以绑定弹窗为准，不与这里的会话命令前缀混用。
| 要做什么 | “/”前缀渠道 | “+”前缀渠道 |
|---|---|---|
| 查看可选择的工作空间 | /space | +space |
| 按名称选择工作空间 | /space 空间名称 | +space 空间名称 |
| 恢复个人默认空间 | /space default | +space default |
| 查看可选择的 Agent | /agent | +agent |
| 按名称选择 Agent | /agent Agent名称 | +agent Agent名称 |
| 恢复当前空间的默认 Agent | /agent default | +agent default |
先查看列表，再使用完整名称选择。名称相同导致无法唯一匹配时，需要先区分名称；不要改用空间或 Agent 的 ID。空间必须是您可访问的个人空间或当前公司共享空间，Agent 也必须可见且启用；实际执行还需具备当前空间的运行权限。
- 切换到另一个空间：会在目标空间新建会话，并清除当前绑定中单独选择的 Agent，改用目标空间的默认 Agent。旧会话不会被搬到新空间。
- 切换 Agent：会更新当前绑定的 Agent 选择并重置模型运行上下文；不要假定原来的模型上下文会完整延续。
- 正在排队、运行或等待用户输入时：不能切换空间或 Agent，需先完成或结束当前运行。
- 群聊：不适用上述普通私聊的空间选择规则。个人私聊中的选择不能当作整个群聊的公共设置。
5. 管理绑定与理解权限边界
解绑与重新绑定
在“渠道绑定”中找到已绑定的实例，选择解绑并核对确认提示。一般情况下，解绑解除本人对所选实例的身份关联，不会删除管理员配置的渠道应用。解绑失败时，请根据错误提示处理后重试，不要把关闭对话框当作解绑成功。
Google Chat 当前限制：解绑会解除本人在同公司下的所有 Google Chat 绑定，并清除这些绑定对应的原生文件发送授权，而不只是所选实例。若只想解除其中一个实例，请先联系管理员确认处理方式。
解绑后需要重新完成验证才能继续识别身份。恢复绑定会重新使用个人默认空间，并清除原先单独选择的 Agent；如需其他空间或 Agent，请在绑定后重新选择。如提示外部账号已被其他 AE 用户绑定，请先处理原有绑定，再重试。
绑定不等于获得全部权限
- 渠道停用：即使仍显示“已绑定”，也不能据此判断消息可以执行。请由管理员确认启用状态。
- 空间访问与运行：绑定不能绕过空间成员、公司范围和运行权限；空间或运行环境不可用时，应先恢复访问条件。
- Agent 与能力：仍需满足 Agent 可见性、启用状态，以及工作空间和相关能力的授权要求。绑定不会自动开放所有工具或知识库。
6. 常见问题与下一步
遇到问题时先检查什么
- 找不到渠道实例：确认当前公司、实例名称和管理员配置；未启用或没有可用绑定方式的未绑定实例可能不显示。
- 授权窗口没有打开：检查浏览器是否拦截弹窗，允许后重新发起授权。若窗口已打开但授权失败，核对账号及错误提示。
- 发送绑定命令后没有成功：确认发给正确的机器人或接入账号，命令完整且未过期；过期后重新获取，不要反复发送旧码。
- 显示已绑定但消息无法执行：依次检查渠道是否启用、当前空间是否可访问且可运行、所选 Agent 是否可用。绑定状态只证明身份关联。
- 提示历史绑定缺少工作空间：先确认个人默认空间及其运行环境可用，再解绑并重新绑定。Google Chat 用户解绑前应先阅读上面的多实例影响范围。
- 无法切换空间或 Agent：先结束当前运行，再使用列表中的完整名称重试；同名、无权限、空间停用或运行环境异常都需要先处理。
- Google Chat 可以聊天但不能发送原生附件：检查是否提供“授权文件”入口并完成授权；没有入口时请管理员确认授权配置。