쇼핑 어시스턴트 플레이북 기반 사전 빌드된 에이전트는 소매 제품 쿼리, 주문, 주문 상태, 주문 취소를 제공합니다. 소매업용 에이전트 검색과 커스텀 처리 페이로드를 사용하여 풍부한 시각적 경험을 제공합니다.
샘플 대화
이 샘플 대화상자는 사전 빌드된 에이전트가 처리하는 일반적인 시나리오를 보여줍니다.
제품 및 리뷰 비교
- 사용자가 전통 사리를 둘러보고 싶다고 요청합니다.
- 에이전트가 몇 가지 인기 있는 옵션을 제시하고 사용자가 첫 번째 옵션을 선택합니다.
- 사용자가 어울리는 신발을 요청합니다.
- 에이전트가 인기 있는 옵션을 제시하고 사용자가 리뷰를 비교해 달라고 요청한 후 평점이 가장 높은 옵션을 선택합니다.
- 상담사가 사이즈를 묻고 신발이 장바구니에 추가되었는지 확인합니다.
| 사용자 입력 | 에이전트 대답 |
|---|---|
| 전통 사리 보여 줘 | |
| [제품 제시] 이 제품 중에 관심이 가는 제품이 있으신가요? 아니면 다른 옵션을 찾고 계신가요? | |
| 첫 번째 항목이 좋아 보입니다. | |
| 탁월한 선택입니다. Indian Beauty의 셀프 디자인 프린트 패션 조젯 사리는 아름다운 제품입니다. 사리는 일반적으로 프리 사이즈이므로 완벽하게 맞을 것입니다. 장바구니에 추가하시겠어요? | |
| 이 드레스에 어울리는 하이힐이 있나요? | |
| [제품 제시] 이 제품 중에 관심이 가는 제품이 있으신가요? 아니면 다른 옵션을 찾고 계신가요? | |
| 네, 하지만 고객 리뷰를 살펴보고 이 중에서 가장 좋은 리뷰를 선택해 주시겠어요? | |
| Flat n Heels 여성용 하이힐의 평균 평점은 4/5점이고 Glitzy Galz 여성용 하이힐의 평균 평점은 4.5/5점입니다. Flat n Heels Women Heels를 구매한 고객의 리뷰는 엇갈렸습니다. 처음에는 편안하지만 몇 시간 후에는 불편하다는 의견도 있었고, 편안함을 칭찬하는 의견도 있었습니다. 반면 Glitzy Galz 여성용 하이힐은 착용감, 품질, 디자인에 대한 고객의 칭찬과 함께 대체로 긍정적인 리뷰를 받았습니다. 어떤 항목을 장바구니에 추가하시겠어요? | |
| 리뷰와 평점이 가장 좋은 곳 | |
| Glitzy Galz 여성용 하이힐의 평점이 4.5/5점으로 가장 높습니다. Glitzy Galz 여성용 하이힐의 어떤 사이즈를 원하시나요? 사이즈는 5부터 11까지 있습니다. | |
| 6 | |
| 완벽해요. 사이즈 6의 Glitzy Galz 여성용 하이힐 1개가 장바구니에 추가되었습니다. 장바구니에 추가할 다른 상품이 있으신가요? |
엔드 투 엔드 쇼핑 환경
- 사용자가 제품 카탈로그를 둘러봅니다.
- 에이전트는 사용자의 요청에 따라 추천을 표시합니다.
- 몇 번의 검색 끝에 사용자는 구매할 상품을 찾습니다.
- 에이전트가 구매할 상품의 크기와 수량, 예상 배송일을 확인합니다.
- 사용자가 다른 배송 날짜를 요청하지만 해당 날짜가 불가능하여 원래 배송 날짜에 동의합니다.
- 상담사가 등록된 배송, 결제, 연락처 정보를 확인합니다.
- 사용자가 배송 정보를 업데이트하고 확인합니다.
- 상담사가 주문을 하고 사용자에게 주문 번호를 제공합니다.
| 사용자 입력 | 에이전트 대답 |
|---|---|
| 날씨가 추워지고 있습니다. 좋은 스웨터가 있나요? | |
| [제품을 소개합니다.] 이 중에 관심이 가는 제품이 있으신가요? 아니면 다른 옵션을 원하시나요? | |
| 아내에게 줄 여성용 스웨터는 마음에 드는데, 아들에게 줄 스웨터를 찾고 있어. | |
| [제품을 소개합니다.] 이 중에 관심이 가는 제품이 있으신가요? 아니면 다른 옵션을 원하시나요? | |
| 첫 번째 여성 스웨터를 장바구니에 추가해 줘 | |
| Nineteen Solid Round Neck Casual Women's Sweater의 어떤 사이즈를 원하시나요? 초소형부터 초대형까지 다양한 사이즈가 있습니다. | |
| 중간 | |
| 완벽해요. Nineteen Solid Round Neck Casual Women's Sweater(M 사이즈) 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일에 배송될 예정입니다. | |
| 감사합니다 | |
| 주문이 완료되었습니다. 도움이 필요한 문제가 또 있으신가요? | |
| 나중에 | |
| 도움이 되었다니 다행입니다. 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에서 필요한 것이 있으면 언제든지 클릭 한 번으로 연락해 주세요. |
기본 설정
이 사전 빌드된 에이전트를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 에이전트를 가져옵니다.
- 제공되는 도구를 외부 서비스에 구성합니다. 자세한 내용은 도구 설정을 참고하세요.
도구 설정
이 에이전트에는 외부 서비스와 통합하는 데 사용되는 도구가 포함되어 있습니다. 이러한 도구를 구성하려면 다음 단계를 따르세요.
apparel-db라는 Firestore 데이터베이스를 만듭니다.- Firestore Integration 커넥터를 만듭니다.
- 쇼핑 어시스턴트용 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 Functions를 다운로드하고
config.toml를 업데이트합니다. - Cloud Run Functions를 배포하는 단계를 따릅니다.
- 배포한 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 도구는 배송지 주소, 결제 정보, 전화번호, 이메일을 포함한 사용자의 개인 정보를 검색합니다. update-user-info 도구는 사용자의 정보를 업데이트합니다.
주문 도구
place-order 도구는 장바구니 상품을 주문합니다. 주문 ID, 상태, 생성 타임스탬프, 제품 목록을 포함한 주문 데이터를 Firestore에 저장한 후 주문 번호를 에이전트에 반환합니다.
주문 조회 도구
order-lookup 도구는 제공된 주문 ID를 사용하여 Firestore 데이터베이스에서 주문 데이터를 가져오고 주문 정보를 에이전트에 반환합니다.
주문 반품 도구
return-order 도구는 Firestore 데이터베이스에서 주문 상태를 'return_pending'으로 업데이트하여 반품이 시작되었으며 대기 중임을 나타냅니다.
주문 상태 가져오기 도구
get-order-status 도구는 주문 상태를 가져오고 주문이 배송되면 DHL API를 사용하여 추적합니다. 주문 상태에 따라 적절한 메시지를 제공합니다.
완료
이제 에이전트 및 통합이 설정되어 테스트할 수 있습니다.