쇼핑 어시스턴트 플레이북 기반 사전 빌드된 에이전트는 소매 제품 쿼리, 주문, 주문 상태, 주문 취소를 제공합니다. 소매업용 Vertex AI Search 및 맞춤 처리 페이로드를 사용하여 풍부한 시각적 환경을 제공합니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 에이전트가 처리하는 일반적인 시나리오를 보여줍니다.
제품 및 리뷰 비교
사용자가 전통 사리를 둘러보겠다고 요청합니다. 상담사가 몇 가지 인기 있는 옵션을 제시하고 사용자가 첫 번째 옵션을 선택합니다. 사용자가 어울리는 신발을 요청합니다. 상담사가 인기 있는 옵션을 제시하고 사용자는 리뷰를 비교해 달라고 요청한 후 평점이 가장 높은 옵션을 선택합니다. 상담사가 사이즈를 묻고 신발이 장바구니에 추가되었음을 확인합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 전통 사리 보여 줘 | |
| [제품 소개] 이 제품 중 관심이 있는 제품이 있나요? 아니면 다른 옵션을 찾고 계신가요? | |
| 첫 번째는 좋습니다. | |
| 탁월한 선택입니다. 인도식 아름다움 셀프 디자인, 인쇄된 패션 조지트 사리입니다. 사리는 일반적으로 한 가지 크기이므로 잘 맞습니다. 장바구니에 추가하시겠어요? | |
| do you have a matching heels with it? | |
| [제품 소개] 이 제품 중 관심이 있는 제품이 있나요? 아니면 다른 옵션을 찾고 계신가요? | |
| 예, 하지만 고객 리뷰를 살펴보고 그중에서 가장 좋은 리뷰를 선택해 주시겠어요? | |
| Flat n Heels 여성용 힐의 평균 평점은 별 5개 중 4개이고 Glitzy Galz 여성용 힐의 평균 평점은 별 5개 중 4.5개입니다. Flat n Heels 여성용 힐을 구매한 고객의 리뷰는 엇갈렸습니다. 처음에는 편안하지만 몇 시간 후에는 불편하다는 의견이 있는 반면 편안하다는 의견도 있었습니다. 반면 Glitzy Galz 여성용 힐은 대부분 긍정적인 리뷰를 받았으며, 고객들은 착용감, 품질, 디자인을 칭찬했습니다. 장바구니에 어떤 제품을 추가하시겠어요? | |
| 리뷰와 평점이 가장 우수한 제품 | |
| Glitzy Galz Women Heels의 평점은 별표 5개 중 4.5개로 가장 높습니다. Glitzy Galz 여성용 힐을 어떤 사이즈로 선택하시겠어요? 사이즈는 5~11까지 있습니다. | |
| 6 | |
| 완벽해요. 사이즈 6의 Glitzy Galz 여성용 힐이 수량 1개로 장바구니에 추가되었습니다. 장바구니에 추가할 다른 제품이 있으신가요? |
엔드 투 엔드 쇼핑 환경
사용자가 제품 카탈로그를 탐색합니다. 에이전트가 사용자의 요청에 따라 추천을 표시합니다. 사용자가 몇 번 검색한 후 구매할 상품을 찾습니다. 상담사가 구매할 상품의 크기와 수량, 예상 배송일을 확인합니다. 사용자가 사용 불가능한 다른 배송일을 요청하고 원래 배송일에 동의합니다. 상담사가 등록된 배송, 결제, 연락처 정보를 확인합니다. 사용자가 배송 정보를 업데이트하고 확인합니다. 상담사가 주문을 처리하고 사용자에게 주문 번호를 제공합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 날씨가 추워지고 있습니다. 좋은 스웨터가 있나요? | |
| [제품을 보여줍니다.] 이 제품 중 관심이 있는 제품이 있나요? 아니면 다른 옵션을 찾고 계신가요? | |
| 아내를 위한 여성용 스웨터는 마음에 드는데, 남자아이용 스웨터를 찾고 있습니다. | |
| [제품을 보여줍니다.] 이 제품 중 관심이 있는 제품이 있나요? 아니면 다른 옵션을 찾고 계신가요? | |
| 장바구니에 첫 번째 여성용 스웨터 추가 | |
| Nineteen Solid Round Neck Casual Women's Sweater(19단색 라운드넥 캐주얼 여성용 스웨터)는 어떤 사이즈로 선택하시겠어요? 초소형부터 초대형까지 다양한 사이즈를 제공합니다. | |
| 중간 | |
| 완벽해요. 미디엄 사이즈의 Nineteen 솔리드 라운드 넥 캐주얼 여성용 스웨터가 1개로 장바구니에 추가되었습니다. 장바구니에 추가할 다른 제품이 있으신가요? | |
| 아니요 | |
| Nineteen Solid Round Neck Casual Women's Sweater는 2024년 4월 29일까지 배송될 예정입니다. 괜찮으신가요? | |
| 4월 28일에 배송해 주시겠어요? | |
| 죄송하지만 2024년 4월 28일에 Nineteen Solid Round Neck Casual Women's Sweater를 배송해 드릴 수 없습니다. 가장 빨리 배송할 수 있는 날짜는 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일에 배송될 예정입니다. | |
| thanks | |
| 주문이 완료되었습니다. 도움이 필요한 문제가 또 있으신가요? | |
| 나중에 | |
| 도움을 드릴 수 있어 다행입니다. Cymbal Apparel과 관련하여 도움이 필요하시면 언제든지 문의해 주세요.\ |
주문 상태 확인
사용자가 주문 상태를 확인해 달라고 요청합니다. 상담사가 주문 번호를 수집하고 주문 정보를 검색합니다. 상담사는 주문의 상품에 관한 세부정보와 현재 상태, 예상 배송일을 제공합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 안녕하세요. | |
| 위 옵션 중에서 선택하거나 원하는 내용을 입력해 주시면 최선을 다해 도와드리겠습니다. | |
| 주문 상태를 확인하고 싶습니다. | |
| 물론입니다. 제가 도와드리겠습니다. 시작하려면 주문 ID를 알려주시겠어요? | |
| ee6b4cc7 | |
| 주문이 확인되었습니다. 현재 처리 중입니다. 주문하신 내용은 다음과 같습니다. Nineteen 솔리드 라운드 넥 캐주얼 여성용 스웨터 19개 사이즈: 미디엄 수량: 1개 예상 배송일: 2024년 4월 29일 도움이 더 필요하신가요? |
|
| 아니요 | |
| 도움을 드릴 수 있어 다행입니다. Cymbal Apparel과 관련하여 도움이 필요하시면 언제든지 문의해 주세요. |
주문 반품
사용자가 주문을 반품하려고 합니다. 상담사가 주문 번호를 수집하고 주문 세부정보를 가져와 반품할 상품을 확인합니다. 그러면 상담사가 반품 절차를 시작하고 사용자가 인쇄하여 패키지에 부착할 반품 라벨을 제공합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 안녕하세요. | |
| 위 옵션 중에서 선택하거나 원하는 내용을 입력해 주시면 최선을 다해 도와드리겠습니다. | |
| 주문을 반품하고 싶습니다. | |
| 반품과 관련하여 최선을 다해 도와드리겠습니다. 먼저 주문 번호를 알려주시겠어요? | |
| 0fc77d64 | |
| 주문 번호를 알려주셔서 감사합니다. 2024년 4월 12일에 주문하신 내역을 확인했습니다. 주문 제품에는 YK 인쇄된 남아용 라운드 넥 다크 블루 티셔츠(사이즈 S)가 포함되어 있습니다. 반품하려는 상품이 맞나요? | |
| 예 | |
| 알겠습니다. 반품 절차를 시작했습니다. 아래에 반품 라벨이 첨부되어 있습니다. 이를 인쇄한 후 패키지에 부착한 다음 반품하세요. 도움이 필요한 문제가 또 있으신가요? | |
| 아니요 | |
| 도움을 드릴 수 있어 다행입니다. Cymbal Apparel과 관련하여 도움이 필요하시면 언제든지 문의해 주세요. |
기본 설정
이 사전 빌드된 에이전트를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 에이전트를 가져옵니다.
- 제공되는 도구를 외부 서비스에 구성합니다. 도구 설정을 참조하세요.
도구 설정
이 에이전트에는 외부 서비스와 통합하는 데 사용되는 도구가 포함되어 있습니다. 이러한 도구를 구성하려면 다음 단계를 따르세요.
apparel-db라는 Firestore 데이터베이스를 만듭니다.- Firestore 통합 커넥터를 만듭니다.
- Shopping Assistant용 Application Integration을 다운로드합니다.
projects/customermod-genai-sa/locations/us-central1/connections/firestore에 대한 모든 참조를 2단계에서 만든 커넥터의 식별자로 바꿉니다.- 통합을 업로드하고 게시합니다.
- Dialogflow Service Agent에
Application Integration Invoker역할을 부여합니다. paths속성을 업데이트하여get-order-status,order-lookup,place-order,return-order도구의 OpenAPI 사양에서 5단계에서 만든 통합을 참조합니다.
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를 사용하여 주문을 추적합니다.
주문 상태에 따라 적절한 메시지를 제공합니다.
완료
이제 에이전트 및 통합이 설정되어 테스트할 수 있습니다.