coding-agent/s15_agent_teams/代码讲解.md

S15 Agent Teams 代码讲解

这一节只讲相对 S14 新增的内容：

Lead Agent 可以启动队友 Agent，并通过文件邮箱互相发消息。

---

1. 本节新增内容

• MessageBus：基于文件的消息总线。
• .mailboxes/：每个 Agent 的收件箱目录。
• active_teammates：记录正在运行的队友。
• spawn_teammate_thread()：在后台线程中启动队友 Agent。
• run_spawn_teammate()：Lead 启动队友的工具处理器。
• run_send_message()：Lead 给队友发消息。
• run_check_inbox()：Lead 检查收件箱。
• 3 个新工具：spawn_teammate、send_message、check_inbox。

---

2. MessageBus 数据结构

消息保存成 JSONL，每行是一条消息。

单条消息结构：

{
    "from": "lead",
    "to": "worker1",
    "content": "请检查这个文件",
    "type": "message",
    "ts": 1720000000.0
}

文件路径：

.mailboxes/
  lead.jsonl
  worker1.jsonl

每个 Agent 有自己的收件箱。

---

3. MessageBus.send()

作用：把消息追加到目标 Agent 的邮箱文件。

BUS.send("lead", "worker1", "请检查测试")

会写入：

.mailboxes/worker1.jsonl

---

4. MessageBus.read_inbox()

作用：读取某个 Agent 的收件箱。

教学版采用“读完即删除”：

read_text()
unlink()

这表示消息被消费了。

---

5. spawn_teammate_thread(name, role, prompt)

作用：启动一个队友 Agent。

队友有自己的：

messages: list[dict]
system: str
sub_tools: list[dict]
sub_handlers: dict[str, function]

队友的工具包括：

bash
read_file
write_file
send_message

重点是：队友可以通过 send_message 把结果发回 Lead。

---

6. Lead 工具

Lead 新增三个团队工具：

spawn_teammate(name, role, prompt)
send_message(to, content)
check_inbox()

模型调用示例：

{
    "name": "spawn_teammate",
    "input": {
        "name": "reviewer",
        "role": "代码审查员",
        "prompt": "请检查当前改动"
    }
}

---

7. 本节课堂重点

Agent Team 的本质是：

多个 Agent 各自有独立 messages
通过 MessageBus 交换信息
Lead 负责启动、收消息、继续决策

这不是简单的子 Agent 摘要返回，而是更接近多 Agent 协作。