> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/native-tools/agent-coordination.md).

# 智能体协调

除了执行工作之外，代理还有用于 *组织* 工作的工具——规划多步骤任务、委派给专家、创建子代理，以及在确实存在歧义时暂停并询问用户。

## 该家族中的工具

| 工具                                                | 功能                                                                  |
| ------------------------------------------------- | ------------------------------------------------------------------- |
| `todo_write`                                      | 在长任务中维护结构化的待办列表。随着工作推进逐项标记为完成。                                      |
| `spawn_subagent`                                  | 默认委派给可复用的异步专家；只有在不兼容或被要求时才创建新的工作进程。                                 |
| `spawn_async_subagent`                            | 具有相同持久会话标识的更底层、可复用异步委派接口。                                           |
| `steer_subagent` / `wait_subagent`                | 通过持久的运行中的工作进程发送消息或收集结果 `subagent_session_id` 或临时 `task_id`.         |
| `list_subagents` / `close_subagent`               | 检查父线程的可复用工作进程，或显式将其退役。                                              |
| `spawn_worker_thread`                             | 显式后台工作，作为单独的工作线程进行跟踪。                                               |
| `delegate`                                        | 将任务交给专家（例如具有不同提示/工具/权限的原型）。                                         |
| `archetype_delegation`                            | 路由到指定原型——编码员、研究员、规划员等。                                              |
| `skill_delegation`                                | 交给一个 [技能](/openhuman/zh/gong-neng/integrations.md#skills) 安装在工作区中的。 |
| `ask_clarification`                               | 暂停并向用户提出一个明确的问题，而不是猜测。                                              |
| `plan_exit`                                       | 退出规划阶段并开始执行。                                                        |
| `check_onboarding_status` / `complete_onboarding` | 根据用户是否已完成入门来限制行为。                                                   |

`spawn_subagent` 而原型委派调用接受一个可选的 `模型` 字段，用于一次性的精确模型固定值。若省略，测试框架会在存在时使用配置级别的按代理固定值，否则回退到常规的模型路由提示。模型、工具集、沙箱模式、父线程、操作根目录和任务键都属于可复用子代理兼容性的一部分，因此实质不同的工作会获得单独的工作进程。

可复用委派会同时返回一个临时的 `task_id` 和一个持久的 `subagent_session_id`。跨轮次后续跟进时优先使用持久 ID。仅在 `fresh: true` 用户或任务需要一个干净的工作进程时传入；传入 `blocking: true` 仅在父级必须同步等待子级结果时。

## 为什么这些是工具，而不是隐式行为

当代理试图把所有内容都放在一个脑子里时，长任务就会崩溃。通过 TODO 和子代理拆分工作意味着：

* 每个子代理都会为同一个逻辑任务保留有用的本地上下文，而不是每轮都重新生成。
* 主线程保持对进度的高层视图。
* 一个分支中的失败不会污染其他部分。

请求澄清也是一种工具，且是有意为之：它让“我应该询问用户”成为一个 *可见的* 代理可以被引导做出的决策，而不是一种涌现行为。

## 另请参阅

* [Coder](/openhuman/zh/gong-neng/native-tools/coder.md) - 编码员原型子代理通常使用的内容。
* [潜意识循环](broken://pages/8f1b13c03e1006c2498f2a57983552beefceb5ac) - 始终在线的后台代理线程。