ADK-Rust

支付与商务

adk-payments 为 ADK-Rust 添加了协议中立的商务编排功能。它专为代理商务流程设计，这些流程需要在多个协议适配器之间使用一个持久的事务模型，而不会将原始支付工件泄露到对话历史或语义记忆中。

支持级别

  • ACP 稳定版 2026-01-30: 面向生产的基线，用于结账、完成、取消、委托支付和订单跟踪。
  • ACP 实验版: 功能门控的发现、委托认证和 webhook 扩展。将这些路由视为不断演进的 ACP 草案的兼容性接口。
  • AP2 v0.1-alpha: 类型化的授权、支付、收据、干预、A2A 和对当前 alpha 协议形态的 MCP 安全支持。

主要流程

  • ACP 人工在场的结账，通过委托支付，随后是商家或 webhook 的订单更新。
  • AP2 人工在场的购物者、商家、凭证提供商和支付处理器协调。
  • AP2 人工不在场的意图执行，可选择自主完成或明确的买家再次确认。
  • 双协议商家部署，其中 ACP 和 AP2 关联到相同的规范事务 ID 和日志。
  • 压缩后召回，其中持久日志和掩码内存可在转录丢失后幸存。

安全与持久性

  • 原始授权、签名、委托凭证和收据负载保留在由 adk-artifact 支持的证据存储中。
  • 持久事务状态通过结构化日志存在于 adk-session 中，而不是脆弱的仅对话上下文中。
  • 语义召回通过 adk-memory 使用掩码摘要。
  • adk-auth 绑定请求身份、租户范围和审计元数据。
  • adk-guardrail 在状态持久化之前应用金额、商家、协议版本、干预和编辑策略。

验证路径

使用集成测试作为权威的端到端验证路径：

cargo test -p adk-payments --features acp --test acp_integration_tests
cargo test -p adk-payments --features ap2,ap2-a2a,ap2-mcp --test ap2_integration_tests
cargo test -p adk-payments --test cross_protocol_correlation_tests
cargo test -p adk-payments --features acp-experimental --test acp_experimental_integration_tests

参考文件：

  • adk-payments/tests/acp_integration_tests.rs
  • adk-payments/tests/ap2_integration_tests.rs
  • adk-payments/tests/cross_protocol_correlation_tests.rs
  • examples/payments/README.md

位于 examples/payments/ 下的示例 crate 是支持流程的场景索引，而集成测试是协议、日志和证据行为的可执行事实依据。