Vertex AI Search for Retail を使用したショッピング アシスタントの事前構築済みエージェント

ショッピング アシスタント ハンドブック ベースのビルド済みエージェント は、小売商品のクエリ、注文、注文ステータス、注文のキャンセルを提供します。 Vertex AI Search for Retail と カスタム フルフィルメント ペイロードを使用し、 豊富なビジュアル エクスペリエンスを提供します。

サンプル ダイアログ

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

商品とレビューの比較

お客様が伝統的なサリーの閲覧をリクエストします。 エージェントが人気のあるオプションをいくつか提示し、お客様が最初のオプションを選択します。 お客様が合う靴をリクエストします。 エージェントが人気のあるオプションを提示し、お客様がレビューの比較をリクエストして、評価の高いオプションを選択します。 エージェントがサイズについて尋ね、靴がカートに追加されたことを確認します。

ユーザー入力 エージェントの応答
伝統的なサリーを見せて
[商品を表示] これらの商品にご興味はございますか？それとも別のオプションをご希望ですか？
1 つ目がいいですね
ドメインのご購入ありがとうございます。Indian beauty Self Design, Printed Fashion Georgette Sari は美しい一品です。サリーは通常ワンサイズなので、ぴったりフィットします。カートに追加しますか？
それに合うヒールはありますか？
[商品を表示] これらの商品にご興味はございますか？それとも別のオプションをご希望ですか？
はい。お客様のレビューを確認して、この中から最適なものを選んでいただけますか？
Flat n Heels Women Heels の平均評価は 5 つ星中 4 つ星で、Glitzy Galz Women Heels の平均評価は 5 つ星中 4.5 つ星です。Flat n Heels Women Heels を購入したお客様のレビューはまちまちで、最初は快適だったものの数時間後には不快になったという方もいれば、快適さを称賛する方もいました。一方、Glitzy Galz Women Heels は、フィット感、品質、デザインを称賛するお客様が多く、ほとんどが好意的なレビューでした。どちらをカートに追加しますか？
レビューと評価が最も高いもの
Glitzy Galz Women Heels の評価は 5 つ星中 4.5 つ星で、最も高い評価です。Glitzy Galz Women Heels のサイズは何にされますか？5 ～ 11 のサイズをご用意しています。
6
よし、完璧！Glitzy Galz Women Heels のサイズ 6 がカートに 1 個追加されました。他にカートに追加したいものはありますか？

エンドツーエンドのショッピング エクスペリエンス

お客様が商品カタログを閲覧します。エージェントがお客様のリクエストに基づいておすすめの商品を提示します。数回検索した後、お客様が購入する商品を見つけます。エージェントが購入する商品のサイズと数量、配送予定日を確認します。お客様が別の配送日をリクエストしますが、その日はご利用いただけないため、元の配送日に同意します。エージェントが登録されている配送先、お支払い情報、連絡先情報を確認します。お客様が配送情報を更新して確認します。エージェントが注文を確定し、注文番号をお客様に伝えます。

ユーザー入力 エージェントの応答
寒くなってきました。良いセーターはありますか？
[商品を表示]。これらの商品にご興味はございますか？それとも別のオプションをご希望ですか？
妻にレディース セーターを買いたいのですが、ボーイズ セーターを探しています
[商品を表示]。これらの商品にご興味はございますか？それとも別のオプションをご希望ですか？
最初のレディース セーターをカートに追加して
Nineteen Solid Round Neck Casual Women's Sweater のサイズは何にされますか？特小から特大までのサイズをご用意しています。
メディア
よし、完璧！Nineteen Solid Round Neck Casual Women's Sweater のサイズ中がカートに 1 個追加されました。他にカートに追加したいものはありますか？
いいえ
Nineteen Solid Round Neck Casual Women's Sweater は、2024 年 4 月 29 日までにお届けできます。いかがでしょうか。
4 月 28 日に配達してもらえますか？
申し訳ございませんが、Nineteen Solid Round Neck Casual Women's Sweater は 2024 年 4 月 28 日にお届けできません。最短で 2024 年 4 月 29 日にお届けできます。
わかりました。お届け日はそのままでお願いします
承知いたしました。Nineteen Solid Round Neck Casual Women's Sweater は 2024 年 4 月 29 日にお届けいたします。では、プロフィールの詳細を確認して、すべて最新の情報であることをご確認ください。
配送先住所: 638 Maple Street, Apt 11, Cupertino, CA 95014
お支払い情報: Visa（末尾 4111）
連絡先番号: 416-555-5555
メール: email@example.com
詳細をご確認ください。すべて正しい場合は、確認してください。変更が必要な場合はお知らせください。
住所が 371 Talbot Street Carmichael, CA 95608 に変更されました
お届け先住所が 371 Talbot Street, Carmichael, CA 95608 に更新されました。他に修正したい項目はありますか？
いいえ
Nineteen Solid Round Neck Casual Women's Sweater のご注文が確定しました。注文 ID は ee6b4cc7 です。2024 年 4 月 29 日にお届け予定です。
ありがとうございます
ご注文を処理しました。他に何かお役に立てることはございませんか？
いいえ、結構です
お役に立てて幸いです。Cymbal Apparel の商品が必要な場合は、クリックするだけでご利用いただけます。

注文ステータスの確認

お客様が注文ステータスの確認をリクエストします。エージェントが注文番号を収集し、注文情報を取得します。エージェントが注文の商品、現在のステータス、配送予定日について詳しく説明します。

