Agent 设置
在不影响现有工作资料的前提下，确认客户端识别了哪些 Agent；确有需要时，为某个 Agent 调整配置目录，或在开发者模式下创建并验证自定义 Agent。
- 普通用户可以查看已检测到的 Agent，并从卡片进入新会话。
- 新建、克隆和编辑自定义 Agent 属于开发者功能；没有明确的 CLI 与 ACP 配置来源时，不要开启后照抄未知命令。
- 修改配置目录前，先确认目录属于当前 Agent，且不包含不应由它读取的其他账号资料。
- 打开客户端“设置”，在左侧“AI 核心”区域选择“Agents”。
- 在“本地 Agents”中查看“已检测”列表。选择“开始对话”可以用该 Agent 新建会话。
- 需要隔离配置时，在对应卡片选择“切换目录”，选择该 Agent 专用目录；要取消自定义目录时选择“恢复默认目录”。
- 只有已经启用开发者模式、并明确知道运行方式时，才选择“新建 Agent”。可以克隆当前支持的 Agent，或选择“自定义命令”。
- 自定义命令至少填写显示名称和命令；参数与环境变量仅按该 Agent 的官方说明填写。
- 保存前选择“测试连接”。测试成功后再保存，并新建一个低风险会话验证。
连接测试会区分三种可观察结果：
| 结果 | 含义 | 下一步 |
|---|---|---|
| “连接成功！CLI 存在且 ACP 协议正常工作。” | 命令可启动，ACP 初始化也已完成 | 保存后新建会话验证 |
| “未找到命令。请确保已安装并在 PATH 中。” | 客户端找不到填写的可执行命令 | 核对安装来源、命令或绝对路径 |
| “找到 CLI 但 ACP 初始化失败。” | 命令存在，但没有完成 ACP 握手 | 核对参数、Agent 版本和诊断结果 |
配置目录显示“自定义目录”时，只表示该 Agent 的配置位置已经调整，不代表模型、技能或 MCP 已经可用。
看不到“新建 Agent”
Section titled “看不到“新建 Agent””这是开发者功能没有启用时的正常结果。只想使用现有 Agent 时无需开启开发者模式。
Agent 显示缺少模型或组件
Section titled “Agent 显示缺少模型或组件”缺少模型时前往模型设置；ACP 组件未就绪或运行环境异常时前往诊断与问题分流。
修改后仍无法使用
Section titled “修改后仍无法使用”不要反复改命令或批量增加环境变量。保留测试结果原文，恢复最后一个已知可用配置，再新建会话验证。