访客事件流与文件边界¶
流式消息、附件暂存和任务产物读取有不同的完成条件,不能只检查HTTP成功。
消息与流¶
公开A2A仅注册POST并接受JSON-RPC 2.0的message/stream。消息必须引用事先创建的contextId,message.parts不能为空,且须有非空文本或文件/图像附件;MCP上下文data不能单独构成消息。text、file、image及指定MCP应用上下文data分支各有校验;任意data、provider交互答复、运行控制和反馈分支不作为公开消息能力。
不接受configuration.blocking=true,params及消息/运行metadata中的locale也被拒绝。params.metadata的同名值覆盖message.metadata。
流打开前检查当前链接、session和会话绑定。流打开后执行失败以JSON-RPC错误帧返回;成功终止必须由任务状态及终止帧判定。任务持久准入后,浏览器断开不取消已准入任务,可回读会话消息与任务事件。准入超时可能与持久化并发,使用返回contextId回读,不直接重复创建新任务。
后续事件重读重新检查链接。停用/轮换后可在下一次重读拒绝继续投影;这个读取边界不承诺后台执行立即取消。
附件¶
使用multipart字段file上传,实际文件最大200 MiB;handler约束整个请求为201 MiB以内。Content-Length未知时按201 MiB预占,不能当按实际文件字节计费。当前发布共享24小时1 GiB上传预算及100次预占尝试上限,失败或放弃尝试仍占用已预留量;429/code18表示预算不足。
上传返回暂存文件及file_token。提交消息需要同时提供:parts中的moi://files/{file_id}引用、metadata.attachments中的workspace_id/volume_id/file_id,以及metadata.webapp_file_credentials中每个file_id对应的file_token。不同访客、工作区、文件或过期凭据不能互换。metadata.files旧形式被拒绝;任意文件URL不产生文件授权。
file_token约束到访客、发布和文件,有独立签名purpose及有效期。上传成功不表示文件已提交给运行;
任务产物¶
下载/预览要求文件source=agent_tool且source_session_id/source_task_id匹配当前会话/任务,不接受任意已上传文件。下载使用attachment;预览使用inline,响应类型取实际元数据。
预览不支持、过大或转换失败分别返回415、413/code19、422/code20。在文件仍可下载且准入成立时可改用下载;预览流已经开始后发生错误会中断连接,不能承诺还有完整JSON错误包。