消息渠道接入手册
AGI 通过「消息渠道」与外界交互。本手册详细介绍渠道的类型与协议、接入配置与授权、消息路由与权限以及渠道的日常管理，帮助你安全、稳定地把智能体接入到常用入口。
01渠道类型与协议
AGI 支持将智能体接入多种消息渠道。不同的渠道对应不同的协议与接入方式，请根据你的使用场景选择。
| 渠道类型 | 接入方式 | 典型用途 |
|---|---|---|
| 本机会话 | 本地界面直接对话 | 设备端直接使用，离线可用 |
| Web 控制台 | 浏览器访问控制台 | 远程管理、直观查看状态 |
| 消息服务 | 通过自有消息服务 / API 接入 | 将智能体接入自定义消息入口 |
ℹ️ 本地优先
无论采用哪种渠道，模型推理与核心数据均运行在本地设备端。渠道仅负责传输消息，不承载模型与数据。
02接入配置与授权
接入渠道时需要提供连接信息并完成授权。以下是通用流程。
- 添加渠道进入「消息渠道」页面，点击「添加渠道」，选择渠道类型。
- 填写连接信息按类型填写接入地址、令牌、密钥或回调地址等连接信息。
- 验证连通性点击「测试连接」，确认 AGI 能够与渠道正常握手。
- 保存并启用保存配置并启用渠道，之后即可通过该渠道对话。
03消息路由与权限
接入多个渠道后，可通过路由与权限规则控制消息的处理方式与可执行动作。
路由规则
- ①多渠道并行：同一智能体可同时服务多个渠道，消息按到达顺序处理。
- ②会话隔离：不同渠道对应的会话上下文相互隔离，避免串扰。
- ③优先级：可配置高优先级渠道优先处理关键指令。
权限控制
- ①授权范围：每个渠道可配置允许调用的技能与系统操作范围。
- ②凭据管理：渠道凭据加密存储于本地，仅用于连接校验。
- ③敏感操作：涉及设备敏感操作时，需二次确认后方可执行。
04渠道管理
已接入的渠道可在「消息渠道」页面统一管理。
- 查看状态查看每个渠道的连接状态、最近活动与错误信息。
- 编辑与重新授权需要更换凭据或调整权限时，编辑渠道配置并重新授权。
- 暂停 / 启用暂时不需要时暂停渠道，需要时重新启用，无需删除配置。
- 删除渠道彻底移除不再使用的渠道，删除后该渠道的会话与配置一并清除。
05常见接入问题
🔌 连接不稳定
请检查网络环境、接入地址与令牌是否有效。对于远程渠道，确认防火墙与端口已正确放行。
🔒 凭据泄露风险
切勿将渠道令牌、密钥等凭据明文存储或发送。若怀疑凭据泄露，请立即在渠道管理页重置并重新授权，并参照数据自持机制中的本地加密原则处理。