Agent开发（六）：多agent协作

SUBAGENTS = {
    "send-email": {
        "description": "起草、确认邮件。用户要发邮件、写邮件、回复邮件时派给它。",
        "system_prompt": "你是邮件子代理，只负责起草邮件。按 skill 的步骤执行。缺信息就列出要问用户的问题，不要编造，也不要整理会议纪要。",
        "skills": ["send-email"],
    },
    "meeting-notes": {
        "description": "把零散的会议记录整理成纪要和待办。用户给出会议内容或要求整理纪要时派给它。",
        "system_prompt": "你是纪要子代理，只负责整理会议纪要。按 skill 的步骤执行。没有原文就说明需要原文，不要起草邮件。",
        "skills": ["meeting-notes"],
    },
}

def parent_prompt(agent, system_prompt: str) -> str:
    catalog = "\n".join(f"- {name}: {spec['description']}" for name, spec in SUBAGENTS.items())
    return (
        f"{system_prompt}当前的系统时间是：{datetime.now().strftime('%Y-%m-%d %H:%M:%S')}。\n\n"
        f"可派发的子代理：\n{catalog}"
    )

SYSTEM_PROMPT = "你是调度助手，你叫‘测试助手’，用中文回答。你不直接写邮件，也不直接整理纪要，只把任务派给子代理，再把结果转述给用户。"

def call_subagent(args):
    name = args.get("name", "")
    task = args.get("task", "")
    spec = SUBAGENTS.get(name)
    if spec is None:
        return f"没有这个子代理，可用的有：{', '.join(SUBAGENTS)}"
    allowed = {key: SKILLS[key] for key in spec["skills"] if key in SKILLS}
    child = Agent(
        context_id="",
        api_key=api_key,
        base_url=base_url,
        model_name=model_name,
        max_tokens=max_tokens,
        system_prompt=spec["system_prompt"],
        dynamic_system_prompt=skill_prompt(allowed),
        tools=SKILL_TOOLS,
    )
    child.tool_handlers["load_skill"] = lambda a: load_skill(child, a, allowed)
    child.tool_handlers["read_skill_file"] = lambda a: read_skill_file(a, allowed)
    logger.info("下发 %s: %s", name, task)
    response = child.chat(task)
    result = response["choices"][0]["message"].get("content") or ""
    logger.info("完成 %s", name)
    return result

> 你好，帮我发邮件给小王，内容是督促他学习。
好的，我把这件事交给发邮件子代理处理。
call_00_uuoTN3OnN6VFg7x38ioX1936 call_subagent {"name": "send-email", "task": "用户（测试助手转述）要求：给\"小王\"发一封邮件，内容是督促他学习。\n\n已知事实：\n- 收件人称呼：小王（用户只提供了称呼，未提供邮箱地址）\n- 邮件目的：督促小王学习\n- 当前系统时间：2026-10-12 16:31:05\n\n需要你完成：\n1. 起草这封督促学习的邮件。\n2. 由于缺少收件人邮箱地址，以及发件人身份、具体学习目标/截止时间等信息，请先向用户确认这些必要信息，不要擅自编造邮箱地址。\n3. 确认后再完成发送，并把最终结果反馈回来。"}

result: call_00_uuoTN3OnN6VFg7x38ioX1936 call_subagent ... 我已按 skill 流程加载了模板。以下是草稿，但有几个必要信息缺失，需要你先确认，我不会擅自编造。

待确认信息：
1. 收件人邮箱地址
2. 发件人身份/署名
3. 具体学习目标
4. 截止时间/节点
5. 期望回复时间
6. 是否需要抄送其他人

草稿（占位信息待补充）：
收件人：【待确认：小王的邮箱地址】
主题：关于学习进度的提醒与督促
正文：小王，你好：……麻烦你在【待确认：期望回复时间】前回复我一下你的学习计划和当前进度。
落款：【待确认：落款/发件人】

当前状态：草稿已生成，未发送。

我问了负责邮件的小助手，草稿已经拟好了，但有几项必要信息缺失，还没发送（缺邮箱地址也没法发）。需要你补充：

1. 小王的邮箱地址
2. 发件人身份/署名
3. 具体学习内容
4. 截止时间/节点
5. 希望你什么时候收到回复
6. 是否需要抄送其他人

你把上面几项补齐（至少邮箱、学习内容、期望回复时间、落款），我就让邮件小助手出终稿并帮你发送。