KT

KT 상품 지식 데이터베이스에서 검색어에 맞는 원문(passage)을 조회하는 리트리벌 도구입니다. ## ⛔ 타사 상품 검색 금지 이 도구는 KT 상품 정보만 제공합니다. SKT, LG U+ 등 타사 요금제·멤버십·단말기·결합 상품의 검색 또는 비교를 위해 이 도구를 호출하지 마십시오. 타사 상품 요청에는 제공 불가 사실을 텍스트로 안내하고, `search_myk`와 `search_result_render`를 호출하지 마십시오. ## 🧭 1단계: 주제 분류 (호출 전 반드시 수행) 사용자 요청이 **특정 상품의 안내·추천·비교 카드가 필요한지** 먼저 `render_intent`로 판단한 뒤 `render_target`을 지정하십시오. - `product_recommendation`: 사용자 조건에 맞는 특정 상품 추천 - `product_detail`: 특정 요금제·멤버십 등급·단말기 자체의 상세 안내 - `product_comparison`: 특정 상품 후보들의 조건·가격·혜택 비교 - `billing_discount_calculation`: 기존 LTE/5G·결합 할인·요금제 전환의 할인율·청구 금액·절감액 계산 - `procedure_policy`: 약정·위약금·가입/해지·정책/절차 안내 - `other`: 위 분류 외 일반 문의 `product_*`일 때만 아래 상품 유형을 `render_target`에 지정하십시오. - `plan`: 요금제·인터넷·결합 상품의 추천, 상세 안내, 비교 (예: 디즈니+ 무료 제공 요금제 추천) - `membership`: 멤버십 등급·혜택·제휴 할인 안내와 비교 - `device`: 단말기·기기의 추천, 상세 안내, 가격·스펙 비교 - `other`: 약정 할인·선택약정·할인 반환금·위약금 설명, 기존 LTE/5G·결합 할인 적용 금액·할인율·요금제 전환 후 할인 계산 비교, 가입·해지·명의변경 절차, 요금 납부·청구, 고객센터·매장 안내, 약관·정책, 장애·AS, 부가서비스 사용법 등 상품 자체가 아닌 요청 ## 🔀 2단계: 분류 결과에 따른 분기 ### A. `render_intent`가 `product_*`인 경우 — 위젯 렌더 flow 1. `search_render`를 먼저 한 번 호출해 빈 카드 위젯을 표시하고 `flow_id`를 받습니다. 2. 그 `flow_id`를 변경하지 않고 `search_myk`에 전달해 원문을 수집합니다. 3. 검색 결과를 `items`, `summary`, `content_type`으로 정형화하고 같은 `flow_id`로 `search_result_render`를 즉시 호출합니다. - 내부 검색 결과가 실제로 0건인 경우에만 `items: []`로 호출합니다. 검색 결과의 passage 또는 RAG answer에 상품명이 있으면 원문을 근거로 상품 카드를 구성하십시오. 설명·제공량·혜택 같은 보조 필드만 비울 수 있습니다. **요금제 `monthly_fee`와 단말기 `price`는 원문에 명시된 양수 금액만 사용하며, 알 수 없다고 0을 넣지 마십시오.** 가격이 확인되지 않은 항목은 카드에서 제외하고, 남는 항목이 없으면 `items: []`를 사용하십시오. 임의의 상품명이나 placeholder 카드만 만들지는 마십시오. 4. 위젯 렌더링 완료만 짧게 알리고 위젯 내용을 텍스트로 중복 설명하지 않습니다. - 이 경우 `search_myk` 결과만으로 대화를 종료하거나 자연어로만 요약하고 끝내지 마십시오. ### B. `render_intent`가 `billing_discount_calculation` / `procedure_policy` / `other`인 경우 — 텍스트 응답 flow 1. `search_myk` 호출로 원문을 수집합니다. 2. **`search_result_render`를 호출하지 마십시오.** 3. 검색 결과를 근거로 사용자 질문에 텍스트로 직접 답변합니다. 후속 질문으로 주제가 바뀌면 `render_target`을 다시 분류하여 `search_myk`를 재호출하십시오.

search_myk

초기 마운트된 KT 위젯에서만 사용하는 앱 전용 결과 조회 도구입니다.

get_search_result

KT 상품 카드 위젯을 빈 상태로 먼저 표시합니다. 먼저 요청 의도를 `render_intent`로 판단하십시오. `product_recommendation`, `product_detail`, `product_comparison`일 때만 `render_target`을 plan, membership, device 중 하나로 지정해 `search_myk` 직전에 한 번 호출하십시오. 반환된 `flow_id`를 이어지는 `search_myk`와 `search_result_render`에 변경 없이 전달하십시오. 기존 요금제의 할인율·결합 할인·전환 후 금액 계산은 `billing_discount_calculation`, 가입·해지·약관 등은 `procedure_policy`, 그 밖은 `other`로 지정하며 이 도구를 호출하지 마십시오.

search_render

search_myk 검색 결과를 카드용 JSON으로 변환하고, 완성된 데이터가 포함된 KT 카드 위젯을 직접 표시합니다. ## 🚦 호출 조건 `search_myk`를 `render_target`=plan, membership, device 중 하나로 호출한 경우에만 이어서 한 번 호출하십시오. `render_target`=other이면 이 도구를 호출하지 마십시오. 요금제·멤버십·단말기의 추천, 상세 안내, 비교일 때 호출하십시오. content_type별 items JSON 규격: - plan_detail 또는 plan_comparison: [{"name": string, "description": string, "monthly_fee": integer, "network": string, "data": string, "voice": string, "qos": string, "features": string[], "membership": string}] - membership: [{"grade_name": string, "grade_description": string, "requirements": string, "benefits": string[]}] - device_detail 또는 device_comparison: [{"device_name": string, "description": string, "price": integer, "features": string[]}] monthly_fee와 price는 원문에 명시된 양수 금액만 통화기호·쉼표 없는 정수로 작성하십시오. 금액이 확인되지 않았다고 0을 넣지 말고 해당 항목을 카드에서 제외하십시오. summary에는 카드에 없는 보충 설명만 Markdown 문자열로 작성하십시오.

search_result_render