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

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 ショッピングアシスタントです。商品の検索や注文をお手伝いいたします。どのようなことでお困りですか？
ホテルを予約したいです
	申し訳ありません。この件についてはお手伝いできません。スマートフォン、スマートウォッチ、ヘッドフォンなどの商品の検索をお手伝いいたします。ご注文のお手伝いもいたします。どのようなことでお困りですか？

基本設定

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

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

ツールの設定

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

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

ビルド済みツールのインストーラをローカルディレクトリにダウンロードします。
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 を使用して、ビルド済みエージェント内の各ツールを構成します。
Vertex AI エージェント
1. ビルド済みエージェントをまだインポートしていない場合は、エージェントをプロジェクトにインポートします。
2. Agent Builder コンソールに移動します。
  Agent Builder コンソール
3. コンソールのプルダウンからプロジェクトを選択します。
4. アプリを選択
5. [Tools] のアイコンをクリックします。
6. エージェントの各ツールについて、スキーマを編集して servers: フィールドの URL をインストーラによってログに記録されたエンドポイントに置き換えます。
7. [保存] をクリックします。
Dialogflow CX
1. ビルド済みエージェントをまだインポートしていない場合は、エージェントをプロジェクトにインポートします。
2. Dialogflow CX Console を開きます。
3. ご自身の Google Cloud プロジェクトを選択します。
4. エージェントを選択します。
5. [Generative resources] のアイコンをクリックします。
6. [ツール] をクリックします。
7. エージェントの各ツールについて、スキーマを編集して servers フィールドの URL をインストーラによってログに記録されたエンドポイントに置き換えます。
8. [保存] をクリックします。

Google Store API

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

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

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

注文する

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

完了

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

自動車管理局

トラベル