A2A 方法、执行与回执边界

公开既有 A2A 页仅修正错误;

模型与受理

普通消息的模型解析允许显式 params.model、智能体默认模型或模型配置;均无可用绑定时尝试当前平台默认策略与有权限的 agent_chat 模型目录。默认策略未配置、不可用或同名后端歧义均会失败,不能承诺省略一定成功。顶层 model 不参与本次参数选择。

直接 message/send 在受理后返回,不支持 configuration.blocking:true。Go SDK 默认跟踪 submitted/working,设置客户端 NoWait 可只取受理;CLI –no-wait 对应此行为,不发到服务端。Python A2ARequest 当前没有 no_wait 选项,默认跟踪,已有通用 resource_any 可做原始请求;不能虚构 Python 专用参数。

六个方法

方法

关键输入

返回与限制

message/send

用户 message,真实 messageId/contextId,按任务选择模型与 metadata

普通任务或控制/反馈/交互消息回执。

message/stream

同发送,开启 SSE

JSON-RPC 帧与 heartbeat;流结束/断连不等于任务成功或取消。

tasks/get

id 优先于 taskId;afterSeq 默认 0

A2A Task 投影;afterSeq 会传入事件读取,并非固定 0。

tasks/resubscribe

id/taskId 与 afterSeq

订阅事件;输入/授权等待可结束当前流,需继续处理任务。

tasks/cancel

id/taskId

取消请求后回读;metadata.cancellationAccepted:true 可能仍伴随活动状态,需等待最终状态。

matrixflow/input.submit

taskId、当前 requestId、answers 对象

继续原任务;requestId 不等于外层 JSON-RPC id,也不是 turnId。

输入答复示例:

{"agent_id":"agent-example","jsonrpc":"2.0","id":"rpc-example","method":"matrixflow/input.submit","params":{"taskId":"task-example","requestId":"input-example","answers":{"question-example":{"answers":["实际答案"]}}}}

当前 Go/Python 的 AgentInputSubmission 辅助类型仍构造 turnId/callId,没有内层 requestId;使用经核对的原始 A2A params,不能把外层 RequestID/request_id 当修复内层字段。

重新生成

仅重放已完成且归属当前账户、智能体、工作区与 context 的源任务;需要可读取的源 manifest/input。controlId 固定保留,action 当前只 regenerate;rerunMode 省略或 same_manifest;conversationMode 省略/replace_view/branch。非空 override 或 checkpointId 当前不支持,不据结构字段存在宣称可覆写。

branch 还要求能恢复原用户问题和源回答谱系,不能把所有旧任务都宣称可分支。guidance 作为重新生成的修改要求,不是对已保存文本的 PATCH。重复控制的任务标识依赖模式:branch 使用工作区、context、controlId,其他模式还依赖源任务/消息标识;重试保留原 JSON 和相关标识,不能只复用外层 RPC id。

成功可能返回 Task 或带 moi.run.control.result 的 Message;从相同 controlId 读取实际新 taskId,再 tasks/get 核对。受理、created、内嵌 task 标签均不能替代真实新任务状态。

错误

两个公开路径进入同一 handler 后使用 JSON-RPC;前置认证/角色/工作区可先返回产品错误。参数/权限/未找到/冲突/不支持/依赖/内部错误分别映射;不再按旧文档把 tasks/get 全部错误当 404,也不把通用入口当旧转发进程。

本地额外 owner 夹具注入失败执行结果与失败存储状态,控制回执内嵌 task.status.state 仍固定 completed,见 ../regenerate-receipt-evidence.json。属于候选一致性问题,未验证真实 Provider/线上;公开指南继续要求读取新任务确认,不把该夹具当生产故障。

最后更新于