AI / 招待制

agentic commerce

AI のバリスタと話して、コーヒーを選び、カートに入れ、払う店です。公開されている agentic commerce の参照実装に、日本語化、Amazon Pay と Stripe の決済、運営者の画面を足しました。

agent.naohiden.com を開く
主な場面(62 秒)。店のトップ、AI のバリスタに好みを話す、2 つを比べる、カートに入れる、会話の中で保存したカードで買う、運営者の画面で AI が値下げの案を承認待ちの下書きにする、の順です。AI の返事を待つ間は 4〜9 倍に早送りしています。手元の環境で撮り、AI は Claude(Claude Code 経由)、決済は Stripe のテスト環境です。買い手と店長は架空の人物です。
全体の構成図。お客様と運営者のブラウザから、店舗サイトと運営者ポータルを通って API サーバへ。API サーバの先に、買い物の agent と運営者の agent、デモの状態、商品カタログ、Amazon Pay を呼ぶ apay-node がある。2 つの agent は同じモデル(Claude Code、Anthropic API、Bedrock のどれか)を使う。決済は Stripe API と Amazon Pay API へ。
全体の構成。点線の枠の中が手元のマシンで動く部分です。図を押すと、拡大やテーマの切り替えができる版が開きます。構成図は、Claude Code がコードを読んで書き起こし、archify で生成しています。

本家の上に、何を足したか

元は、Anthropic が GitHub で公開している参照実装 commerce-agents(Apache-2.0)です。買い手の AI と運営者の AI、道具、店と運営者の画面までがそろっています。ただ、本家の説明のとおり、注文も課金もしません(checkout はカートを見せるところまで)。この作品は、その上に決済と日本の店を足したものです。

本家と、上に重ねた部分の関係 setup.sh が GitHub の本家を固定の版で取ってきて、apply-overlay.sh が自分で書いた部分を上から写す。本家のファイルは直接は直さない。重なりは 3 層で、いちばん下が本家のまま使う部分、真ん中が本家を写して直した 48 ファイル、いちばん上が新しく書いた部分(決済、購入の確定、取消と返金、日本の店、モデルの切り替え)。 overlay(自分で書いた部分) apply-overlay.sh が上から写す 上書きするだけで、消さない 本家のファイルは直接は直さない GitHub の本家 anthropics/commerce-agents 2026-08-31 の版(fd4d592)に固定 setup.sh 本家を取ってきて、固定の版にする 動くデモ(3 層の重なり) 新しく書いた部分 カード決済(Stripe) Amazon Pay 購入の確定(金額はサーバで決める) 取消と返金 注文の保存 日本のコーヒー店と円 日本語と英語の切り替え モデルの呼び先の切り替え(Anthropic API / Bedrock / Claude Code) 本家には無いもの。サーバの多くはこの層 本家を写して直した部分(48 ファイル) 店と運営者の画面の文言の日本語化、決済の手段を選ぶ所 記憶に「お客様が話した言語で書く」の規則を 1 つ足す 本家のまま使う部分 買い手と運営者の AI、道具の決まり、運営者の書き込みを人が承認する仕組み 記憶の抽出と保存、店と運営者の画面の土台
本家と自分の部分の重ね方。本家から写して直したファイルは一覧の表で管理していて、本家の版が変わると検査が落ちるようにしています。
足したもの中身本家では
カード決済Stripe の Payment Element で受け、サーバが金額を決めて PaymentIntent を作る。3D セキュアから戻ったあとの処理と、署名を確かめる Webhook。保存したカードで 2 回目からワンクリック決済の実装は無い
Amazon PayAmazon 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 には払う手段を渡していません。

1 回の会話の流れ 買い手のブラウザから API を通って買い物の agent へ。agent は役割ごとのモデルを呼び、道具で商品やカートを読み書きする。返事は少しずつブラウザに届く。返事のあと、別のモデルが記憶を残す。注文の要約のカードが会話に出て、買い手がボタンを押すと、ブラウザから Stripe か Amazon Pay へ直接つながる。 買い手のブラウザ 店の画面(Next.js) 返事は少しずつ届く API Python(FastAPI) カート、注文、記憶 買い物の agent 好み、カート、記憶を読んでから 道具を呼ぶ、結果を読む、を 1 回の返事で最大 8 回 モデル(役割ごと) 会話、記憶、運営者で分ける Claude か、Bedrock の ほかの会社のモデル 注文の要約のカード AI の checkout が出す 払うのは買い手の ボタン Stripe(テスト) カードは Stripe.js から Amazon Pay(sandbox) Amazon の画面で選ぶ 道具(21 種) 読む: 商品、カート、注文、記憶 出す: 商品、比較、候補のボタン 変える: カート、記憶 checkout: 要約を出すだけ 支払いと返金の道具は無い 記憶 返事のあと、別のモデルが 本人が言った好みだけ残す 返事に出る ブラウザから決済へ直接(AI は通らない)
AI が呼べるのは、商品やカートを読む道具、画面にカードを出す道具、カートと記憶を変える道具だけです。決済の URL も 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 CodeSonnetHaikuSonnet手元のデモ(自分だけで使う)
Anthropic APISonnet 5.5Haiku 4.5Sonnet 5.5招待制のサーバ(2026-11-16 から)
Bedrock(Claude)Claude無料プランのアカウントでは呼べなかった
Bedrock(ほかの会社)Qwen3 235Bgpt-oss-20bgpt-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 の呼び出しに組み直す層を挟んだ。

使った技術

  • Python(FastAPI)
  • Next.js
  • Anthropic API
  • Amazon Bedrock
  • Qwen3
  • gpt-oss
  • Stripe
  • Amazon Pay

決済の流れの図

見る方法

招待制です。ご案内の窓口は、いま準備中です。買い手はデモ用の架空の人物で、決済はすべてテスト環境です。サーバの AI は月ごとの利用の枠の中で動かしていて、枠を使い切ると翌月まで会話できなくなります。主な場面は上の動画で、しくみは図と表で見られます。