agentic commerce
AI のバリスタと話して、コーヒーを選び、カートに入れ、払う店です。公開されている agentic commerce の参照実装に、日本語化、Amazon Pay と Stripe の決済、運営者の画面を足しました。
本家の上に、何を足したか
元は、Anthropic が GitHub で公開している参照実装 commerce-agents(Apache-2.0)です。買い手の AI と運営者の AI、道具、店と運営者の画面までがそろっています。ただ、本家の説明のとおり、注文も課金もしません(checkout はカートを見せるところまで)。この作品は、その上に決済と日本の店を足したものです。
| 足したもの | 中身 | 本家では |
|---|---|---|
| カード決済 | Stripe の Payment Element で受け、サーバが金額を決めて PaymentIntent を作る。3D セキュアから戻ったあとの処理と、署名を確かめる Webhook。保存したカードで 2 回目からワンクリック | 決済の実装は無い |
| Amazon Pay | Amazon Pay のボタンと、公式の SDK での署名。支払い方法を保存して、2 回目からワンクリック | 無い |
| 購入の確定 | 金額はブラウザではなく、サーバのカートから決める。1 回の購入を 1 件の記録にして、二重の課金を防ぐ。注文を保存する | 注文を作らない |
| 取消と返金 | 全額の返金と、返金の状態の確認。処理中のまま残った返金は、後から確かめ直して片付ける。二重の返金を防ぐ。AI の道具にはせず、画面から人が行う | 無い |
| 日本の店 | 日本のコーヒー店の 50 品、円での表示、日本語の検索語、日本語と英語の切り替え | 英語と米ドル。架空の店の 4 業種 |
| モデルの切り替え | 設定で、Anthropic API、Bedrock、Bedrock の Converse API、Claude Code から選ぶ。ほかの会社のモデルが道具の呼び出しを本文に書いたときに組み直す。期限が切れた AWS の認証から自分で戻る | 既定は Anthropic API。ほかの呼び先は、差し替えの口と説明だけ |
| 運営者の側 | 価格を円の整数に限る、円での分析、割引の反映を戻す口 | 運営者の AI と、人の承認の仕組みはある |
| 記憶 | 「お客様が話した言語で書く」の規則を 1 つ | 記憶の抽出と保存はある |
本家にあるもの(2 つの AI、道具、運営者の書き込みの承認、記憶、画面の土台)は、足したものに数えていません。本家から写したファイルには、何を変えたかの注記を付けています。
1 回の会話で起きること
AI は道具を呼んでは結果を読み、返事を組み立てます。支払いは会話の外にあり、AI には払う手段を渡していません。
AI に渡した道具
買い手の側に 21 種、運営者の側に 24 種。どれも本家の参照実装のままで、店の中身(商品、カート、決済)を日本向けに差し替えています。
| 側 | 種類 | 道具 | 変わるもの |
|---|---|---|---|
| 買い手 | 読む 10 | 商品の検索と詳細、カート、好み、注文と配送の状態、規約、届け方、記憶の検索、手順書の読み込み | 何も変わらない |
| 買い手 | 画面に出す 6 | 商品、比較、プラン、使い方のガイド、注文の状態、次の候補のボタン | 会話の中のカードだけ |
| 買い手 | 変える 5 | カートに入れる、数を変える、外す、記憶を残す、注文の要約を出す(checkout) | カートと記憶。注文も請求もしない |
| 運営者 | 読む 9 | 売上の概況、指標、キャンペーンの成果、商品、在庫の警告、注文の問題、価格の状況、承認待ち | 何も変わらない |
| 運営者 | 下書き 5 | 商品の情報、価格、在庫、値引き、キャンペーン | まだ反映しない |
| 運営者 | 反映 2 | 反映する、破棄する | 運営者が画面で承認した下書きだけ、店に反映される |
| 運営者 | そのほか 8 | 記憶 2、画面に出す 4(指標、まとめ、変更の前後、候補)、集計 1(読むだけの SQL) | 反映はしない |
人と AI の境目
お金と値段が動くところは、必ず人のボタンを通します。AI のふるまいに頼らず、仕組みで止めています。
| 場面 | AI がすること | 人がすること、仕組みでの止め方 |
|---|---|---|
| 支払い | 注文の要約のカードを出す。checkout の道具は注文も請求もしない | 買い手がカードのボタンを押して払う。ブラウザから Stripe か Amazon Pay へ直接つながる |
| カードの情報 | 触れない | Stripe はブラウザの Stripe.js から Stripe へ直接。店に残るのはブランド、末尾 4 桁などだけ。Amazon Pay は Amazon の画面で選ぶ |
| 2 回目の支払い | 触れない | 保存したカードか Amazon Pay のワンクリックで、どちらも買い手のボタン。カードの保存は、買い手がチェックを入れたときだけ |
| 返金 | 道具が無い | 買い手が注文の取消のボタンを押す |
| 値段と在庫 | 下書きを作り、変更の前後をカードで見せる | 運営者が承認して初めて反映。値段の変更は 20%、割引は 50% まで。本家にある「承認を外す」設定は、このサンプルでは効かないようにした |
| 記憶 | 返事のあと、本人が自分で言った好みや事情を、1 回に 3 件まで残す | 健康、お金、身元に関わること、推測は残さない。話した言語のまま書く |
| テスト環境 | — | Stripe はテストの鍵だけで動き、本番の鍵だと起動しない。Amazon Pay は sandbox で、請求は 1 円 |
モデルの選び方
会話、記憶、運営者の 3 つの役割ごとに、呼び先とモデルを設定で変えられます。
| 呼び先 | 会話 | 記憶 | 運営者 | 使ったところ |
|---|---|---|---|---|
| Claude Code | Sonnet | Haiku | Sonnet | 手元のデモ(自分だけで使う) |
| Anthropic API | Sonnet 5.5 | Haiku 4.5 | Sonnet 5.5 | 招待制のサーバ(2026-11-16 から) |
| Bedrock(Claude) | Claude | 無料プランのアカウントでは呼べなかった | ||
| Bedrock(ほかの会社) | Qwen3 235B | gpt-oss-20b | gpt-oss-120b | 招待制のサーバ(2026-11-16 まで。アカウントで Bedrock が使えなくなり、切り替えた) |
ほかの会社のモデルは、道具の引数を本文に JSON で書いてしまうことがあります。その JSON の項目が、ちょうど 1 つの道具の引数の形に合うときだけ、道具の呼び出しに組み直す層を挟みました。2 つ以上に合うときは組み直しません。
何を試したか
- 買い手の側: AI と話して商品を探し、比べ、カートに入れる。登録したカードや Amazon Pay で払う
- 運営者の側: AI が売れ行きを見て、値下げなどを提案する
- Claude を前提にした作りを、AWS の Bedrock の Converse API につなぐ部品を書き、Claude 以外のモデルで動かした
- 役割ごとにモデルを分けた。今は Anthropic の API で、買い物と運営者が Sonnet 5.5、会話の記憶の抽出が Haiku 4.5。Bedrock のときは Qwen3 235B、gpt-oss-120b、gpt-oss-20b
分かったこと
- AWS の無料プランでは、Bedrock の Claude を呼べなかった。Amazon やほかの会社のモデルは呼べた(2026-11)。
- モデルによって、作法を守る力が大きく違う。同じ 5 つの場面で 8 モデルを比べると、候補のボタンを 5 回とも出せたのは Claude Sonnet、MiniMax M2.5、DeepSeek。Qwen3 235B は 4 回(サーバでは 5 回)、gpt-oss-120b と Nova Pro は 0 回だった。
- 5 回とも出せたモデルにも、中国語が混じる、記号が本文に残る、などの別の崩れがあった。
- tool の引数を本文に JSON で書いてしまうモデルがある。それを tool の呼び出しに組み直す層を挟んだ。
使った技術
決済の流れの図
- Amazon Pay の流れ: 初回の登録と購入、ワンクリック、削除
- Stripe の流れ: 初回の購入とカードの保存、保存したカードで購入、削除
見る方法
招待制です。ご案内の窓口は、いま準備中です。買い手はデモ用の架空の人物で、決済はすべてテスト環境です。サーバの AI は月ごとの利用の枠の中で動かしていて、枠を使い切ると翌月まで会話できなくなります。主な場面は上の動画で、しくみは図と表で見られます。