OpenAgent
配置 OpenAgent 服务根地址与 API 密钥，供 OpenDesk 服务端代理调用机器人能力
简述
OpenAgent 用于在本租户内绑定 OpenAgent 服务根地址（Base URL） 与 API 密钥。OpenDesk 服务端将凭此配置代为访问 OpenAgent 开放接口，供 渠道管理 中 Web SDK 的机器人接待、Agent 列表拉取、对话与转人工等能力使用。密钥 仅保存在服务端，页面不回显完整密钥，请勿向无关人员泄露。
功能位置
在管理后台侧边栏「全局设置」分组下打开「OpenAgent」。页面自上而下为标题、说明文案、OpenAgent Base URL 输入框、API 密钥 密码框，以及 保存、连接测试 按钮。
配置与规则
Base URL
- 必填；须为以
http://或https://开头的有效地址。 - 保存前会自动去除首尾空格与末尾
/。 - 长度不超过 512 个字符；格式不合法时字段下方提示「请输入以 http 或 https 开头的有效地址」。
API 密钥
- 首次绑定 时必填；保存成功后密钥框清空，占位提示变为「已配置，变更请重新输入」。
- 已配置后 若仅修改 Base URL、不更换密钥，可 留空提交，表示不更新当前密钥。
- 支持点击输入框右侧图标 显示/隐藏 密钥；长度不超过 512 个字符。
- 连接测试时：若未重新输入密钥，将使用服务端已保存的密钥参与校验。
保存与连接测试
- 点击 保存：通过校验后写入租户配置；成功提示「已保存」，失败时展示错误原因。
- 点击 连接测试：由 OpenDesk 服务端使用当前表单中的地址与可用密钥发起连通性校验；成功提示「连接成功」，失败提示「连接失败，请检查配置」。
- 保存或测试进行中，按钮显示加载态并防止重复点击。
注意事项
- 未完成本页配置时，渠道管理 中 Web SDK「服务配置」的 启用 OpenAgent 机器人 将无法保存，并提示「请先完成 OpenAgent 对接配置」，可点击 前往配置 跳转本页。
- 连接测试与后续业务调用均经 OpenDesk 服务端转发，前端不直连 OpenAgent，避免密钥暴露。
- 修改 Base URL 后建议执行 连接测试，并在 渠道管理 中刷新 Agent 列表，确认可选 Agent 仍有效。
- 访问本页须具备 管理 OpenAgent 配置 权限（在 角色管理 中勾选对应管理后台权限）。
与其他功能的关系
- 渠道管理（Web SDK · 服务配置）：启用机器人接待前依赖本页；Agent 下拉列表由已保存的 Base URL 与密钥拉取，仅展示 启用中 的 Agent。
- 对话路由、默认队列设置、员工组管理：访客从机器人 转人工 后，按渠道人工服务时间与队列配置进入人工接待；本页不直接配置转人工规则。
- 服务时间：渠道人工服务时间、机器人服务时间均在渠道侧引用 服务时间 方案，与本页连接配置相互独立。
业务场景示例
官网接入智能客服机器人
角色与目标：管理员希望在官网 Web SDK 渠道先由 OpenAgent 机器人接待，复杂问题再转人工。
系统配置：在 OpenAgent 填写 OpenAgent 部署地址与 API 密钥，连接测试 通过后 保存；再在 渠道管理 编辑对应 Web SDK，于「服务配置」中启用 OpenAgent 机器人并选择 Agent。
场景效果：访客打开对话窗口后先与机器人交互；满足渠道配置的转人工条件时，可进入人工排队与接待流程。