小売の事前構築済みハンドブック

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

サンプル ダイアログ

次のサンプル ダイアログは、この事前構築済みプレイブックによって処理される一般的なシナリオを示しています。

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

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

ユーザー入力 エージェントの応答
hi
Google ショッピング アシスタントです。商品の検索や注文をお手伝いいたします。どのようなことでお困りですか？
どのようなスマートウォッチがありますか
Google Watch があります。カートに追加しますか？
はい、2 つ追加してください
大丈夫です。Google Watch を 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 ショッピング アシスタントです。商品の検索や注文をお手伝いいたします。どのようなことでお困りですか？
ホテルを予約したいです
申し訳ありません。この件についてはお手伝いできません。スマートフォン、スマートウォッチ、ヘッドフォンなどの商品の検索をお手伝いいたします。注文手続きをお手伝いすることもできます。どのようなことでお困りですか？

基本設定

この事前構築済み Playbook を設定するには:

  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 を使用して、ビルド済みエージェント内の各ツールを構成します。

    Agent Builder コンソール

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

      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. [保存] をクリックします。

Google Store API

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

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

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

注文する

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

完了

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