「TypeSafe Jev 시리즈 6/10 — 고정 옵션에서 하나 고르기」 | DAKER 커뮤니티
설명용 생성 이미지입니다.
Choice는 정의된 집합에서 옵션 하나를 고르는 System One 질문 유형입니다. 답에는 선택된 옵션, 옵션별 확률, confidence가 포함됩니다.
1. 언제 쓰나
답이 고정 집합 중 하나일 때 씁니다. 티켓 담당 팀, 상품 카테고리, 코드 언어처럼요. 스펙트럼이면 Score, 예/아니면 Noul입니다.
2. 요청 구조
type: 항상"choice"instructions: 모델이 답할 질문criteria: 옵션 이름 → 설명 맵. 옵션 이름과 설명 모두 모델에 전달됩니다.
질문 id(예: department)는 여러분이 고르고, 같은 id로 답이 돌아옵니다. id는 모델에 보이지 않습니다.
3. 응답 필드
choice— 확률이 가장 높은 옵션probabilities— 모든 옵션 분포(합=1)confidence— 분포가 얼마나 뾰족한지(0–1). 여러 옵션에 퍼지면 낮고, 한 옵션에 모이면 높습니다.
문서 예시에서 쉬운 티켓은 returns에 확률이 몰려 confidence 1.0이 됩니다. 사이즈 문제와 환불이 함께 있으면 returns/billing으로 갈라지고 confidence가 떨어집니다.
4. 한 호출에 여러 Choice
필요한 Choice를 한 요청에 모두 묻습니다. 질문은 병렬 평가되고, 옵션은 최대 255개까지 받을 수 있어 팀·카테고리 전체 목록을 주는 편이 낫습니다. 목록이 불완전하면 other / none of the above를 둡니다.
5. 스펙큘러티브 질문 + 코드 라우팅
문서의 복잡한 지원 예시는 department·return_reason·shipping_issue·requested_resolution·tone을 한 번에 묻습니다. return_reason은 department가 returns일 때만 쓰고, shipping_issue는 shipping일 때만 씁니다. confidence가 낮으면 수동 트리아지·고객에게 재질문으로 보냅니다. 확률 0.25를 넘는 두 번째 팀에는 알림 복사본을 보내는 식의 보통 if 로직입니다.
6. 헷갈리는 옵션은 구조화 설명
옵션이 비슷하면 문자열 대신 객체로 “무엇을 커버하는지 / 무엇이 아닌지 / 예시”를 적습니다. 필드 이름(what, not_for, examples 등)은 API 예약어가 아니라 여러분이 고릅니다.
오늘 할 일
실제 라우팅 카테고리 3–5개를 criteria로 쓰고, 애매한 티켓 한 건에 대해 confidence 임계값(예: 0.3 미만 수동)을 코드에 스케치합니다.
출처
이전: 5/10 Choice·Score·Noul 세 가지 · 다음: 7/10 스펙트럼 위치와 확률