ショッピング アシスタントのハンドブックベースのビルド済みエージェントは、小売商品のクエリ、注文、注文ステータス、注文のキャンセルを提供します。Agent Search for Retail とカスタム フルフィルメント ペイロードを使用して、リッチなビジュアル エクスペリエンスを提供します。
会話の例
このサンプル ダイアログは、このビルド済みエージェントが処理する一般的なシナリオを示しています。
商品とレビューの比較
- ユーザーが伝統的なサリーを閲覧したいとリクエストします。
- エージェントが人気のオプションをいくつか提示し、ユーザーが最初のオプションを選択します。
- ユーザーが、一致する靴をリクエストします。
- エージェントが人気のオプションをいくつか提示し、ユーザーはレビューを比較して最も評価の高いオプションを選択するよう依頼します。
- エージェントはサイズについて尋ね、靴がカートに追加されたことを確認します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 伝統的なサリーを見せて | |
| [商品を紹介する] これらの商品の中に興味のあるものはありますか？それとも、別のオプションをお探しですか？ | |
| 1 つ目は問題なさそうです | |
| ドメインのご購入ありがとうございます。インドの美しさを表現した、セルフデザインのプリント ファッション ジョーゼット サリーは、美しい一品です。サリーは通常ワンサイズなので、ぴったりフィットします。カートに追加しますか？ | |
| これに合うヒールはありますか？ | |
| [商品を紹介する] これらの商品の中に興味のあるものはありますか？それとも、別のオプションをお探しですか？ | |
| はい。ただし、購入者のレビューを確認して、その中から最適なものを選んでいただけますか？ | |
| Flat n Heels Women Heels の平均評価は 5 つ星中 4 つ星ですが、Glitzy Galz Women Heels の平均評価は 5 つ星中 4.5 つ星です。Flat n Heels Women Heels を購入したお客様のレビューはさまざまで、最初は快適だったが数時間後に不快になったというお客様もいれば、快適さを称賛するお客様もいました。一方、Glitzy Galz のレディース ヒールは、フィット感、品質、デザインがお客様から高く評価され、ほとんどが肯定的なレビューでした。どちらをカートに追加しますか？ | |
| レビューと評価が最も高いもの | |
| Glitzy Galz レディース ハイヒールは、5 つ星中 4.5 という最も高い評価を得ています。Glitzy Galz Women Heels のサイズはどれをご希望ですか？サイズは 5 から 11 まであります。 | |
| 6 | |
| ありがとうございます。Glitzy Galz Women Heels のサイズ 6 を 1 点、カートに追加しました。他にカートに追加する商品はありますか？ |
エンドツーエンドのショッピング エクスペリエンス
- ユーザーが商品カタログを閲覧します。
- エージェントは、ユーザーのリクエストに基づいておすすめを提示します。
- 数回の検索の後、ユーザーは購入する商品を見つけます。
- エージェントは、購入する商品のサイズと数量、配送予定日を確認します。
- お客様が別の配達日をリクエストしたが、その日は利用できず、元の配達日に同意した。
- エージェントは、登録されている配送先、お支払い、連絡先の情報を確認します。
- お客様が配送情報を更新して確認します。
- エージェントは注文を行い、ユーザーに注文番号を提供します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| 寒くなってきました。良いセーターはありますか | |
| [プロダクトを提示する]。これらの製品にご興味はありますか？それとも、他のオプションをお探しですか？ | |
| 妻用にレディースセーターは気に入ったが、男の子用のセーターを探している | |
| [プロダクトを提示する]。これらの製品にご興味はありますか？それとも、他のオプションをお探しですか？ | |
| 最初のレディース セーターをカートに追加 | |
| Nineteen Solid Round Neck Casual Women's Sweater のサイズはどれにしますか？サイズは XS から XL まであります。 | |
| 中 | |
| ありがとうございます。Nineteen の無地ラウンドネック カジュアル レディース セーター（M サイズ）1 点をカートに追加しました。他にカートに追加する商品はありますか？ | |
| いいえ | |
| Nineteen Solid ラウンドネック カジュアル レディース セーターの最短のお届け日は 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 無地 ラウンドネック カジュアル レディース セーター サイズ: M 数量: 1 お届け予定日: 2024 年 4 月 29 日 他に何かご不明な点はございませんか？ |
|
| 利用しない | |
| お役に立ててよかったです。Cymbal Apparel のことで何かご不明な点がございましたら、お気軽にお問い合わせください。 |
注文の返品
- お客様が注文の返品を希望している。
- エージェントは注文番号を収集し、注文の詳細を取得して、返品する商品を確認します。
- エージェントは返品手続きを開始し、お客様が印刷して荷物に貼る返品ラベルを提供します。
| ユーザー入力 | エージェントの応答 |
|---|---|
| こんにちは | |
| 上記のオプションから選択するか、お探しの内容を入力してください。 | |
| 注文した商品を返品したい | |
| 返品手続きをお手伝いいたします。まず、ご注文番号を教えていただけますか？ | |
| 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 functions の関数をダウンロードして、
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 プロパティを更新します。
商品検索ツール
search-products ツールは、検索クエリと商品カタログのオフセット値に基づいて、最も一致する商品を取得します。このツールは、商品の詳細を含むカスタム ペイロード レスポンスを返します。このカスタム ペイロードは、UI で商品をリッチ コンテンツ形式で表示するために使用されます。
商品詳細取得ツール
get-product-details ツールは、AI Commerce Search API を使用して商品カタログから商品の詳細を取得します。システムは、取得した商品の詳細を変換して簡素化された形式で返します。エージェントは、この情報を使用して、ユーザーに表示した商品に関する質問に回答します。
クチコミ獲得ツール
get-reviews ツールは、商品のレビューを取得します。表示された商品のリストを受け取り、各商品のレビューを取得します。生成されたレビューは、リッチ ユーザー インターフェースでの表示に適したカスタム テンプレート（review_template）形式に変換されます。
類似商品ツール
similar-products ツールは、Retail Recommendation API を使用して、特定の商品に類似した商品の検出を容易にします。商品 ID を受け取り、Retail Recommendation API を使用して商品カタログから類似商品を予測します。
お届け日ツール
store-delivery-date ツールは、ショッピング カート内の商品のユーザーの希望配送日を保存します。この日付は、最も早い配送予定日と比較する必要があります。
get-delivery-date ツールは、ショッピング カート内の商品の配送予定日を推定します。
Get User Info ツール
get-user-info ツールは、配送先住所、支払い情報、電話番号、メールアドレスなどのユーザーの個人情報を取得します。update-user-info ツールがユーザーの情報を更新します。
注文ツール
place-order ツールは、ショッピング カートのアイテムを注文します。注文 ID、ステータス、作成タイムスタンプ、商品リストなどの注文データを Firestore に保存し、注文番号をエージェントに返します。
Order Lookup ツール
order-lookup ツールは、指定されたオーダー ID を使用して Firestore データベースから注文データを取得し、注文情報をエージェントに返します。
Return Order ツール
return-order ツールは、Firestore データベースで注文のステータスを「return_pending」に更新します。これは、返品が開始され、保留中であることを示します。
注文ステータス取得ツール
get-order-status ツールは、注文のステータスを取得し、注文が発送された場合は DHL API を使用して追跡します。注文ステータスに基づいて適切なメッセージが表示されます。
完了
これで、エージェントとその統合が設定され、テストの準備が整いました。