Ucp Checkout A2a — Ucp 结账 A2A

UCP Checkout — A2A Binding 编写代码前，请检索实时规范：在网站 ucp.dev 上搜索“checkout-a2a”并获取该页面以了解确切的消息结构、DataPart 键和 Agent Card 格式。同时，请查看 Google 的 A2A 协议规范以了解底层传输：https://google.github.io/A2A/ 概念架构 什么是 A2A？ A2A（Agent-to-Agent）是一种用于自主的 inter-agent 通信的协议。UCP 的 A2A 绑定允许平台代理使用结构化消息与业务代理通信，而不是使用 REST 调用。 工作原理 发现：业务在其 /.well-known/ucp 配置文件中声明的 URL 下发布 Agent Card，位于 services.dev.ucp.shopping.a2a.endpoint。 通信：平台发送包含结账数据的 DataPart 对象的消息。业务代理使用 DataPart 对象响应结账状态。 识别：平台包含 UCP-Agent 标头和 X-A2A-Extensions 标头，引用 UCP 规范版本。 关键 Data Part 键 键 方向 目的 a2a.ucp.checkout 双向 结账会话数据 a2a.ucp.checkout.payment_data 平台 → 业务 结账支付凭证 a2a.ucp.checkout.risk_signals 平台 → 业务 可选风险信号 ap2.merchant_authorization 业务 → 平台 商家的 JWS 分离内容签名，用于 AP2 授权流 ap2.checkout_mandate 平台 → 业务 SD-JWT+kb 凭证，证明用户授权代理结账 消息结构 消息使用 A2A 的标准格式： messageId：唯一 ID（用于幂等性） contextId：会话/对话 ID kind： “message” role： “user”（来自平台）或 “agent”（来自业务） parts：TextPart 和 DataPart 对象的数组 结账数据包含在具有适当键的 DataPart 中。 幂等性 业务代理使用 messageId 来检测重复请求。任务跟踪使用 taskId 和 contextId。 何时使用 A2A 完全自主的代理到代理商务（大多数步骤无需人工干预） 多代理架构，其中商务是众多功能之一 当您希望业务维护其自身的代理逻辑（而不仅仅是暴露工具）时 实现指南 在实现之前，请从 https://github.com/Universal-Commerce-Protocol/samples（查找 a2a/ 目录）获取最新的 A2A 业务代理示例，以查看参考模式。