支払いとコマース

adk-payments は、ADK-Rust にプロトコルに依存しないコマースオーケストレーションを追加します。これは、生の支払いアーティファクトを会話履歴やセマンティックメモリに漏らすことなく、複数のプロトコルアダプターを横断する単一の永続的なトランザクションモデルを必要とするエージェント型コマースフロー向けに設計されています。

サポートレベル

  • ACP 安定版 2026-01-30: チェックアウト、完了、キャンセル、委任された支払い、および注文のフォローアップのための本番環境向けのベースライン。
  • ACP 実験版: 機能ゲートされた検出、委任認証、および Webhook 拡張。これらのルートは、進化する ACP ドラフトの互換性サーフェスとして扱われます。
  • AP2 v0.1-alpha: 型付き委任、支払い、領収書、介入、A2A、および MCP に安全な現在のアルファプロトコル形状に対するサポート。

主要なジャーニー

  • ACP 人間が関与するチェックアウトと委任された支払い、それに続くマーチャントまたは Webhook による注文更新。
  • AP2 人間が関与する買い物客、マーチャント、資格情報プロバイダー、および支払い処理業者との連携。
  • AP2 人間が関与しない意図の実行(自律的な完了または明示的な購入者の再確認のいずれか)。
  • ACP と AP2 が同じ正規トランザクションID とジャーナルに関連付けられるデュアルプロトコルマーチャント展開。
  • 永続的なジャーナルとマスクされたメモリがトランスクリプトの損失後も存続する圧縮後のリコール。

セキュリティと耐久性

  • 生の委任、署名、委任された資格情報、および領収書ペイロードは、adk-artifact によってバックアップされた証拠ストレージに保持されます。
  • 永続的なトランザクション状態は、脆弱な会話専用のコンテキストではなく、構造化されたジャーナルを介して adk-session に存在します。
  • セマンティックリコールは、adk-memory を介してマスクされた要約を使用します。
  • adk-auth は、リクエストID、テナントスコープ、および監査メタデータをバインドします。
  • 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/ の下のサンプルクレートは、サポートされているジャーニーのシナリオインデックスであり、統合テストは、プロトコル、ジャーナル、および証拠の動作の実行可能な真実です。

支払いとコマース - ADK-Rust ドキュメント | ADK-Rust