Agents
认识 Agents
理解 Agent 在 SoniBot 中的职责，以及它与助手、模型、技能和 MCP 的关系。
Agent 是实际执行任务的运行引擎。它负责理解输入、与模型通信、请求权限、调用工具，以及在项目工作空间中读写文件。
Agent 不等于助手
| 层级 | 作用 | 常见配置 |
|---|---|---|
| Agent | 提供运行时与执行协议 | 命令路径、认证、环境变量、运行参数 |
| 模型 | 提供推理能力 | 模型名称、服务商、思考强度 |
| 助手 | 封装一个可直接使用的角色 | Agent、规则、默认模型、权限、技能、MCP |
| 技能 | 提供特定任务的方法与资源 | SKILL.md、脚本、参考资料、模板 |
| MCP | 提供可调用的外部工具 | MCP 服务、工具列表、连接状态 |
一个 Agent 可以被多个助手复用。例如，同一个内置 Agent 可以同时承载“研究助手”和“Excel 助手”，两者拥有不同的规则和技能。
Agent 来源
SoniBot 当前管理两类面向用户的 Agent：
- 官方或自动检测的 Agent：包括随应用提供的内置 Agent，以及 SoniBot 在本机发现的兼容 CLI；
- 自定义 Agent：由你提供名称、启动命令、参数与环境变量，以 ACP 兼容方式接入。
产品支持的 CLI 名单会随版本和本机环境变化。以“设置 → Agents”中实际检测到的列表为准，不要仅凭文档中的示例判断可用性。
状态含义
| 状态 | 含义 | 下一步 |
|---|---|---|
| 可用 / Online | 命令存在，运行时探测成功 | 可绑定到助手并创建会话 |
| 缺失 / Missing | 找不到命令或必要组件 | 安装对应 CLI，或修正命令路径 |
| 离线 / Offline | 命令存在，但认证或初始化失败 | 查看诊断信息，完成登录或配置 |
| 待检查 / Unchecked | 尚未完成实时健康检查 | 点击“测试连接”或刷新列表 |
“已检测到”不代表已经完成认证。Agent 可能存在于本机，但仍需要登录、API Key 或其他服务商配置。
如何选择
- 第一次使用或不想维护 CLI 时，优先选择 SoniBot 内置 Agent；
- 已经在终端中使用某个 CLI，并希望保留它的能力与配置时，选择对应 Agent；
- 团队任务需要多个运行时并行时，先在 Agents 页面逐一测试可用性；
- 涉及敏感目录或不可逆操作时，优先使用需要逐次确认的权限模式。
接下来可以检测、配置与测试 Agent，或添加自定义 Agent。