第 24 讲：交接链——跨 Agent 的状态传递

问题

客服 Agent 处理到一半发现需要技术支持，技术 Agent 接手后却对用户说"请描述一下您的问题"——交接丢状态，用户被迫重复，体验断崖。多 Agent 系统的最后一公里，往往断在交接上。

核心模式

交接链（Handoff Chain）：交接不是简单的"转接"，而是一份结构化的交接单（handoff brief），包含接手方续跑所需的一切。

@dataclass
class HandoffBrief:
    summary: str            # 三句话说清来龙去脉
    user_goal: str          # 用户的真实目标（不是表面请求）
    known_facts: dict       # 已确认的事实，接手方不得重复询问
    tried: list[str]        # 已尝试的方案及结果，避免重蹈
    pending: list[str]      # 待办事项
    artifacts: list[Ref]    # 相关产物指针（日志/文件/会话记录）

def handoff(from_agent, to_agent, reason):
    brief = from_agent.compose_brief(reason)   # 移交方负责写交接单
    validate(brief)                             # 缺关键字段则拒绝交接
    return to_agent.resume(brief)               # 接手方从交接单续跑
复制

铁律：用户感受到的应该是一次连贯的服务，而不是多次转接。交接单就是 Agent 之间的"病历转院单"。

实战要点

• 交接单由移交方撰写：它最清楚已发生什么；接手方只做完整性校验
• "known_facts 不得重复询问"必须写进接手方的 system——这是体验连贯的关键
• 交接要有回退路径：接手方发现接不了（能力不符），能带着补充信息交回或升级，而不是卡死
• 至此六模块 24 模式收官。回顾全课：上下文与记忆是地基，推理与执行是主干，自我改进是飞轮，多 Agent 是规模化的终局——模式不在多，在于看清问题后选得准