diff --git a/docs/zh-CN/concepts/parallel-specialist-lanes.md b/docs/zh-CN/concepts/parallel-specialist-lanes.md new file mode 100644 index 000000000..be538e2e4 --- /dev/null +++ b/docs/zh-CN/concepts/parallel-specialist-lanes.md @@ -0,0 +1,129 @@ +--- +read_when: + - 你将群聊路由到专用智能体 + - 你希望并行处理工作,而不是让一个长任务阻塞所有聊天 + - 你正在设计一个多智能体运维设置 +sidebarTitle: Specialist lanes +status: active +summary: 并行运行专用智能体,避免占用共享的模型和工具容量 +title: 并行专家通道 +x-i18n: + generated_at: "2026-05-02T10:18:26Z" + model: gpt-5.5 + provider: openai + source_hash: b09f10ce4fbd79954a7196fbedb23f9b3f34b459b98eb7a5480f7eeb0bb6be98 + source_path: concepts/parallel-specialist-lanes.md + workflow: 16 +--- + +并行专用通道让一个 Gateway 网关可以将不同聊天或房间路由到 +不同智能体,同时保持快速的用户体验。关键是把并行性当成稀缺资源的设计问题, +而不只是“更多智能体”。 + +## 基本原则 + +只有在减少真实瓶颈争用时,专用通道才会提升吞吐量: + +- **会话锁**:同一时间只应有一次运行修改给定会话。 +- **全局模型容量**:所有可见的聊天运行仍然共享提供商限制。 +- **工具容量**:shell、浏览器、网络和代码库工作可能比模型轮次本身更慢。 +- **上下文预算**:长转录会让未来每个轮次更慢、焦点更分散。 +- **所有权模糊**:重复执行同一工作的智能体会浪费容量。 + +OpenClaw 已经按会话串行化运行,并通过 +[命令队列](/zh-CN/concepts/queue)限制全局并行度。专用通道在此之上添加策略: +哪个智能体拥有哪项工作,哪些留在聊天中,哪些变成后台工作。 + +## 推荐推广路径 + +### 阶段 1:通道契约 + 后台重型工作 + +在每个通道的工作区和系统提示中写明契约: + +- **目的**:该通道负责的工作。 +- **非目标**:它应交接而不是尝试处理的工作。 +- **聊天预算**:快速回答留在聊天中;长任务应简短确认, + 然后在后台子智能体或任务中运行。 +- **交接规则**:当另一条通道拥有该工作时,说明应转到哪里, + 并提供紧凑的交接摘要。 +- **工具风险规则**:优先使用能完成工作的最小工具面。 + +这是成本最低的阶段,并能解决大部分堵塞:一个编码任务不再把研究通道拖得很慢, +每个聊天也能保持自己的上下文整洁。 + +### 阶段 2:优先级和并发控制 + +围绕每条通道的业务价值调优队列和模型容量: + +```json5 +{ + agents: { + defaults: { + maxConcurrent: 4, + subagents: { maxConcurrent: 8 }, + }, + }, + messages: { + queue: { + mode: "collect", + debounceMs: 1000, + cap: 20, + drop: "summarize", + }, + }, +} +``` + +将直接/个人聊天和生产运维智能体用于高优先级工作。当系统繁忙时, +让研究、起草和批量编码转入后台任务。 + +### 阶段 3:协调器 / 流量控制器 + +在多条通道都处于活跃状态后,添加一个小型协调器模式: + +- 跟踪活跃通道任务和所有者。 +- 检测跨群组的重复请求。 +- 在通道之间路由交接摘要。 +- 只呈现阻塞项、已完成结果以及需要人类做出的决策。 + +不要从这里开始。没有通道契约的协调器只是在协调混乱。 + +## 最小通道契约模板 + +```md +# Lane contract + +## Owns + +- + +## Does not own + +- + +## Chat budget + +- Answer quick questions directly. +- For multi-step, slow, or tool-heavy work: acknowledge briefly, spawn/background + the work, then return the result when complete. + +## Handoff + +If another lane owns the request, reply with: + +- target lane +- objective +- relevant context +- exact next action + +## Tool posture + +Use the smallest tool surface that can complete the task. Avoid broad shell or +network work unless this lane explicitly owns it. +``` + +## 相关内容 + +- [多智能体路由](/zh-CN/concepts/multi-agent) +- [命令队列](/zh-CN/concepts/queue) +- [子智能体](/zh-CN/tools/subagents)