ベストプラクティスユースケース

コマースエージェント

Copy page



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、Claude Agent SDK、Claude Managed Agentsのそれぞれで動作する各エージェントの実装
• 小売、旅行、通信、エンターテインメント向けの実行可能なサンプル
• 同じ設計を独自のシステムに合わせてスキャフォールドするClaude Codeプラグイン

コード、セットアップ手順、安全性に関するドキュメントは、GitHub上のClaude for commerceリポジトリにあります。エージェントの構築方法とその設計理由については、エンジニアリング記事効果的なコマースエージェントの構造ガイドをお読みください。この記事では、スキルを備えた単一エージェント設計、ツールとしてのUIコンポーネント、ハーネスによって強制される安全性、「prompt caching」（プロンプトキャッシング）、メモリ、「evals」（評価）を取り上げています。

ショッピングエージェント

ショッピングエージェントはアプリ内で動作し、単一のバックエンドインターフェースを通じてシステムにアクセスします。このインターフェースは、カタログ、カート、設定、注文、ポリシー、フルフィルメントの各サービスの上に実装します。このインターフェースには、注文を確定したり資金を移動したりするメソッドはありません。会話の中で、エージェントは次のことができます。

• カタログを検索し、最終候補を比較して、説明されたニーズを候補リストと推奨事項にまとめる。
• 旅行、イベント、部屋などの目標に向けて、組み合わせたアイテムのセットを計画し、予算に合わせる。
• 商品、比較、プラン、注文状況、カートを、会話内にレンダリングされるUIコンポーネントとして表示する。
• カートに商品を入れ、チェックアウトに引き継ぐ。
• 独自の注文システムとポリシーシステムに基づいて、注文、配送、返品、ポリシーに関する質問に回答する。
• 顧客から記憶するよう求められた内容を記憶し、以降のセッションで活用する。

5つのスキルが必要に応じて読み込まれます。対象は、検索と発見、購入前のリサーチ、目標に向けた計画、カスタマーケア、メモリとパーソナライゼーションです。一方、ほとんどのターンでエージェントが必要とするルールは、システムプロンプトに記述します。たとえば、グラウンディング、カートとチェックアウトのセマンティクス、表示方法などです。

エージェントが商品、価格、在庫状況、ストアの規約を伝える際は、会話内のツール結果のみを根拠とします。また、カートへの書き込みでは、そのセッションでカタログツールまたは注文ツールが返した商品IDのみが受け付けられます。チェックアウトでは概要が用意され、顧客がアプリ内でそれを確認します。ホスト型チェックアウトを使用する場合は、バックエンドがそのURLを返し、ホストがモデルを経由せずにそれをレンダリングします。

マーチャントエージェント

マーチャントエージェントは、ストアを運営する人々を支援します。独自のバックエンドインターフェースを通じて、分析、カタログ、在庫、価格設定、キャンペーンの各システムにアクセスし、次のことができます。

• ビジネスの状況を説明する。たとえば、指標が変動した理由、その変動をもたらしたセグメント、比較対象期間に対する進捗などです。オプションの分析デリゲートを使用すると、時間とサイズの予算内で読み取り専用クエリを実行できます。
• 対応が必要な事項をまとめた日次ダイジェストを提示する。在庫不足、売れ行きの悪い商品、注文の例外などが含まれます。
• オペレーターが提供した資料をもとに、出品コンテンツを改善し、カタログデータを修正する。
• ストアの「guardrails」（ガードレール）の範囲内で、利益率のプレビューとともに価格変更やプロモーションを推奨する。
• オーディエンス、掲載枠、予算を含むマーケティングキャンペーンの下書きを作成する。

5つのスキルは、パフォーマンスインサイト、在庫と運用、カタログと出品、価格設定とプロモーション、マーケティングキャンペーンを対象としています。

マーチャントエージェントが提案する書き込みは、すべてステージングされた変更として扱われます。対象は、出品の更新、価格変更、在庫アクション、プロモーション、キャンペーンのいずれでも同じです。各変更にはサーバーが生成したIDが付与され、オペレーターにはプレビューカードとして表示されます。ガードレールは、変更のステージング時と適用時の両方でチェックされます。ガードレールには、価格変動の上限、プロモーションの割引幅、補充数量、キャンペーン予算、保護されたフィールドなどがあります。

変更が適用されるのは、人が会話の外で承認した後だけです。承認の方法はパスによって異なります。

• Messages APIパス：マーチャントポータルのボタン
• Agent SDK：コンソールの確認プロンプト
• Claude Managed Agents：適用ツールに設定した常に確認する権限ポリシー

チャットで入力された承認では、何も承認されません。

業種別のサンプル

各サンプルには、架空のデータを使用した顧客向けストアフロントとマーチャントポータルが含まれています。

実行環境

Messages APIとAgent SDKのランタイムは、次のいずれかで実行できます。

• Claude API
• Amazon Bedrock
• Google Cloud's Agent Platform
• Microsoft Foundry
• 独自のゲートウェイ

Claude Managed AgentsのパスはClaude API上で実行されます。リポジトリのデプロイガイドでは、各パスでプラットフォームを選択する箇所と、各パスが想定するモデルIDの形式を説明しています。

Claude Codeプラグインで独自のエージェントを構築する

ブループリントにはClaude Codeプラグインが付属しています。このプラグインは、クローンしたリポジトリをリファレンスとして読み込み、独自のシステムに合わせてエージェントを構築します。4つのコマンドで、ゼロからテスト済みのエージェントまでの工程をカバーします。

プラグインには6つのスキルも含まれています。対象は、アーキテクチャ、プロンプトキャッシング、ツールとしてのUI、信頼と安全性、評価、マーチャント運用です。これらのスキルは、Claude Codeの会話の内容が一致したときに読み込まれます。インストール手順はリポジトリのREADMEに記載されています。

プラグインを使わずに手動でリファレンスを適応させる場合は、次の手順を実行します。

1. サービスの上にショッピングまたはマーチャントのバックエンドインターフェースを実装します。
2. 構成フラグを使用して、存在しないシステムを無効にします。これにより、該当するツールとプロンプトの行が除外されます。
3. ブランド名、アシスタント名、話し方を設定します。

リポジトリのバックエンドガイドでは、ID と認証情報、順序付きフロー、チェックアウトへの引き継ぎ、オプション付き商品について順を追って説明しています。パイロットでは、検索と商品詳細のみを実装し、残りはスタブにしてもかまいません。

はじめに