エージェントシステムと標準 · 第4章(全8章)
支払うエージェント:UCPとAP2
エージェントがUCPで加盟店のチェックアウトを進める方法と、AP2のマンデートが支払いを人の署名した内容に結びつける方法。
目標
- チェックアウトセッションを作成して完了します。未完了
- スマートフォンでマンデートに署名します。未完了
- 署名の後で金額を変え、検証が失敗するのを確かめます。未完了
- 確認問題に合格します。未完了
ステップ1/4: 本文
UCP:チェックアウト
UCP(Universal Commerce Protocol、バージョン2026-08-25)は、ショッピングエージェント(プラットフォーム)が加盟店(ビジネス)から購入するための仕組みです。ビジネスは/.well-known/ucpにプロファイルを公開します。バージョン、checkoutなどの機能、決済ハンドラー、RESTエンドポイントです。エージェントはそれを読み、POST /checkout-sessionsでチェックアウトセッションを作成し、ステータスがready_for_completeになるまでPUTで更新し、POST …/completeで終えます。
すべての呼び出しはプラットフォーム自身のプロファイルを指すUCP-Agentヘッダーを持つので、ビジネスはプラットフォームが何に対応しているかを確認できます。すべての書き込みはIdempotency-Keyを持ちます。タイムアウトでエージェントが同じリクエストを再送しても、ビジネスは2回処理せずに最初の結果を返します。Haldenの注文48213のような二重請求こそ、これが防ぐものです。
AP2:人の署名
UCPだけでは、セッションを持つ者を誰でも信頼します。AP2(Agent Payments Protocol)は同意の証明を加えます。エージェントのプロバイダーは、SD-JWTの検証可能な資格情報として2つのマンデートを発行します。Haldenが署名したチェックアウトそのもののハッシュを持つチェックアウトマンデートと、金額、受取人、カードを持つ支払いマンデートです。人はエージェントが描画できない画面、つまりスマートフォンのウォレットでそれを確認し、スマートフォンの鍵がそれぞれにキーバインディングJWTの署名をします。
Haldenは、チェックアウトマンデートを自分が署名したチェックアウトと照合します。カードウォレットは、その金額の決済トークンを発行する前に支払いマンデートを確認し、決済処理業者は請求する前にトークンを確認します。人が署名した後でカートや金額を変えると、エージェントが何を言おうと、ハッシュや署名が一致しなくなります。
ここでは人がその場にいます。AP2の自律モードでは、人はその場にいません。最高価格などの上限を付けたオープンなマンデートを前もって承認し、エージェントはその範囲内で最終的なマンデートに署名します。
ANPを2文で
ANP(Agent Network Protocol)は、オープンなWebで出会うエージェントのためのものです。各エージェントはdid:wba識別子を持ち、そのDIDドキュメントは自分のドメインから配信され、公開鍵を並べます。すべてのリクエストはHTTP Message Signaturesで署名されるので、相手はアカウントなしにどのエージェントが送ったかを知ります。「さらに先へ」のステップにあるANPのラボでこれが動きます。
ここですること
ショッピングエージェントがHaldenのテントRidge 2を購入します。チェックアウトを追い、スマートフォンで承認し、次に「傍受」をオンにしてもう一度実行し、署名の後で金額を上げます。
ステップ2/4: 試す:署名の連鎖
署名の連鎖
5つのステップと、任意の2つのステップがあります。ステップの下の連鎖には、購入が各リンクに達するたびに、そのリンクとそれを確認する者が加わります。連鎖の下では、ラボがすべてのメッセージを上から順に1行ずつ描きます。
モード:本物シミュレーション本物:UCPのRESTバインディング(SDKなしで仕様どおりに実装)、AP2のSD-JWTマンデート(@sd-jwt/sd-jwt-vc 0.21.1)とこのページで作るWebCryptoの鍵によるES256署名、「さらに先へ」のラボのANPの署名付きリクエスト。シミュレーション:決済の精算と、モデルをつながない場合のエージェントの判断。店とカードは架空です。
ステップ3/4: 確認問題
確認問題
次:質問2/4
ステップ4/4: これでできること
これでできること
- UCPのチェックアウトセッションを、プロファイルからcompletedまで追えます。
- AP2のマンデートが、支払いを人の署名付きの同意にどう結びつけるかを説明できます。
- べき等キーを使って、再試行を安全にできます。
- ANPのdid:wbaと署名付きリクエストが加えるものを2文で説明できます。