ショッピング アシスタントのハンドブックベースの事前構築済みエージェントは、小売商品のクエリ、注文、注文ステータス、注文のキャンセルに対応します。Vertex AI Search for Retail とカスタム フルフィルメント ペイロードを使用して、豊富なビジュアル エクスペリエンスを提供します。
サンプル ダイアログ
次のサンプル ダイアログは、このビルド済みエージェントによって処理される一般的なシナリオを示しています。
商品とレビューの比較
お客様が伝統的なサリーを閲覧したいと尋ねている。エージェントがいくつかの一般的なオプションを提示し、ユーザーが最初のオプションを選択します。お客様が、靴の合わせ方について質問している。エージェントが人気のオプションを提示し、お客様がレビューの比較をリクエストして、評価の高いオプションを選択します。エージェントはサイズについて尋ね、靴がカートに追加されたことを確認します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 伝統的なサリーを表示 | |
| [商品を表示] これらの商品のどれかにご興味をお持ちですか？それとも、別の商品をお探しですか？ | |
| 1 つ目は問題ありません | |
| ドメインのご購入ありがとうございます。インドの美しいセルフデザイン、プリント ファッション ジョーゼット サリーは美しい作品です。サリーは通常 1 サイズなので、ぴったりフィットします。カートに追加しますか？ | |
| それに合うヒールはありますか？ | |
| [商品を表示] これらの商品のどれかにご興味をお持ちですか？それとも、別の商品をお探しですか？ | |
| はい。お客様のクチコミをご覧いただき、その中から最適なものをお選びいただけますか？ | |
| Flat n Heels の女性用ヒールの平均評価は 5 つ星中 4 つ星ですが、Glitzy Galz の女性用ヒールの平均評価は 5 つ星中 4.5 つ星です。Flat n Heels の女性用ヒールを購入したお客様のレビューは賛否両論で、最初は快適だったが数時間後に不快になったという意見や、快適だと評価する意見などがあります。一方、Glitzy Galz Women Heels は、フィット感、品質、デザインについて好意的なレビューがほとんどでした。どちらをカートに追加しますか？ | |
| レビューと評価が最も高い | |
| Glitzy Galz Women Heels は、5 つ星中 4.5 つ星の最高評価です。Glitzy Galz の女性用ヒールのサイズを教えていただけますか？サイズは 5 ～ 11 です。 | |
| 6 | |
| ありがとうございます。Glitzy Galz の女性用ヒール（サイズ 6）が 1 個カートに追加されました。他にカートに追加したい商品はございますか？ |
エンドツーエンドのショッピング エクスペリエンス
ユーザーが商品カタログを閲覧します。エージェントは、ユーザーのリクエストに基づいておすすめを提示します。ユーザーがいくつか検索した後、購入する商品を見つけます。エージェントは、購入する商品のサイズと数量、配送予定日を確認します。お客様が別の配達日をリクエストしたが、その日付は指定できないため、元の配達日付に同意した場合。エージェントは、登録されている配送情報、お支払い情報、連絡先情報を確認します。お客様が配送情報を更新して確認します。エージェントが注文を行い、注文番号をユーザーに伝えます。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 寒くなってきました。良いセーターはありますか | |
| [商品を紹介します]。これらの商品のどれかにご興味がありますか？それとも、別のオプションをお探しですか？ | |
| 妻用にレディース セーターは気に入りましたが、男の子用のセーターを探しています | |
| [商品を紹介します]。これらの商品のどれかにご興味をお持ちですか？それとも、別のオプションをお探しですか？ | |
| 最初のレディース セーターのカートに追加する | |
| Nineteen ソリッド ラウンドネック カジュアル ウィメンズ セーターは、どのサイズをご希望ですか？サイズは、超小から超大までご用意しています。 | |
| 中 | |
| ありがとうございます。サイズ M の 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\ | |
| お支払い情報: 末尾が 4111 の Visa 連絡先電話番号: 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 で何かご不明な点がございましたら、お気軽にお問い合わせください。\ |
注文のステータスの確認
お客様から注文のステータスを確認するようリクエストがありました。エージェントは注文番号を収集し、注文情報を取得します。エージェントは、注文商品の詳細、現在のステータス、配送予定日をお客様に伝えます。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 「Hi」 | |
| 上記のオプションから選択するか、ご希望の項目を入力してください。 | |
| 注文のステータスを確認したい | |
| 承知しました。お手伝いさせていただきます。最初に、注文 ID をお知らせいただけますか？ | |
| ee6b4cc7 | |
| ご注文が確定しました。現在、処理中です。 ご注文内容は次のとおりです。 Nineteen Solid Round Neck Casual Women's Sweater サイズ: ミディアム 数量: 1 配達予定日: 2024 年 4 月 29 日 他にご不明な点はございませんか？ |
|
| 利用しない | |
| お役に立つことができて幸いです。Cymbal Apparel で何かご不明な点がございましたら、お気軽にお問い合わせください。 |
注文した商品の返品
お客様が注文の返品をご希望である。エージェントは注文番号を収集し、注文の詳細を取得して、返品する商品を確認します。エージェントは返品手続きを開始し、返品ラベルを提供します。お客様はラベルを印刷してパッケージに貼り付けます。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 「Hi」 | |
| 上記のオプションから選択するか、ご希望の項目を入力してください。 | |
| 注文した商品を返品したい | |
| 返品についてサポートさせていただきます。最初に、ご注文番号をお知らせいただけますか？ | |
| 0fc77d64 | |
| 注文番号をお知らせいただきありがとうございます。2024 年 4 月 12 日にご注文いただいた商品を確認いたしました。注文内容は、YK プリント ボーイズ ラウンドネック ダークブルー T シャツ（サイズ S）です。返品をご希望の商品は、こちらでよろしいでしょうか？ | |
| はい | |
| 返品手続きを開始いたしました。返品ラベルは下記に添付されています。印刷して荷物に添付してから、返送してください。他に何かお役に立てることはございませんか。 | |
| 利用しない | |
| お役に立つことができて幸いです。Cymbal Apparel で何かご不明な点がございましたら、お気軽にお問い合わせください。 |
基本設定
このビルド済みエージェントを設定するには:
- ビルド済みエージェントをインポートします。
- 付属のツールを外部サービスで構成します。ツールの設定をご覧ください。
ツールの設定
このエージェントには、外部サービスとの統合に使用されるツールが含まれています。これらのツールを構成する手順は次のとおりです。
apparel-dbという名前の Firestore データベースを作成します。- Firestore Integration コネクタを作成します。
- ショッピング アシスタント用の Application Integration をダウンロードします。
projects/customermod-genai-sa/locations/us-central1/connections/firestoreへのすべての参照を、手順 2 で作成したコネクタの ID に置き換えます。- 統合をアップロードして公開します。
- Dialogflow サービス エージェントに
Cloud Functions Invokerロールを付与します。 - 手順に沿って小売カタログを設定します。
- 属性コントロールを更新して、次のフィールドを取得できるようにします。ageGroups、availability、categories、colorFamilies、colors、conditions、cost、currencyCode、description、discount、images、materials、patterns、price、sizes、title、uri。
- サンプルカタログをカタログのブランチ 1 にインポートし、デフォルトのブランチにします。
- こちらで入手できる Cloud Run 関数をダウンロードして、
config.tomlを更新します。 - 手順に沿って Cloud Run 関数をデプロイします。
- デプロイした Cloud Run 関数に
Retail ViewerIAM ロールを付与します。 get-order-status、order-lookup、place-order、return-orderの各ツールで、pathsプロパティを更新して、OpenAPI 仕様のステップ 5 で作成した統合を参照し、Application Integration Invokerロールを付与するサービス アカウントでサービス アカウント認証を選択します。- 残りのツール用にデプロイした Cloud Run 関数に、サーバー URL プロパティを更新します。
Google ショッピング
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 を使用しての追跡を行います。注文のステータスに基づいて適切なメッセージを提供します。
完了
これで、エージェントとその統合が設定され、テストの準備が整いました。