Agents

Agents 页列出 ATM 在本机识别到的所有本地 AI 编程 Agent 及其路由配置、策略绑定、Key 状态与最近活动。

页面结构

页面顶部提供搜索框及类型 / 策略 / 状态筛选下拉。每个 Agent 以卡片形式呈现，展示以下字段：

点击 详情 进入该 Agent 的详情面板。

Agent 操作

签发 / 轮换 Key

为该 Agent 签发新的 atm-… Key。若已存在 Key，旧 Key 立即失效（返回 401），即轮换操作。新 Key 的完整值仅在签发时展示一次，ATM 不提供再次查看。切换至 ATM Gateway 路由后，ATM 会自动将新 Key 写入 Agent 的原生配置文件。

绑定策略

将内置策略或自定义策略绑定至该 Agent。策略作用域为单个 Agent。

重置配置

将 Agent 原生配置回滚至指定状态：

• 恢复最近 Live 备份 — 使用 ATM 自动生成的备份快照。
• 已保存的直连供应商 — 从保存的供应商重写配置，并清除特殊 Base URL 覆盖。

适用于 ATM 写入后配置出现非预期结果的场景。

通用 Agent 与专用 Agent

同一页面同时管理两类 Agent。通用 Agent 显示在根层级，专用 Agent 缩进显示在父节点下方。

• 通用 Agent 为必要项（每个工具至少一个），是 ATM 对该工具的默认身份标识。
• 专用 Agent 为可选项，与父节点共享工具，但拥有独立的 Key、策略和流量归因。

新建专用 Agent：点击通用 Agent 卡片上的 + Specialised agent，填写名称、类型及可选策略后签发 Key。

Agent 不在列表的常见原因

1. 工具未在本机运行过——请先运行工具，再点击右上角 重新扫描。
2. 配置文件不在默认路径（可在 Settings → Paths 中覆盖）。
3. 配置 schema 当前版本的 ATM 尚不支持。
4. 已卸载工具的残留配置文件。