Agents
检测、配置与测试 Agent
在 Agent 管理页查看运行时状态、完成认证并验证连接。
打开 Agent 管理
进入“设置 → Agents”。页面包含自动检测的 Agent 和自定义 Agent，并提供搜索以及“全部 / 可用 / 不可用”筛选。
SoniBot 会在启动和刷新时读取运行时目录。刚安装 CLI 后如果没有立即出现，请先重新打开设置页；仍未出现时再重启 SoniBot。
配置步骤
- 在列表中找到目标 Agent；
- 查看卡片上的状态和诊断信息；
- 点击配置或修复入口；
- 按该 Agent 的要求完成登录、API Key、命令路径或环境变量配置；
- 返回列表，点击“测试连接”；
- 确认状态变为可用，再将它绑定到助手。
测试连接会执行一次真实的运行时初始化探测，而不只是检查文件是否存在。因此，“命令可执行但未登录”通常会显示为离线，而不是可用。
常见诊断
找不到 Agent
- 在系统终端中确认对应命令可以运行；
- 如果 CLI 由版本管理器安装，确认 SoniBot 进程能继承同样的
PATH； - 自定义 Agent 请使用可靠的绝对命令路径，避免依赖只在交互式 Shell 中存在的别名；
- 安装后刷新列表或重启应用。
需要认证
- 在系统终端中完成该 CLI 官方提供的登录流程；
- 如果使用环境变量，确认变量名正确且只对目标 Agent 生效；
- 不要把 API Key 写进对话、项目文件或可提交的脚本。
测试超时或离线
- 先在终端运行一次目标 CLI，排除首次安装确认和升级提示；
- 检查代理、证书、公司网络和模型服务是否可达；
- 查看 Agent 卡片的错误信息，再修复最先出现的问题；
- 确认模型或账号有权限创建新会话。
配置变更的影响
- Agent 状态会影响绑定它的助手是否可用；
- 修改命令、参数或环境变量后，新启动的运行时使用新配置；
- 已经运行的会话可能保留原进程，必要时新建会话验证；
- 删除自定义 Agent 前，先检查卡片上显示的“已绑定助手”。
“自动允许”会跳过部分或全部操作确认。只有在工作目录、命令和任务范围都可信时才启用，并避免对含重要数据的宽目录使用。