MadoAgent

MadoAgent 是 MadoHub 的会话式那一面。用 Cmd+Shift+M（⌘⇧M）打开它，描述你想完成的事情——"在这个 API 上搭两个 Claude agent 做同行评审"、"针对这个 bug 试两种缓存策略，告诉我哪种更好"——而不必一块一块图块地自己搭出来。

它不是把一次模型调用包了一层聊天界面。每条消息都会跑一个真正的工具调用循环，可以查看你的画布、生成并消息 Agent、连线路由连接、打开框架和终端，并读取自己的记忆。应用内的引导把它称作"你的编排大脑"，这个说法是准确的：MadoAgent 是画布的对等体，不是一个建议框。

你能用它做什么

• 生成并分配 Agent —— 在一个全新终端里启动 Claude、Codex 或 Amp，或者把工作交给同一项目下空闲的合适类型 Agent，而不是堆叠一个重复的。
• 把 Agent 连在一起 —— 请求一个同行评审、流水线或观察者模式，MadoAgent 会画出路由连接并设置正确的触发与循环参数。
• 驱动画布 —— 打开框架和终端、创建笔记、跳到某个图块，或从一条 prompt 里清空整张画布。
• 配置环境 —— 打开一个项目并按顺序执行一组配置命令（安装、启动开发服务器）。
• 跑一个自主终端 —— 给 MadoAgent 一个终端和一个目标，它会持续下发命令并观察输出，直到目标完成。
• 并行探索多种方案 —— 在同一个问题上用不同指令生成多个 Agent，并排比较结果（参见 Ensemble Exploration）。

如何使用

1. 用 Cmd+Shift+M（⌘⇧M）打开面板。
2. 用自然语言输入你的请求，按 Enter。
3. 观察 MadoAgent 在画布上生成图块、画连接、给 Agent 发消息。当有事情需要你注意时（例如它拒绝了一条引用了不存在图块的连接），会弹出 toast 和聊天内的说明。
4. 继续对话即可——MadoAgent 保留最近 20 条消息作为上下文，所以你可以直接接一句"现在把这两个连起来做同行评审"，而不必重新解释一遍。

在 Settings → Agent 里选择 MadoAgent 被允许直接做多少事：

MadoAgent 在响应之前，需要你先在 Settings 里配置好 provider 和 API key——它与 agent routing 共享 API 配置。

常见用例

• "在我的项目里启动一个 Claude agent 和一个 Codex reviewer，然后把它们连起来做同行评审。" MadoAgent 一次生成两个图块并画好连接。
• "派发一个 Codex worker 去重构 auth 模块，我这边继续干活。" 一个 headless worker 图块会带上 Worker 徽章，方便你与交互式 Agent 区分。参见 Orchestrator Mode。
• "Claude 现在在 API 项目里在做什么？" MadoAgent 在回答前会读取每个终端、框架和连接的最新快照——不需要你切换图块。
• "针对这个 bug 试两种不同的缓存策略，告诉我哪种更好。" MadoAgent 在同一个问题上 fork 出多个 Agent，并在 Exploration 面板里列出来供你比较。

提示与最佳实践

• 任何不适合套用内置 Flow 的场景优先用 MadoAgent；如果是可复用的双 Agent 模式，Flows 更快。
• 如果一个请求引用了画布上不存在的东西，MadoAgent 会拒绝不安全的那部分并在聊天里告诉你，而不是留下一条坏连接。读一下 toast 然后换种说法。
• 当你希望 MadoAgent 只协调 Agent、不碰文件时，用 Orchestrate 技能级别。
• "配置开发环境并启动服务器"这类长任务很适合自主终端模式——回到图块上看进展，不必守着面板。

相关功能

• Flows —— 常见模式的一键可复用 Agent 配对。
• Agent Routing —— trigger 和 transform 实际做了什么；MadoAgent 底层用的是同一个路由引擎。
• Connections —— 为一次性、需要精确控制的场景手工连线。
• Memory —— MadoAgent 可跨会话召回的长期事实与偏好。

局限

• MadoAgent 只保留最近 20 条消息作为上下文。对于很长的编排任务，把决策总结到 Memory 里以便留存。
• 它依赖可用的 provider 和 API key。一次失败的 API 调用会最多重试两次并带退避延迟，之后才报错。