Retail のビルド済みエージェント

小売のハンドブック ベースのビルド済みエージェントを使用すると、ユーザーはアイテムの検索、商品のおすすめの取得、注文を行えます。

サンプル ダイアログ

次のサンプル ダイアログは、このビルド済みエージェントによって処理される一般的なシナリオを示しています。

商品の検索とアイテムの購入

ユーザーが店舗で入手可能なスマートウォッチについて質問します。エージェントがこの条件に合う商品をおすすめし、ユーザーがその商品をショッピング カートに追加します。ユーザーが注文を確認すると、エージェントは確認番号で注文を確定します。次に、ユーザーがスマートフォンのおすすめをリクエストすると、エージェントがスマートフォンを提案し、それをユーザーのカートに追加して、注文します。

ユーザー入力 エージェントの応答
hi
こんにちは、Google ショッピング アシスタントです。商品の検索や注文をお手伝いいたします。どのようなことでお困りですか？
どのようなスマートウォッチがありますか
Google Watch があります。カートに追加しますか？
はい、2 つ追加してください
大丈夫です。Google スマートウォッチを 2 つカートに追加しました。その他にありますか？
Google Pixel 8 も 1 つカートに追加できますか？
大丈夫です。Google Pixel 8 を 1 つカートに追加しました。その他にありますか？
カートには何が入っていますか？
カートに Google Pixel 8 が 1 つと Google Watch が 2 つあります。購入手続きを行いますか？
はい、お願いします
承知しました。Google Pixel 8 を 1 つと Google Watch を 2 つ注文しました。確認番号は QKA67DW2 です。
他に何かご不明な点はございませんか？
そうですね、新しいスマートフォンを探すのを手伝っていただけますか？
Google Pixel 8 と Google Pixel 7 があります。どちらか購入をご希望ですか？
はい、Google Pixel 8 をください
大丈夫です。Google スマートフォン Pixel 8 を 1 つカートに追加しました。その他にありますか？
結構です。決済してください
カートに Google Pixel 8 が 1 つ入っています。このカートを使用して購入手続きを行いますか？
はい
わかりました。注文を行いました。ご注文は Google Pixel 8 が 1 つです。確認番号は Y43KTF0T です。
他に何かご不明な点はございませんか？
他にはありません。ありがとうございました
承知しました。Google でショッピングをご利用いただきありがとうございます。どうぞよろしくお願い申し上げます。

カートの管理

ユーザーがカートに商品を追加するよう依頼し、注文する前に商品を削除します。

ユーザー入力 エージェントの応答
こんにちは。スマートフォンを購入したいです
Google Pixel 8 と Google Pixel 7 があります。どちらの購入をご希望ですか？
Pixel 8 を 2 つください
大丈夫です。Google スマートフォン Pixel 8 を 2 つカートに追加しました。その他にありますか？
そうですね。1 つ削除できますか？
カートから Google Pixel 8 を 1 つ削除しました。その他にありますか？
注文しても構いません
承知しました。Google Pixel 8 を 1 つ注文しました。確認番号は X0KP6K5T です。
他に何かご不明な点はございませんか？
いいえ、結構です
承知しました。Google でショッピングをご利用いただきありがとうございます。どうぞよろしくお願い申し上げます。

商品が見つからない

ユーザーが、店舗で取り扱っていない商品について質問します。

ユーザー入力 エージェントの応答
hi
こんにちは、Google ショッピング アシスタントです。商品の検索や注文をお手伝いいたします。どのようなことでお困りですか？
車を購入したいです
申し訳ございませんが、車の在庫はありません。他にお探しのものはありますか？
ええ、時計はありますか？
Google Watch があります。カートに追加しますか？
いいえ、結構です
他に何かご不明な点はございませんか？
いいえ
承知しました。Google でショッピングをご利用いただきありがとうございます。どうぞよろしくお願い申し上げます。

認識されない入力

ユーザーが、商品や注文とは無関係のトピックについて問い合わせます。エージェントは、エージェントがカバーするトピックを繰り返して応答し、ユーザーにどのようなサポートが必要かを尋ねます。

ユーザー入力 エージェントの応答
hi
こんにちは、Google ショッピング アシスタントです。商品の検索や注文をお手伝いいたします。どのようなことでお困りですか？
ホテルを予約したいです
申し訳ありません。この件についてはお手伝いできません。スマートフォン、スマートウォッチ、ヘッドフォンなどの商品の検索をお手伝いいたします。注文のお手伝いもできます。どのようなことでお困りですか？

基本設定

このビルド済みエージェントを設定するには:

  1. ビルド済みエージェントをインポートします。
  2. 付属のツールを外部サービスで構成します。ツールの設定をご覧ください。

ツールの設定

このエージェントには、外部サービスとの統合に使用されるツールが含まれています。ビルド済みツールのインストーラを使用して、ビルド済みエージェントのサンプルコードとデータをデプロイできます。

小売のビルド済みエージェントのサンプルコードとデータをデプロイして構成するには、展開して手順を確認してください。

  1. ビルド済みツールのインストーラをローカル ディレクトリにダウンロードします。
  2. installer.zip をダウンロードしたローカル ディレクトリに移動します。
  3. installer.zip を解凍して、installer フォルダを開きます。
  4. インストーラとその要件の詳細な概要については、README.md をご覧ください。
  5. pip install -r requirements.txt を実行して要件をインストールします。
  6. gcloud auth application-default login を実行し、gcloud auth を使用して認証します。
  7. python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=retail を使用してインストーラを実行します。
  8. 必要なサービスをすべてデプロイしたら、インストーラによってログに記録された、指定された URL を使用して、ビルド済みエージェント内の各ツールを構成します。

    Vertex AI Agent Builder コンソール

    1. ビルド済みエージェントをまだインポートしていない場合は、エージェントをプロジェクトにインポートします。
    2. Vertex AI Agent Builder コンソールに移動します。

      Vertex AI Agent Builder コンソール

    3. コンソールのプルダウンからプロジェクトを選択します。
    4. アプリを選択
    5. [Tools] のアイコンをクリックします。
    6. エージェントの各ツールについて、スキーマを編集して servers: フィールドの URL をインストーラによってログに記録されたエンドポイントに置き換えます。
    7. [保存] をクリックします。

    Dialogflow CX

    1. ビルド済みエージェントをまだインポートしていない場合は、エージェントをプロジェクトにインポートします。
    2. Dialogflow CX コンソールを開きます。
    3. ご自身の Google Cloud プロジェクトを選択します。
    4. エージェントを選択します。
    5. [Generative resources] のアイコンをクリックします。
    6. [ツール] をクリックします。
    7. エージェントの各ツールについて、スキーマを編集して servers フィールドの URL をインストーラによってログに記録されたエンドポイントに置き換えます。
    8. [保存] をクリックします。
  9. Compute Engine サービス アカウント（your-project-number-developer.gserviceaccount.com）に Cloud Datastore ユーザーのロールを付与して、新しくデプロイされた Cloud Run functions が Firestore にアクセスできるようにします。

Google Store API

Google Store API ツールは、検索キーワードに基づいて Google ストアから商品を取得するために使用されます。

ショッピング カートを管理する

Manage Shopping Cart ツールを使用すると、カート内のすべてのアイテムを表示、カートへのアイテムを追加、カートからアイテムを削除することにより、ユーザーはショッピング カートを管理できます。

注文する

Place Order ツールは、ユーザーの現在のショッピング カートで注文を行い、注文の確認番号を返すために使用されます。

完了

これで、エージェントとその統合が設定され、テストの準備が整いました。

前へ
映画のエキスパート
次へ
ショッピング アシスタント