> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 智能体

> 分担工作的子智能体、你命名的智能体、编排，以及会话之间的互相通信。

## 子智能体

智能体可以把请求的一部分交给子智能体。每个子智能体从零开始，完成自己的部分，只交回最终答案。多个子智能体可以同时运行。在启动它的步骤下，每个子智能体占一行；子智能体请求批准时，会说明是哪一个。

| 类型 | 作用 |
| - | - |
| 检查 | 只读取。 |
| 编辑 | 在你文件夹的临时 Git 工作树中工作。结束后，它的更改会合并到你的文件夹中，不暂存也不提交。如果有冲突，不写入任何内容，补丁会保留下来。需要 Git 仓库。 |
| 后台 | 子智能体工作时，智能体继续做别的；完成后，结果回到对话中。 |

子智能体的权限永远不会超过它的上级：你的[权限模式](https://docs.archetype.ing/zh/use/approvals.md)和批准规则同样适用于它的调用。子智能体有疑问时先问上级；如果上级 10 分钟内没有回答，问题会转给你，显示在**待你处理**中。

Archetype 自己的模型、Claude Code 和 Codex 默认开启子智能体。在用户配置中设置 `"children": false` 可以关闭。

**Tokenmaxxing** 速度优先：智能体把工作拆成互不依赖的部分，全部交给子智能体同时运行。在状态栏或用 `/tokenmaxxing` 开启。

## 命名智能体

内置两个智能体：`general`，以及只读取的 `explore`。你可以用 Markdown 文件添加自己的智能体；智能体根据名称和描述选用。

```markdown theme={null}
---
name: reviewer
description: Reads the changed files and finds bugs and missing tests
mode: inspect        # inspect or edit; without it, the task decides
tools: [read_file, search_text]   # without it, every tool of the mode
model: gpt-6-luna    # a model of the parent's provider; without it, the parent's
max-turns: 30        # 1 to 200; without it, no limit
---

Read the change closely. For each problem, give the path, the line and why.
```

| 位置 | 适用范围 |
| - | - |
| `~/.config/archetype/agents/*.md` | 你自己，所有文件夹 |
| `.archetype/agents/*.md` | 这个项目 |

你的智能体会替换同名的内置智能体。项目的智能体只能添加新名称：与内置智能体或你的智能体同名的会被跳过并给出警告，因此克隆来的仓库无法改变 `explore` 的行为。

## 编排

对于一个对话装不下的大型工作，由一个会话主导其他会话。

**1. 开始**

输入 `/orchestration` 和你想做的事，或在文件夹的新会话菜单中选择**编排**。

**2. 同意计划**

主导会话写出计划：步骤、每一步怎样算完成，以及由哪个引擎来做。在你回答“开始”之前，什么都不会启动。用文字提出修改，主导会话会重写计划。

**3. 执行步骤**

每一步在自己的分支上运行，最多同时 3 个。一步完成后，如果有另一个已登录的引擎，就由它来检查。检查两次未通过的步骤会等你处理。

**4. 获取结果**

默认情况下，最终每一步的拉取请求都已就绪且检查通过；主导会话会建议合并顺序。

步骤中的问题先交给主导会话；只有你能决定的事，会出现在主导会话的对话中。设置位于配置中的 `orchestration` 下；`"orchestration": false` 可以关闭它。

## 会话之间的通信

同一台电脑上的对话可以互相发消息（通过 [A2A](https://a2a-protocol.org/) 协议）。可以让智能体去问另一个会话，或在另一个文件夹中开始工作。

* 发给正在工作的会话的消息会加入它当前的请求；否则会在那里开始一个新请求。
* 接收消息的会话使用它自己的权限工作，并自己请求批准。
* 向另一个会话发送消息或停止它，在 `ask` 模式下会先询问，在 `read-only` 模式下会被拒绝。
* 只有在你要求时，智能体才会打开新会话；否则它会把工作拆给子智能体。
* 在没有人参与的情况下来回 8 条消息后，不再继续发送。

用 `"a2a": false` 关闭；写在项目的配置中时，只对那个文件夹关闭。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.