Agent 配置
Agent 是 Myrm 的核心工作单元。每个 Agent 可独立配置模型、自定义系统提示词、工具、技能、记忆与行为参数。创建 Agent
- 进入 Agents > 新建 Agent
- 填写名称与描述
- 选择模型(或交给智能路由)
- 配置工具、技能与权限
- 保存即可使用
编辑-测试零跳转
Myrm 在聊天页中直接内嵌了 Agent 配置面板,实现「修改配置 → 发送消息 → 立即看到效果」的零跳转调试体验:- 聊天页内嵌:点击输入框旁的 Agent 指示器按钮即可展开配置面板,修改 System Prompt、技能、MCP 工具后下一条消息即生效
- 智能折叠:发送消息后面板自动收起,不遮挡对话区域;需要再次调整时一键展开
- 自动保存:从编辑页点击「开始对话」时,系统自动保存未提交的配置更改后再跳转到聊天页,不会丢失编辑内容
- 全入口一致:侧边栏、设置页、模板市场、组织市场等所有入口均在同一页面内导航,无新标签页弹出
单轮能力 Chips(Skill/MCP)
除了 Agent 级默认配置,Myrm 支持在输入区直接做下一条消息生效的一次性能力覆写:- 为下一条消息临时选择 Skill/MCP 子集
- 减法优先:只能从当前 Agent 已启用能力里做子集,不会越权新增
- 队列一致性:直接发送、排队发送、busy 重排队都保持同一轮覆写语义
- Prompt Cache 友好归一化:全选会自动折叠为 no-op,不制造无意义配置抖动
对真实用户的价值
- 降低误调用成本:某一轮只放开必要工具,不改长期 Agent 配置
- 协作更清晰:同事可临时聚焦一轮能力,结束后自动回到默认配置
- 可观测可复盘:提交/生效/noop/排队/busy/终态 + 失败原因有完整遥测口径
GET /api/v1/statistics/turn-capability/summary
输出 Locale 与敬语(SSOT)
Saved Agent 可在engine_params.response_locale_policy 声明输出 locale 与 formality。Myrm 在 全部生产入口(Web 聊天、渠道、Cron、Kanban、Goal 续跑)向 user_instructions 追加紧凑后缀,保证多轮语气一致。
内置预设
builtin-ko-office 默认韩国正式敬语(합니다体)。聊天 Formality 开关可会话级覆盖;均走同一后缀管道(尾部追加,cache 友好)。
内置智能体本地化
25 个内置智能体的名称与职责描述全部本地化为 6 种语言(中 / 英 / 繁 / 日 / 韩 / 德)。本地化覆盖全链路界面——聊天、看板、记忆面板、设置以及每个下拉框、选择器与@mention,本地化界面中绝不混入生硬的英文内置智能体名。
CI 工业级 i18n 门禁在每次发布自动拦截「未翻译泄漏」与「翻译漂移」,本地化质量始终保持一致。
模型选择
Myrm 通过 LiteLLM 支持 100+ 模型:智能路由
复杂度路由器自动选择最优模型档位。默认开启,零配置即用 — 当用户未手动指定轻量/推理模型时,系统自动从已启用模型中按成本选取(最便宜 → 轻量级,最贵 → 推理级)。
两阶段评估(零成本规则评分 + 模糊场景 LLM 裁判)+ 会话动量 — 短跟进消息继承会话已建立档位。
Complaint-up 自动升级:点击 Regenerate(重新生成)且不附加修改指令时,系统将此解读为对回答质量不满,自动将路由档位提升一级(SIMPLE→STANDARD→REASONING),用更强的模型重新回答。PenaltyTracker 同步记录此反馈,影响未来同类查询的路由精度。若附加了指令(如”用更正式的语气重写”),则视为方向调整而非不满,不触发升级。
Per-Agent 独立路由策略:每个智能体可以拥有独立于全局的路由配置。在 Agent 能力 Tab 中可设置:
- 继承全局(默认):跟随全局 Smart Routing 配置
- 自定义:为该 Agent 设置独立的轻量级和推理模型
- 禁用路由:该 Agent 始终使用其主模型,不做任何路由分级
多槽位模型架构
每个 Agent 可独立配置 11+ 个模型槽位,针对不同任务类型使用最优模型:
每个槽位支持 Agent 级覆盖(继承或自定义),未设置时自动回退到主模型。模型纪律系统自动检测弱模型并注入行为约束,确保任何模型层级都能输出高质量结果。
思考强度
6 档推理深度,可按对话调节:off → low → medium → high → xhigh → max
各模型通过 localStorage 记住偏好思考级别。
提示词模式
三种模式控制系统提示词构建:
Minimal 模式下优化系统提示词约 1,765 tokens — 比同类平台少 86%(Hermes ~15,520,OpenClaw ~18,000)。
自定义系统提示词
每个 Agent 可有自定义系统提示词定义人格、专长与行为规则,运行时与 Myrm 核心规则(安全、工具使用等)合并。工具配置
Agent 可使用:- 内置工具:文件、终端、浏览器、搜索、代码执行、工作区
@codebase概览 + grep/glob 探索 - MCP 工具:通过 MCP 服务连接的外部工具
- 技能:可复用任务能力
进度平面
Agent 配置面板提供进度模式(默认关闭,不占 Turn1 Token):
启用 Planning 后,进度持久化在 chat sandbox 的
{sandbox}/.myrm/progress/todos.json;CompletionGuard 会在有文件写入且 todos 未完成时阻断过早结束。前端按 step_key 合并重复的 SSE tasks_steps 事件,ProgressSteps 不会因重发而重复渲染。Planning 默认关闭(开启约 ~150 token)——简单问答零进度工具税。
延迟工具加载
并非所有工具都需要始终占用 LLM Prompt 空间。Myrm 将工具分为两级:
媒体工具与凭证:在 Agent 内置工具面板勾选图片/视频/TTS 后,仅当「设置 → 模型服务」已配置对应供应商 API Key 或媒体网关时,这些工具才会出现在 Turn 1 schema 中。若缺少凭证,配置面板会显示琥珀色内联警告并链到设置页——Agent 不会崩溃,也不会暴露无效工具 schema。
对于配置了较多延迟工具的 Agent,每轮可节省约 4,000 Token;你明确启用的媒体工具则无需额外发现步骤即可直接调用。
技能热重载
通过 GUI 或 API 修改技能配置后,正在运行的 Agent 会自动检测变更并在会话内重新初始化。无需重启、无需重连——更新后的技能即时生效。记忆
每个 Agent 拥有:- Agent 专属记忆:仅该 Agent 的知识
- 全局共享记忆:所有 Agent 可访问
- 记忆遗忘速度:控制记忆衰减速度(永久 / 正常 / 快速)
- 记忆聚焦:领域提取引导 — 配置 Agent 学习你的信息时优先关注哪些属性
记忆聚焦(领域提取预设)
记忆聚焦零额外 LLM 成本 — 仅引导标准提取过程中优先关注哪些属性。
记忆跨会话持久化,Agent 可持续学习适应。详见记忆系统。
人格
16 种内置人格预设(8 专业 + 8 创意):- 中英文双语
- Emoji + 语气定制
- GUI 分类画廊
- 自定义人格创建
迭代预算(每 Agent 独立设置)
每个 Agent 都能独立控制自己的工具调用轮数(max_iterations,5–500)——深度研究 Agent 给足轮数跑完,轻量助手限住轮数省资源,不再被一个全局值”一锅烩”。
在 Agent 设置 → 能力(Capabilities)→ 最大迭代次数 可视化配置(WebUI / 桌面端 / API 均可)。
运行时由 harness 递归上限强制执行,失控 Agent 永远不会烧穿配置的天花板。
子 Agent 编排
复杂任务可用 7 种编排模式分解:角色边界与工具安全隔离
每个子 Agent 均继承一个SubagentConfig — 包含 21 个字段的声明式配置文件,明确定义其职责、权限和资源限制:
GUI 配置编辑器提供 5 个独立面板(技能 / MCP / 内置工具 / 子智能体 / 指令),支持可视化配置。集成 AI 辅助 Prompt 生成和 ActionSpace 准确率雷达图进行覆盖率分析。
外部 Agent 委派 (ACP)
通过 ACP 协议将任务委派给外部编程 Agent:- Claude Code — Anthropic 编程 Agent
- Codex CLI — OpenAI 编程 Agent
- Gemini CLI — Google 编程 Agent
- 任意 ACP 兼容 Agent — 通过 RuntimePool 无限扩展
invoke_acp_agent_tool 工具支持完整上下文注入、持久/一次性会话模式和自动重试。
Web 聊天体验: 同一对话内复用外部 CLI Agent 会话(--resume),多轮委派无需重复冷启动。单对话 turn-lock 串行化多标签/连点并发;取消操作免锁,避免运行卡死。Direct-only 路径不挂载 delegate 工具,节省 token。
可靠性加固(2026-08): 外部委派全链路防御真实故障。超时或崩溃的外部进程会被自动终止(SIGTERM,宽限期后 SIGKILL 兜底)——后台不会残留孤儿 CLI 进程占用资源。若 --resume 会话崩溃且无任何输出,系统会丢弃失效的 session id,下一次调用自动自愈降级为全新会话,绝不永久卡死。委派失败永远不会被静默当作成功:统一转为结构化 ERROR 事件(含 retryable 分类),调用方可准确重试或上报——CLI / SDK / ACP 三种后端行为完全一致。
按 Agent 的 external_cli 开关(2026-07): 本地模式下 设置 → 开发者 → 外部 Agent 会自动检测 PATH 中的 CLI —— 若 Claude Code 已配置三方模型,无需 Anthropic 官方订阅凭据也可委派;Settings 徽章显示「CLI 可用」(而非误导性的「未登录」)。仅在需要 invoke_acp_agent_tool 的 Agent 上开启「外部 CLI」(如 General Assistant、Code Developer)。Writer/Research 预设默认关闭,省约 216 Turn1 schema token。Settings 与内置工具面板双向交叉提示;聊天面板在 auto-detect 成功时不再误报「尚未配置 CLI 后端」。
验收(2026-07-10): 108+ 项后端集成/单测全绿(含 test_external_cli_live_e2e.py 直连 claude-code PONG);Chrome E2E(:3000)确认 Writer/Research 无 external_cli chip、General/Developer 有;Developer → 添加 Agent → Claude Code 显示「CLI 可用」;真实 mimo-v2.5-pro → 委派 → Claude Code 返回 PONG,聊天页含任务步骤与工具执行轨迹。
MCP 治理统一收敛(2026-08): 当宿主客户端(IDE、GUI 或聊天界面)把 session 级 MCP 服务器塞给外部 Agent 时,Myrm 的 ACP 桥接会忽略该注入并把 MCP 管理统一收敛到 Myrm 自身管线——服务端记录明确的告警(acp_host_mcp_ignored reason=myrm_manages_mcp),而非静默绑定。任何 MCP 工具都无法因为「委派给外部 Agent 执行」就绕过 Myrm 的 7 层策略链、连接池自愈或运行时 prompt-injection 扫描。SDK 桥接同样把 mcp_servers 的完整 env(name/command/args/env)透传给子进程,第三方 MCP 凭据(API Key、内网地址)在委派过程中完整保留,绝不静默丢失。
从 Hermes / AionUi 迁移: 保留已安装的 Claude Code / Codex / Gemini CLI(Settings 自动检测),在自有 Agent 引擎与 MCP 生态之上可选委派,并额外获得 5 层审批与 SubAgent 编排。删除对话会立即释放已池化的外部 CLI 进程,不留后台僵尸任务。
Google A2A 协议
通过标准 Google Agent-to-Agent 协议发现和集成第三方 Agent。AgentCard 解析含 SSRF 防护和 TTL 缓存。 详见看板与编排。Agent Profile:精确无串扰
每个 Agent Profile 是全维度配置单元 — 远非简单技能分组。如何防止技能串扰
技能过多时 LLM 可能调用无关技能(「串扰」)。Myrm 五层解决:- Agent Profile — 各 Agent 仅通过
skill_ids[]加载指定技能 - Tool Condition Activation —
requires_tools/fallback_for_tools按可用工具显隐技能 - Progressive Disclosure(L0–L3) — 仅展开相关技能详情
- Noise Gauge — 超噪声阈值技能自动衰减
- Hybrid Retrieval — Qdrant 向量检索为每查询选最相关技能
Built-in Tools SSOT(2026-07)
- 18 canonical IDs:
web_search、memory、structured_clarify等 16 项在 UI 可切换;file_ops、code_execute为 Agent 基线(服务端强制 Turn1 eager,面板不展示开关)。 - 27 预置 Agent 工具矩阵:服务启动时 initializer 幂等同步;Agent 画廊与设置页均展示完整 27 个 built-in(
AGENT_LIST_BUILTIN_PAGE_SIZE=50默认;画廊 chip 来自enabled_builtin_tools)。 - 写路径单入口:
persist_enabled_builtin_tools校验后再落库;legacy ID 返回 422,避免 silent 失效。 - 默认 profile:UI 默认开启
web_search+memory+structured_clarify(结构化多题澄清表单);文件/代码执行能力始终可用(Agent 基线,无需用户勾选)。表单 payload 使用requires_confirmation: bool(替代竞品常见的 5 类枚举);true时 WebUI 以琥珀色强调风险确认。 - 用户开关 ON → Turn1 直接可用:默认或手动开启的内置工具(含 cron(需手动开启)、structured_clarify、computer_use、x_search、invoke_acp_agent_tool 等)、已绑定 skill 对应工具,首轮即出现在 LLM schema,无需先调
discover_capability。Cron 默认关闭(可发现加载)——仅开启的用户承担约 827 tok eager schema;OpenClaw/Hermes 无 per-agent 开关,Turn1 始终挂载 cron。structured_clarify关闭时不暴露ask_question_toolschema——竞品多把澄清写死在常驻 Prompt 里。HarnessClarificationGuardMiddleware保证每轮至多一次ask_question_tool,且与并行工具互斥(对齐 Hermesclarify单轮约束)。 - active_tool_groups SSOT:
derive_active_tool_groups()统一推导已启用工具组,避免structured_clarify/ 媒体组已开仍误报capability_gap。 - 全矩阵回归:
CAPABILITY_GAP_REGISTRY覆盖 14 个 GUI 可切换 builtin(含 web_search、memory、cron、answer_tool、structured_clarify 及 browser/external_cli/computer_use/wiki/kanban/planning/三媒体)。Agent 基线file_ops/code_execute运行时强制,不参与 Gap 提示。可编辑白板见 通过 MCP 绘制图表。 - 权限缺口(Entitlement Gap):每条用户消息在 Agent 循环前 preflight 扫描(SSE 推送
capability_gap/skill_gap,不改 Turn1 schema);discover_capabilitymiss 走同一 registry。WebUI 通过/api/v1/workspace/stream多路复用接收预检事件(POST 前注册监听器,早到 chunk 不丢),toast 为信息提示,并提供直达设置页的入口。 - 会话工具面板:聊天输入框 wrench 图标通过 SSE
tools_snapshot展示本会话 Turn1 已绑定工具列表(含 layer 标签),比静态配置页更准确反映「此刻 Agent 能调用什么」。 - 控制面工具(默认 0 Turn1 token):编排信号(Deep Research)、CompletionGuard(
_completion_check)、Verifier(submit_verdict)、Workflow PTC(spawn_subagent/notify)登记供审计,但不进入默认 Chat bind——简单对话不为 spawn/编排工具付 schema 税。典型默认 profile 实测 15 工具 / ~8,354 tok 工具层(2026-07-03 SSOT)。
Agent 绑定
Agent 可绑定到不同上下文:
未绑定上下文使用默认通用 Agent。可随时在 GUI 或消息渠道
/bind / /unbind 切换。
Slash 命令绑定
每个 Agent 可自定义 Slash 命令,一键触发一个或多个技能。单技能
将/deploy 映射到一个技能:
多技能组合(Bundle)
将多个技能合并为一个命令,附加可选引导词:工作流程
- 配置 — 在 Agent 编辑器中多选技能,可选填写引导词
- 触发 — 在 Slash 面板(WebUI)、桌面端或任意 IM 渠道输入
/daily-report - 执行 — Harness 加载所有 SOP,强制 Token 预算,协同执行
输入交互细节
- 输入任意位置触发 — Slash 菜单锚定光标前最后一个 token,
fix it /systematic-d与命令在开头一样会唤起面板。竞品(如 OpenClaw)仅在整个输入以/开头时显示菜单。 - 支持带连字符的命令名 —
/code-review、/systematic-debugging等可实时识别;正则含-,与 harness 技能命名规则一致。 - 保留周围文本 — 选中 / 执行 / Esc 关闭时只移除命令 token,前后文本作为指令保留。
fix it /systematic-d→ 前缀fix it保留,技能同时激活。 @引用永不泄漏 — 经@菜单添加的引用在发送前会对照输入做存活校验:删除@文本后引用即从请求中剔除,避免误委派给其他 Agent 或误注入 wiki/chat 引用。手输 / 粘贴的内联 token(@wiki:概念、@文件:12-20、@folder:路径、@url:…、@staged、@diff、@codebase)无需打开面板即时解析。
Agent 级隔离
每个 Agent 拥有独立的命令绑定。「代码助手」的/review 与「运维助手」的 /deploy 完全独立。
配置快照与回滚
每次配置变更自动创建快照,实验无风险:
在 Agent 设置 > 版本历史 中查看快照时间线。
导出、导入与克隆
跨团队分享 Agent 配置或外部备份:
团队 Agent 导出时自动打包 Leader + 所有成员配置为单一版本化包。