A2A互操作:消息、任务和产物分开管理
A2A互操作:消息、任务和产物分开管理,从执行机制、错误边界与可运行例子理解工程取舍。
向另一个Agent委派“比较两份政策并生成报告”,对方可能立即接单,随后请求补充版本,几分钟后才生成产物。一次HTTP响应只能说明当时发生了什么,不能把接单成功直接解释为研究完成。
发现能力与建立信任
Agent Card描述服务身份信息、技能、接口和支持能力等,帮助调用方发现是否适合某类任务。技能声明不是真实能力证明,也不是授权凭证;需要核对可信来源、认证要求、版本和实际行为。恶意服务也能自称擅长安全审计,因此能力测试和信任策略要独立。
A2A关注Agent之间的任务交互,而不要求双方公开内部提示词、推理过程或框架。MCP更常用于接入工具与资源,两者可以嵌套:一个Agent通过MCP使用数据库,同时通过A2A委派报告工作。选择依据是交互生命周期,不是“是否使用了大模型”。
Message、Task、Artifact的区别
Message是一次交流内容,可以是任务输入、澄清或反馈;Task是有身份和状态的工作单元;Artifact是任务产生的结果,如报告文件或结构化表。消息文本中说“报告已完成”不应替代可读取的产物和任务终态检查。
状态可表达已提交、执行中、需要输入、完成、失败或取消等语义,具体枚举和线格式必须以所选版本为准。需要输入通常意味着等待调用方补充,并非失败;终态之后要开始新工作,应按协议新建任务或约定新流程,而不是任意修改历史成功记录。
异步交互与重复事件
服务可以支持流式进度、轮询或异步通知,客户端应按能力选择。事件携带任务与上下文标识,重连后可能收到重复或迟到事件,状态合并应保护终态,不能被旧working事件倒退。通知端点还涉及认证与网络目标校验,不能把用户提供的任意URL当安全回调。
取消是一项请求,是否接受和何时停止需看任务状态。产物访问有独立权限与生命周期,外部链接还可能过期;应验证实际内容、格式和来源。多个产物分块返回时明确追加与完成语义,不能把第一块当最终报告。
跟做:等待输入后继续,终态拒绝倒退
保存为task_artifacts.py,运行python -X utf8 task_artifacts.py。这是自定义内存状态模型,演示生命周期,不是A2A序列化格式或完整SDK实现。这里额外要求完成时提供产物,是本例业务规则,不宣称协议所有任务都必须有产物。
"""异步任务状态模型,非A2A线协议实现。"""
ALLOWED={'submitted':{'working','canceled'},'working':{'input-required','completed','failed','canceled'},'input-required':{'working','canceled'}}
class Task:
def __init__(self):self.state='submitted';self.artifacts=[]
def transition(self,target,artifact=None):
if target not in ALLOWED.get(self.state,set()):raise ValueError('invalid_transition')
if target=='completed' and artifact is None:raise ValueError('missing_result')
self.state=target
if artifact is not None:self.artifacts.append(artifact)
if __name__=='__main__':
task=Task()
for state in ['working','input-required','working']:task.transition(state);print('状态',task.state)
task.transition('completed',{'id':'report-1','mime':'text/plain','text':'已核对两份政策'})
print('产物',[x['id'] for x in task.artifacts])
try:task.transition('working')
except ValueError as e:print('终态拒绝',str(e))实际运行输出:
状态 working
状态 input-required
状态 working
产物 ['report-1']
终态拒绝 invalid_transition任务从working进入input-required,再返回working,最后记录report-1;完成后试图回到working被拒绝。将完成时artifact删去,会触发本例missing_result。可见完成条件由协议状态与业务可验证结果共同组成。
接入时怎么验收
固定双方协议版本,先做发现和认证,再测试立即响应、异步进度、需输入恢复、失败、取消、重复通知与产物读取。任务ID、消息ID和业务幂等键分别有作用,不能用一个ID随意替代全部。规范页面会演进,本文只讨论经核对的概念,未提供真实跨框架互通结果。
综合追问:Agent接单后等待输入,后来收到旧working事件,应如何处理?
这是给定条件下的机制推演;数值用于解释判断,不是新增线上或模型实测。先独立回答,再核对下面的推理。
展开推理、取舍与排错路径
Agent Card和skills声明用于发现候选接口与能力,不能证明可信或已授权;固定来源、版本并做能力测试后再委派。Message是交互内容,Task承载工作身份和状态,Artifact是可验证结果,文本“完成”不能代替实际报告。短请求直接交流和可恢复长任务的取舍由生命周期决定,不要求双方公开内部推理。
等待输入不是失败,补资料后按协议继续;流式进度、轮询与回调按能力选用,异步回调还需认证和网络目标限制。完成后迟到working不得倒退终态,按任务与事件身份去重合并;取消也可能晚于提交。排查“成功但没文件”时检查产物分块是否完整、链接是否过期及读取权限,而非只看HTTP200。面试应把发现、信任、状态恢复、结果验证分开回答。
课后练习展开习题收起习题
先独立作答,再展开参考思路。检查自己的解释是否包含机制、条件和反例。
为什么接单成功不是任务成功?
参考思路与常见误区
长任务可能仍执行、等待输入或随后失败,应检查任务终态和可验证结果。
常见误区:把HTTP200当完成。
Agent Card证明服务可信吗?
参考思路与常见误区
只提供声明和发现信息,需要来源认证、授权策略与能力测试。
常见误区:把自我声明当安全认证。
Message和Artifact区别?
参考思路与常见误区
Message用于交流,Artifact承载工作结果;报告存在需验证实际产物而不是一句完成声明。
常见误区:将所有消息都当最终产物。
重复或迟到进度怎么处理?
参考思路与常见误区
按任务标识和事件顺序策略去重合并,保护终态不被旧状态覆盖。
常见误区:按到达顺序无条件覆盖。
A2A必须公开内部推理吗?
参考思路与常见误区
不必,互操作围绕外部任务契约,内部框架和推理实现可以隐藏。
常见误区:互通等于共享所有内部状态。