ユーザー入力 エージェントの応答
こんにちは
上記のオプションから選択するか、探しているものを入力してください。サポートいたします。
注文ステータスを確認したい
承知いたしました。まず、ご注文 ID を教えていただけますか？
ee6b4cc7
ご注文を確認しました。現在処理中です。
ご注文内容は次のとおりです。
Nineteen Solid Round Neck Casual Women's Sweater
サイズ: 中
数量: 1
配送予定日: 2024 年 4 月 29 日
他に何かお役に立てることはございませんか？
いいえ、結構です
お役に立てて幸いです。Cymbal Apparel の商品が必要な場合は、クリックするだけでご利用いただけます。

注文した商品の返品

お客様が注文した商品を返品したいと考えています。エージェントが注文番号を収集し、注文の詳細を取得して、返品する商品を確認します。次に、エージェントが返品手続きを開始し、お客様が印刷して荷物に貼り付けるための返品ラベルを提供します。

ユーザー入力 エージェントの応答
こんにちは
上記のオプションから選択するか、探しているものを入力してください。サポートいたします。
注文した商品を返品したい
返品のお手伝いをさせていただきます。まず、ご注文番号をお知らせいただけますか？
0fc77d64
ご注文番号をお知らせいただきありがとうございます。2024 年 4 月 12 日のご注文が見つかりました。ご注文内容は、YK Printed Boy's Round Neck Dark Blue T-Shirt の S サイズです。返品をご希望の商品はこちらでよろしいでしょうか？
はい
承知いたしました。返品手続きを開始しました。返品ラベルは以下に添付されています。印刷して荷物に貼り付けてから返送してください。他に何かお役に立てることはございませんか？
いいえ、結構です
お役に立てて幸いです。Cymbal Apparel の商品が必要な場合は、クリックするだけでご利用いただけます。

基本設定

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

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

ツールの設定

このエージェントには、外部サービスとの統合に使用されるツールが含まれています 。これらのツールを構成するには、次の手順を行います。

  1. Firestore データベース という名前の apparel-db を作成します。
  2. Firestore Integration コネクタを作成します 。
  3. ショッピング アシスタント用の Application Integration を ダウンロードします。
  4. projects/customermod-genai-sa/locations/us-central1/connections/firestore へのすべての参照を、ステップ 2 で作成したコネクタの識別子に置き換えます。
  5. 統合 を アップロードして公開します 。
  6. Dialogflow サービス エージェントに Cloud Functions Invoker ロールを付与します。
  7. 手順に沿って Retail カタログを設定します
  8. 属性コントロール を更新して、ageGroups、availability、 categories、colorFamilies、colors、conditions、cost、currencyCode、 description、discount、images、materials、patterns、price、sizes、title、uri の各フィールドを取得できるようにします。
  9. インポート サンプル カタログ をカタログのブランチ 1 にインポートし、デフォルトのブランチにします。
  10. こちら から Cloud Run 関数をダウンロードし、config.toml を更新します。
  11. 手順に沿って Cloud Run 関数をデプロイします。
  12. デプロイした Cloud Run 関数に Retail Viewer IAM ロールを付与します。
  13. 次のツール（get-order-status、order-lookup、place-order 、return-order）で、OpenAPI 仕様のステップ 5 で作成した統合を参照するように paths プロパティを更新し、Application Integration Invoker ロールを付与するサービス アカウントで サービス アカウント認証 を選択します。
  14. 残りのツールについて、サーバー URL プロパティをデプロイした Cloud Run 関数に更新します。

search-products ツールは、検索クエリと商品カタログのオフセット値に基づいて、最も一致する商品を取得します。このツールは、商品の詳細を含むカスタム ペイロード レスポンスを返します。 このカスタム ペイロードは、UI で商品をリッチコンテンツ形式で表示するために使用されます。

プロダクトの詳細

get-product-details ツールは、Retail API を使用して商品カタログから商品の詳細を取得します。取得した商品の詳細は変換され、簡略化された形式で返されます。この形式は、エージェントがユーザーに表示した商品に関する質問に回答するために使用されます。

商品レビュー

get-reviews ツールは、商品のレビューを取得するために使用されます。表示された商品のリストを受け取り、各商品のレビューを取得します。 生成されたレビューは、リッチ ユーザー インターフェースでの表示に適したカスタム テンプレート（review_template）形式に変換されます。

類似の商品

similar-products ツールを使用すると、Retail Recommendation API を使用して、指定した商品に類似した商品を簡単に見つけることができます。商品 ID を受け取り、Retail Recommendation API を使用して、商品カタログから類似商品を予測します。

配信日

store-delivery-date ツールは、ショッピング カート内の商品について、お客様が希望するお届け日を保存します。この日付は、最短の配送予定日と比較されます。

get-delivery-date ツールは、ショッピング カート内の商品のお届け日を推定します。

ユーザーの詳細

get-user-info ツールは、配送先住所、お支払い情報、電話番号、メールアドレスなど、お客様の個人情報を取得します。一方、update-user-info ツールは、お客様の情報を更新します。

注文管理

place-order ツールは、ショッピング カート内の商品の注文処理を行います。注文 ID、ステータス、作成タイムスタンプ、商品のリストなどの注文データとともに、注文を Firestore に保存します。 注文番号をエージェントに返します。

order-lookup ツールは、指定された注文 ID に基づいて Firestore データベースから注文データを取得します。

return-order ツールは、Firestore データベースで注文のステータスを「return_pending」に更新します。これは、お客様から返品が開始され、注文が返品待ちであることを示します。

get-order-status ツールは、注文のステータスを取得します。注文が発送済みの場合は、DHL API を使用して追跡します。注文のステータスに基づいて適切なメッセージを提供します。

完了

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

前へ
小売
次へ
旅行