---
title: コマースエージェント
url: https://platform.claude.com/docs/ja/about-claude/use-case-guides/commerce-agents
description: Claude for commerceを使用して、Claude上でショッピングエージェントとマーチャントエージェントを構築します。Claude for commerceは、Messages API、Claude Agent SDK、Claude Managed Agents上で動作する実装を備えたオープンソースのブループリントです。
---
このガイドでは、Claude上でコマースエージェントを構築する方法を説明します。対象となるのは、顧客がアプリ内で使用する「shopping agent」（ショッピングエージェント）と、ストアを運営する人々のための「merchant agent」（マーチャントエージェント）です。ストアを運営する人々とは、ビジネス自身の運用スタッフの場合もあれば、プラットフォーム上の販売者の場合もあります。構築にはClaude for commerceを使用します。Claude for commerceはオープンソースの「blueprint」（ブループリント）で、次のものが含まれます。
* [Messages API](https://platform.claude.com/docs/ja/build-with-claude/working-with-messages)、[Claude Agent SDK](https://code.claude.com/docs/ja/agent-sdk/overview)、[Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)のそれぞれで動作する各エージェントの実装
* 小売、旅行、通信、エンターテインメント向けの実行可能なサンプル
* 同じ設計を独自のシステムに合わせてスキャフォールドするClaude Codeプラグイン
コード、セットアップ手順、安全性に関するドキュメントは、[GitHub上のClaude for commerceリポジトリ](https://github.com/anthropics/commerce-agents)にあります。エージェントの構築方法とその設計理由については、エンジニアリング記事[効果的なコマースエージェントの構造ガイド](https://claude.com/blog/the-anatomy-of-effective-commerce-agents)をお読みください。この記事では、スキルを備えた単一エージェント設計、ツールとしてのUIコンポーネント、ハーネスによって強制される安全性、「prompt caching」（プロンプトキャッシング）、メモリ、「evals」（評価）を取り上げています。
このブループリントは、フォークして適応させるためのリファレンス実装です。サポート対象の製品やホスト型サービスではありません。
## ショッピングエージェント
ショッピングエージェントはアプリ内で動作し、単一のバックエンドインターフェースを通じてシステムにアクセスします。このインターフェースは、カタログ、カート、設定、注文、ポリシー、フルフィルメントの各サービスの上に実装します。このインターフェースには、注文を確定したり資金を移動したりするメソッドはありません。会話の中で、エージェントは次のことができます。
* カタログを検索し、最終候補を比較して、説明されたニーズを候補リストと推奨事項にまとめる。
* 旅行、イベント、部屋などの目標に向けて、組み合わせたアイテムのセットを計画し、予算に合わせる。
* 商品、比較、プラン、注文状況、カートを、会話内にレンダリングされるUIコンポーネントとして表示する。
* カートに商品を入れ、チェックアウトに引き継ぐ。
* 独自の注文システムとポリシーシステムに基づいて、注文、配送、返品、ポリシーに関する質問に回答する。
* 顧客から記憶するよう求められた内容を記憶し、以降のセッションで活用する。
5つのスキルが必要に応じて読み込まれます。対象は、検索と発見、購入前のリサーチ、目標に向けた計画、カスタマーケア、メモリとパーソナライゼーションです。一方、ほとんどのターンでエージェントが必要とするルールは、システムプロンプトに記述します。たとえば、グラウンディング、カートとチェックアウトのセマンティクス、表示方法などです。
エージェントが商品、価格、在庫状況、ストアの規約を伝える際は、会話内のツール結果のみを根拠とします。また、カートへの書き込みでは、そのセッションでカタログツールまたは注文ツールが返した商品IDのみが受け付けられます。チェックアウトでは概要が用意され、顧客がアプリ内でそれを確認します。ホスト型チェックアウトを使用する場合は、バックエンドがそのURLを返し、ホストがモデルを経由せずにそれをレンダリングします。
## マーチャントエージェント
マーチャントエージェントは、ストアを運営する人々を支援します。独自のバックエンドインターフェースを通じて、分析、カタログ、在庫、価格設定、キャンペーンの各システムにアクセスし、次のことができます。
* ビジネスの状況を説明する。たとえば、指標が変動した理由、その変動をもたらしたセグメント、比較対象期間に対する進捗などです。オプションの分析デリゲートを使用すると、時間とサイズの予算内で読み取り専用クエリを実行できます。
* 対応が必要な事項をまとめた日次ダイジェストを提示する。在庫不足、売れ行きの悪い商品、注文の例外などが含まれます。
* オペレーターが提供した資料をもとに、出品コンテンツを改善し、カタログデータを修正する。
* ストアの「guardrails」（ガードレール）の範囲内で、利益率のプレビューとともに価格変更やプロモーションを推奨する。
* オーディエンス、掲載枠、予算を含むマーケティングキャンペーンの下書きを作成する。
5つのスキルは、パフォーマンスインサイト、在庫と運用、カタログと出品、価格設定とプロモーション、マーケティングキャンペーンを対象としています。
マーチャントエージェントが提案する書き込みは、すべてステージングされた変更として扱われます。対象は、出品の更新、価格変更、在庫アクション、プロモーション、キャンペーンのいずれでも同じです。各変更にはサーバーが生成したIDが付与され、オペレーターにはプレビューカードとして表示されます。ガードレールは、変更のステージング時と適用時の両方でチェックされます。ガードレールには、価格変動の上限、プロモーションの割引幅、補充数量、キャンペーン予算、保護されたフィールドなどがあります。
変更が適用されるのは、人が会話の外で承認した後だけです。承認の方法はパスによって異なります。
* Messages APIパス：マーチャントポータルのボタン
* Agent SDK：コンソールの確認プロンプト
* Claude Managed Agents：適用ツールに設定した[常に確認する権限ポリシー](https://platform.claude.com/docs/ja/managed-agents/permission-policies)
チャットで入力された承認では、何も承認されません。
## 業種別のサンプル
各サンプルには、架空のデータを使用した顧客向けストアフロントとマーチャントポータルが含まれています。
| 業種 | ストアフロント | マーチャントポータル |
| ---------- | ----------------------------------------- | --------------------------------------------- |
| 小売 | 組み込みコンポーネントを使用した検索、比較、プラン、カート、チェックアウト、メモリ | 日次ダイジェスト、ステージングされた在庫補充と出品修正、SQLビューに対する分析デリゲート |
| 旅行 | 日付に紐づく在庫と旅程コンポーネント | 稼働率カレンダーと期間指定の料金変更 |
| 通信 | アカウントコンテキスト、プランマトリックス、サーバー側で作成される手数料の開示 | プラン構成、影響を受ける回線数を明示する価格変更、保護された規制対象の手数料 |
| エンターテインメント | 時間制限付きの仮押さえ、キャンセル待ち、譲渡、会場マップ、手数料込みの総額表示 | イベントの販売ペース、実際の販売枠を増やす仮押さえの解放、手数料を維持する価格変更 |
## 実行環境
Messages APIとAgent SDKのランタイムは、次のいずれかで実行できます。
* Claude API
* [Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)
* [Google Cloud's Agent Platform](https://platform.claude.com/docs/ja/build-with-claude/claude-on-vertex-ai)
* [Microsoft Foundry](https://platform.claude.com/docs/ja/build-with-claude/claude-in-microsoft-foundry)
* 独自のゲートウェイ
Claude Managed AgentsのパスはClaude API上で実行されます。リポジトリのデプロイガイドでは、各パスでプラットフォームを選択する箇所と、各パスが想定するモデルIDの形式を説明しています。
## Claude Codeプラグインで独自のエージェントを構築する
ブループリントには[Claude Code](https://code.claude.com/docs/ja/overview)プラグインが付属しています。このプラグインは、クローンしたリポジトリをリファレンスとして読み込み、独自のシステムに合わせてエージェントを構築します。4つのコマンドで、ゼロからテスト済みのエージェントまでの工程をカバーします。
| コマンド | 機能 |
| -------------------------- | ---------------------------------------------------------------------------------------- |
| `/scaffold-commerce-agent` | スタックについてヒアリングし、計画を提示して確認したうえで、リファレンスパッケージ上にショッピングエージェント、マーチャントエージェント、またはその両方をスキャフォールドします |
| `/add-commerce-flow` | 既存のエージェントにフローを1つ追加します。そのフローのスキルをコピーし、呼び出すツールを接続して、最初の評価ケースを作成します |
| `/author-commerce-evals` | 評価スイートを構築します。ランナー、独自のカタログに対する最初のケース、CI用のリプレイゲートが含まれます |
| `/review-commerce-agent` | すでに運用しているエージェントの構成を把握してリファレンスと比較し、選択した部分を変換します |
プラグインには6つのスキルも含まれています。対象は、アーキテクチャ、プロンプトキャッシング、ツールとしてのUI、信頼と安全性、評価、マーチャント運用です。これらのスキルは、Claude Codeの会話の内容が一致したときに読み込まれます。インストール手順はリポジトリのREADMEに記載されています。
プラグインを使わずに手動でリファレンスを適応させる場合は、次の手順を実行します。
1. サービスの上にショッピングまたはマーチャントのバックエンドインターフェースを実装します。
2. 構成フラグを使用して、存在しないシステムを無効にします。これにより、該当するツールとプロンプトの行が除外されます。
3. ブランド名、アシスタント名、話し方を設定します。
リポジトリのバックエンドガイドでは、ID と認証情報、順序付きフロー、チェックアウトへの引き継ぎ、オプション付き商品について順を追って説明しています。パイロットでは、検索と商品詳細のみを実装し、残りはスタブにしてもかまいません。
## はじめに
ブループリントをクローンし、両方のエージェントをローカルで実行します。
エージェントの構築方法とその設計理由をお読みください。