AI Agent / 系统课时

实现任务移交

实现任务移交

多 Agent 协作真正难的不是“把下一句话交给另一个 Agent”,而是让接手者准确知道目标、当前状态、已完成工作与剩余责任。本课用一个可执行的移交包,建立可验证、可追踪的角色切换协议。

学习目标

  • 设计包含目标、上下文、已完成工作和待办事项的任务移交包
  • 在发送方与接收方之间建立明确的验收条件与责任边界
  • 用最小代码实现移交校验,避免上下文丢失和重复执行

把任务移交看成状态交接

任务移交不是聊天记录转发,而是把“执行权”从一个角色切换到另一个角色。一个可靠的移交包至少要回答四个问题:为什么现在要移交、已经做到哪里、下一步具体做什么、接手者完成到什么程度才算结束。

多 Agent 任务移交时序

最小字段建议包括任务标识、来源角色、目标角色、目标、上下文摘要、已完成工作、待办、约束、证据引用和验收条件。聊天全文可以作为审计材料保留,但不应成为接手者理解任务的唯一来源。

定义可验证的移交包

上一课的主管先完成两项核查,再把可送审的业务任务移交给审查角色。OpenAI Agents SDK 的 handoff() 会切换当前运行的会话角色,也可过滤传给接手者的历史。持久任务的所有权由业务服务另行维护。本例使用临时 SQLite 模拟这一步。

python
import sqlite3
from dataclasses import dataclass

ALLOWED = {("supervisor", "reviewer")}


@dataclass(frozen=True)
class Packet:
    task_id: str
    expected_version: int
    sender: str
    receiver: str
    next_action: str
    evidence_refs: tuple[str, ...]


def accept(db, packet, tenant, authenticated_sender, authenticated_receiver, required_refs):
    if not isinstance(packet, Packet) or any(
        not isinstance(value, str) for value in (packet.task_id, packet.sender, packet.receiver)
    ):
        return "invalid_packet"
    if (
        (packet.sender, packet.receiver) not in ALLOWED
        or (packet.sender, packet.receiver) != (authenticated_sender, authenticated_receiver)
    ):
        return "denied"
    if (
        not packet.task_id.strip() or type(packet.expected_version) is not int
        or packet.expected_version < 1 or packet.next_action != "review"
        or not isinstance(packet.evidence_refs, tuple) or not packet.evidence_refs
        or any(not isinstance(ref, str) for ref in packet.evidence_refs)
        or len(set(packet.evidence_refs)) != len(packet.evidence_refs)
        or set(packet.evidence_refs) != required_refs
    ):
        return "invalid_packet"
    if db.in_transaction:
        raise RuntimeError("handoff needs an idle connection")

    with db:
        db.execute("BEGIN IMMEDIATE")
        result = db.execute(
            """UPDATE tasks SET owner = ?, version = version + 1
               WHERE tenant = ? AND task_id = ? AND owner = ? AND version = ?
                 AND state = 'ready_for_review'""",
            (packet.receiver, tenant, packet.task_id, packet.sender, packet.expected_version),
        )
        return "accepted" if result.rowcount == 1 else "stale_or_unavailable"


if __name__ == "__main__":
    db = sqlite3.connect(":memory:", isolation_level=None)
    db.execute(
        """CREATE TABLE tasks (
           tenant TEXT, task_id TEXT, owner TEXT, version INTEGER, state TEXT,
           PRIMARY KEY (tenant, task_id)
        )"""
    )
    db.execute("INSERT INTO tasks VALUES ('team-a', 'case-42', 'supervisor', 3, 'ready_for_review')")
    packet = Packet("case-42", 3, "supervisor", "reviewer", "review", ("quote-1", "sla-1"))
    for _ in range(2):
        print(accept(db, packet, "team-a", "supervisor", "reviewer", {"quote-1", "sla-1"}))
    print(db.execute("SELECT owner, version FROM tasks").fetchone())
    db.close()

预期输出

text
accepted
stale_or_unavailable
('reviewer', 4)

移交后如何继续

目标、验收条件、已完成结果和约束可以由接手者按任务 ID 和版本从受控存储加载。包内只携带下一步及必要证据引用。调用方从已认证的服务身份确定发送和接收角色,从该任务当前版本的验收记录获得全部必需证据 required_refs,并验证接手者能读取它们。若证据无法完整读取,不应受理移交。在真实系统中,状态修改、权限校验和移交事件需保持一致。若响应丢失,查询当前归属和版本,避免把一次成功移交执行两遍。

任务更新条件包含租户、原负责人、版本和前置状态。并发请求只有一个能从同一版本更新成功。原负责人仍可能有在途动作,因此执行写入前还要检查当前版本与归属,外部写入使用稳定幂等键。接手者发现输入不足时,记录结构化阻塞原因,并由调度器决定如何继续。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

实现任务移交

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通