Agent 路由
通过智能转换,在 AI Agent 之间自动传递输出与上下文。
Agent 路由是 MadoHub 的核心协同引擎。当一个 Agent 完成当前任务后,MadoHub 能够自动捕获其执行结果,将其转化为结构化的目标提示词,并无缝投递给下游的另一个 Agent,实现全自动的多智能体协作流水线。
工作原理
- 触发(Trigger) — 已连接的源图块根据预设条件(空闲检测、任务完成、关键词匹配或持续流式)自动激活路由。
- 提取(Extract) — MadoHub 提取 Agent 的最新输出。针对 Claude Code 等主流 CLI,采用原生结构化会话提取技术,杜绝终端杂讯。
- 转换(Transform) — 将捕获的输出转换为目标 Agent 可理解的高效提示词,支持 AI 智能改写、模板包装或原始透传。
- 投递(Deliver) — 转换后的指令由调度器以自适应节奏注入目标终端,并智能匹配对应 Agent 的提交握手协议。
高保真会话捕获
在传统的多终端自动化中,通过抓取屏幕字符来获取 Agent 输出极为脆弱,往往夹杂大量的 ANSI 颜色转义码、进度条抖动和换行伪影。
MadoHub 采用了原生结构化会话捕获机制:
- 纯净上下文抽取:直接读取 Agent 的底层会话记录,精准提取 Assistant 生成的真实思考、代码补丁与工具执行结果,彻底消除终端字符噪声。
- 项目工作区自适应对齐:系统自动将画布图块与底层项目目录进行语义绑定,确保跨 Agent 路由时上下文路径始终精确一致。
- 免侵入式监听:无需修改 Agent 的核心源码,保持原生 CLI 的完整性与安全性。
触发类型(Trigger Types)
| 类型 | 触发行为与适用场景 |
|---|---|
| on-idle | 空闲检测(推荐):在检测到 Agent 完成任务并经历短暂静默后触发,最稳定可靠。 |
| on-complete | 完成检测:在 Agent 显式输出完成信号并确认停顿时触发。 |
| on-keyword | 正则匹配:当输出中命中指定的正则表达式或特定关键词时立即触发。 |
| always | 持续流式:不等待任务结束,持续将产生的新输出实时转发给下游。 |
转换类型(Transform Types)
| 类型 | 说明与应用 |
|---|---|
| ai-routing | AI 智能改写(核心):使用 AI 模型为下游 Agent 生成包含上下文背景与明确诉求的高质量提示词。可在设置中配置模型。 |
| prompt-wrap | 模板包装:使用自定义模板格式化输出,支持内置变量:{output}、{round}、{maxRounds}、{source}。 |
| summary | 智能摘要:由 AI 提取上游输出的核心结论与关键 Diff 摘要后转发。 |
| full-output | 完整透传:原样转发终端输出的最后 30 行文本。 |
| raw | 精简透传:转发终端输出的最后 10 行文本。 |
自适应终端投递
为保障长指令投递的绝对稳定性,MadoHub 实现了针对不同 Agent CLI 的自适应投递协议:
- 智能输入流控:根据目标终端的缓冲区吞吐能力自适应调节注入速率,杜绝高频粘贴导致的字符丢失或终端假死。
- 协议自适应握手:自动适配 Claude Code、Codex、Amp、OpenCode 以及标准 Shell 的专属提交序列,确保指令下发后 100% 确定性触发执行。
循环保护机制
为防止 Agent 之间出现死循环调用,MadoHub 内置了工业级的熔断与限频保护:
| 配置项 | 默认值 | 可调范围 | 说明 |
|---|---|---|---|
| maxRounds | 5 | 1–20 | 自动停用连接前的最大协作轮次,防止无限消耗 Token。 |
| cooldownMs | 3s | 1–30s | 两次触发之间的强制冷却时间,平抑高频抖动。 |
| stopKeyword | — | 自定义字符串 | 命中指定终止词(如 "LGTM"、"RESOLVED")时自动切断路由。 |
经典协作示例
终端 1(Claude Code:代码重构) 终端 2(Claude Code:代码审查)
┌──────────────────────┐ → ┌──────────────────────┐
│ "重构 auth 模块" │ │ 接收到: │
│ │ │ "审查 src/auth/ 中 │
│ ✓ 完成 — 3 个文件 │ │ 的重构代码..." │
└──────────────────────┘ └──────────────────────┘Agent 1 完成代码重构后,MadoHub 高保真提取其变更成果,通过 ai-routing 提炼出针对性审查清单,并自适应投递给 Agent 2 启动独立的测试与审查流程。