쇼핑 어시스턴트 플레이북 기반 사전 빌드된 에이전트 는 소매 제품 쿼리, 주문, 주문 상태, 주문 취소를 제공합니다. Vertex AI Search for Retail 및 맞춤 주문 처리 페이로드를 사용하여 풍부한 시각적 환경을 제공합니다.
샘플 대화 작성
다음 샘플 대화상자에서는 사전 빌드된 에이전트가 처리하는 일반적인 시나리오를 보여줍니다.
제품 및 리뷰 비교
사용자가 전통적인 사리를 찾아보라고 요청합니다. 에이전트가 인기 있는 옵션을 제공하고 사용자가 첫 번째 옵션을 선택합니다. 사용자가 어울리는 신발을 요청합니다. 에이전트가 인기 있는 옵션을 제공하고 사용자가 리뷰를 비교해 달라고 요청하며 평점이 가장 높은 옵션을 선택합니다. 에이전트가 사이즈를 묻고 신발이 장바구니에 추가되었음을 확인합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 전통적인 사리 보여 줘 | |
| [제품 표시] 이 제품 중 관심 있는 제품이 있나요? 아니면 다른 옵션을 찾고 있나요? | |
| 첫 번째 제품이 좋아 보여 | |
| 탁월한 선택입니다. 인도 미인 셀프 디자인, 프린트 패션 조젯 사리는 아름다운 제품입니다. 사리는 일반적으로 원사이즈이므로 완벽하게 맞을 것입니다. 장바구니에 추가하시겠어요? | |
| 어울리는 힐이 있나요? | |
| [제품 표시] 이 제품 중 관심 있는 제품이 있나요? 아니면 다른 옵션을 찾고 있나요? | |
| 네, 하지만 고객 리뷰를 살펴보고 이 중에서 가장 좋은 제품을 선택해 주시겠어요? | |
| 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 | |
| 완벽해요. 6 사이즈의 Glitzy Galz Women Heels가 장바구니에 수량 1개 추가되었습니다. 장바구니에 추가할 다른 제품이 있나요? |
엔드 투 엔드 쇼핑 환경
사용자가 제품 카탈로그를 둘러봅니다. 에이전트가 사용자의 요청에 따라 추천을 제공합니다. 몇 번의 검색 후 사용자가 구매할 제품을 찾습니다. 에이전트가 구매할 제품의 사이즈와 수량, 예상 배송일을 확인합니다. 사용자가 다른 배송일을 요청하지만 해당 날짜는 불가능하며 원래 배송일에 동의합니다. 에이전트가 등록된 배송, 결제, 연락처 정보를 확인합니다. 사용자가 배송 정보를 업데이트하고 확인합니다. 에이전트가 주문을 하고 사용자에게 주문 번호를 제공합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 날씨가 추워지고 있어. 좋은 스웨터가 있나요? | |
| [제품 표시]. 이 제품 중 관심 있는 제품이 있나요? 아니면 다른 옵션을 찾고 있나요? | |
| 아내에게 줄 여성용 스웨터가 마음에 들지만 남자아이용 스웨터를 찾고 있어 | |
| [제품 표시]. 이 제품 중 관심 있는 제품이 있나요? 아니면 다른 옵션을 찾고 있나요? | |
| 첫 번째 여성용 스웨터를 장바구니에 추가해 줘 | |
| Nineteen Solid Round Neck Casual Women's Sweater의 사이즈는 어떤 것으로 하시겠어요? XS부터 XL까지 사이즈가 있습니다. | |
| 매체 | |
| 완벽해요. M 사이즈의 Nineteen Solid Round Neck Casual Women's Sweater가 장바구니에 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 | |
| 결제 정보: 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 사이즈: M 수량: 1 예상 배송일: 2024년 4월 29일 도움이 필요한 문제가 또 있으신가요? |
|
| 나중에 | |
| 도움을 드릴 수 있어 기쁩니다. Cymbal Apparel에서 필요한 것이 있으면 언제든지 클릭해 주세요. |
주문 반품
사용자가 주문을 반품하려고 합니다. 에이전트가 주문 번호를 수집하고 주문 세부정보를 가져와서 반품할 제품을 확인합니다. 그런 다음 에이전트가 반품 절차를 시작하고 사용자에게 인쇄하여 패키지에 부착할 수 있는 반품 라벨을 제공합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 안녕하세요. | |
| 위의 옵션 중에서 선택하거나 찾고 있는 내용을 입력해 주세요. 도와드리겠습니다. | |
| 주문을 반품하고 싶어 | |
| 반품을 도와드리겠습니다. 시작하려면 주문 번호를 알려주시겠어요? | |
| 0fc77d64 | |
| 주문 번호를 알려주셔서 감사합니다. 2024년 4월 12일에 주문하신 제품을 찾았습니다. 주문에는 YK 프린트 남자아이용 라운드넥 다크 블루 티셔츠(S 사이즈)가 포함되어 있습니다. 이 제품을 반품하시겠어요? | |
| 예 | |
| 알겠습니다. 반품 절차를 시작했습니다. 아래에 반품 라벨이 첨부되어 있습니다. 인쇄하여 패키지에 부착한 후 반송해 주세요. 도움이 필요한 문제가 또 있으신가요? | |
| 나중에 | |
| 도움을 드릴 수 있어 기쁩니다. Cymbal Apparel에서 필요한 것이 있으면 언제든지 클릭해 주세요. |
기본 설정
이 사전 빌드된 에이전트를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 에이전트를 가져옵니다.
- 제공되는 도구를 외부 서비스에 구성합니다. 도구 설정을 참조하세요.
도구 설정
이 에이전트에는 도구가 포함되어 있으며 외부 서비스와 통합하는 데 사용됩니다. 이러한 도구를 구성하려면 다음 단계를 따르세요.
-
Firestore 데이터베이스
apparel-db라는 이름을 만듭니다. - Firestore 통합 커넥터를 만듭니다 .
- Application Integration 쇼핑 어시스턴트용을 다운로드합니다.
projects/customermod-genai-sa/locations/us-central1/connections/firestore에 대한 모든 참조를 2단계에서 만든 커넥터의 식별자로 바꿉니다.- 통합을 업로드 하고 게시합니다.
- Dialogflow 서비스 에이전트에
Cloud Functions Invoker역할을 부여합니다. - 단계에 따라 Retail 카탈로그를 설정합니다.
- 다음 필드를 검색할 수 있도록 속성 컨트롤을 업데이트합니다. 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)의 경우 OpenAPI 사양에서 5단계에서 만든 통합을 참조하도록paths속성을 업데이트하고 서비스 계정 인증을 선택하고Application Integration Invoker역할을 부여할 서비스 계정을 선택합니다. - 나머지 도구에 대해 배포한 Cloud Run 함수로 서버 URL 속성을 업데이트합니다.
제품 검색
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를 사용하여 추적하는 역할을 합니다.
주문 상태에 따라 적절한 메시지를 제공합니다.
완료
이제 에이전트 및 통합이 설정되어 테스트할 수 있습니다.