小売のハンドブックベースのビルド済みエージェントを使用すると、アイテムの検索、商品のおすすめの取得、注文を行えます。
会話の例
このサンプル ダイアログは、このビルド済みエージェントが処理する一般的なシナリオを示しています。
商品の検索とアイテムの購入
- ユーザーが店舗で入手可能なスマートウォッチについて質問します。
- エージェントがこれらの条件に合う商品をおすすめします。
- ユーザーが商品をカートに追加します。
- ユーザーがカートに別の商品を追加します。
- ユーザーがカートの内容について質問している。
- エージェントがカート内の商品をリストアップし、ユーザーが購入を希望していることを確認します。
- エージェントが注文を行い、確認番号を提供します。
- お客様がおすすめのスマートフォンを尋ねている。
- エージェントは、店舗で入手可能なスマートフォンを提案します。
- ユーザーが 1 つをカートに追加します。
- お客様がスマートフォンを注文し、確認番号を提示します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| こんにちは | |
| こんにちは。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 でショッピングをご利用いただきありがとうございます。どうぞよろしくお願い申し上げます。 |
商品が見つからない
ユーザーが、店舗で取り扱っていない商品について質問します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| こんにちは | |
| こんにちは。Google ショッピング アシスタントです。商品の検索や注文をお手伝いいたします。どのようなことでお困りですか？ | |
| 車を購入したいです | |
| 申し訳ございませんが、車の在庫はありません。他にお探しのものはありますか？ | |
| ええ、時計はありますか？ | |
| Google Watch があります。カートに追加しますか？ | |
| いいえ、結構です | |
| 他に何かご不明な点はございませんか？ | |
| いいえ | |
| 承知しました。Google でショッピングをご利用いただきありがとうございます。どうぞよろしくお願い申し上げます。 |
認識されない入力
- ユーザーが、商品や注文とは無関係のトピックについて問い合わせます。
- エージェントは、カバーするトピックを繰り返して応答し、ユーザーにどのようなサポートが必要かを尋ねます。
| ユーザー入力 | エージェントの応答 |
|---|---|
| こんにちは | |
| こんにちは。Google ショッピング アシスタントです。商品の検索や注文をお手伝いいたします。どのようなことでお困りですか？ | |
| ホテルを予約したいです | |
| 申し訳ありません。この件についてはお手伝いできません。スマートフォン、スマートウォッチ、ヘッドフォンなどの商品の検索をお手伝いいたします。注文のお手伝いもできます。どのようなことでお困りですか？ |
基本設定
このビルド済みエージェントを設定する手順は次のとおりです。
- ビルド済みエージェントをインポートします。
- 付属のツールを外部サービスで構成します。詳しくは、ツールの設定をご覧ください。
ツールの設定
このエージェントには、外部サービスと統合するためのツールが含まれています。ツール インストーラを使用して、ビルド済みエージェントのサンプルコードとデータをデプロイします。
小売のビルド済みエージェントのサンプルコードとデータをデプロイして構成するには、展開して手順を確認してください。
- ビルド済みツールのインストーラをローカル ディレクトリにダウンロードします。
- installer.zip をダウンロードしたローカル ディレクトリに移動します。
- installer.zip を解凍して、
installerフォルダを開きます。 - インストーラとその要件の詳細な概要については、README.md をご覧ください。
pip install -r requirements.txtを実行して要件をインストールします。-
gcloud auth application-default loginを実行し、gcloud auth を使用して認証します。 python installer.py --project-id=YOUR_GCP_PROJECT_ID --prebuilt-id=retailを使用してインストーラを実行します。-
必要なサービスをすべてデプロイしたら、インストーラによってログに記録された、指定された URL を使用して、ビルド済みエージェント内の各ツールを構成します。
Generative AI App Builder
- ビルド済みエージェントをまだインポートしていない場合は、エージェントをプロジェクトにインポートします。
- Generative AI App Builder に移動します。
- コンソールのプルダウンからプロジェクトを選択します。
- アプリを選択
- [Tools] のアイコンをクリックします。
- エージェントの各ツールについて、スキーマを編集して
servers:フィールドの URL をインストーラによってログに記録されたエンドポイントに置き換えます。 - [保存] をクリックします。
Dialogflow CX
- ビルド済みエージェントをまだインポートしていない場合は、エージェントをプロジェクトにインポートします。
- Dialogflow CX コンソールを開きます。
- ご自身の Google Cloud プロジェクトを選択します。
- エージェントを選択します。
- [Generative resources] のアイコンをクリックします。
- [ツール] をクリックします。
- エージェントの各ツールについて、スキーマを編集して
serversフィールドの URL をインストーラによってログに記録されたエンドポイントに置き換えます。 - [保存] をクリックします。
-
Compute Engine サービス アカウント（
your-project-number-developer.gserviceaccount.com）に Cloud Datastore ユーザーロールを付与して、新しくデプロイされた Cloud Run functions が Firestore にアクセスできるようにします。
Google Store API ツール
Google Store API ツールは、検索キーワードに基づいて Google ストアから商品を取得します。
ショッピング カート管理ツール
ショッピング カート管理ツールを使用すると、ユーザーはアイテムの表示、追加、削除により、ショッピング カートを管理できます。
注文ツール
Place Order ツールは、ユーザーの現在のショッピング カートの注文を行い、確認番号を返します。
完了
エージェントが設定され、テストの準備が整いました。