사용 사례
분류를 위한 Decisions API
분류는 입력에 대해 유한한 레이블 중 하나를 고르는 작업입니다 — 바로 의사결정 엔드포인트가 기본적으로 하는 일입니다. 생성된 텍스트에서 레이블을 파싱하는 대신, 레이블을 미리 정의하고 승자와 모든 옵션의 확률을 돌려받습니다.
업데이트
유한 레이블이 맞는 경우
다운스트림 코드가 알려진 답변 집합 중 하나를 필요로 할 때마다 의사결정 호출이 맞습니다: 티켓 카테고리, 모더레이션 판정, 인텐트 레이블, 문서 유형. 사람이 고정 목록에서 고를 것이라면 choice 질문이 그대로 번역입니다.
레이블이 무제한이라면 — 모든 입력이 새 카테고리가 될 수 있다면 — 분류는 적합한 형태가 아니며 생성이 필요합니다. 적합한 지점은 이름을 붙이고 설명할 수 있는 닫힌 집합입니다.
- 지원 티켓 카테고리: billing, bug, account, other
- 콘텐츠 모더레이션 판정: spam, safe, needs review
- 인텐트 레이블: refund, cancel, change plan, question
단일 레이블: choice 질문 하나
단일 레이블 분류에는 각 레이블을 짧은 설명에 매핑하는 criteria를 가진 choice 질문 하나를 보냅니다. 항상 other 또는 unclear 옵션을 포함하세요 — 모델에게 정직한 출구를 주어 경계선 입력이 잘못된 버킷에 들어가지 않게 합니다.
단일 레이블 choice
// Single-label classification: one choice question per call.
const res = await fetch("https://decisions-api.net/api/v1/decisions", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "decisions-1",
state: "I was charged twice for my subscription this month.",
questions: {
category: {
type: "choice",
instructions: "Which category fits this support ticket best?",
criteria: {
billing: "Charges, invoices, refunds, or subscriptions.",
bug: "Something is broken or returns an error.",
account: "Login, password, or profile problems.",
other: "None of the above fit.",
},
},
},
}),
});
// Illustrative response: answers.category ->
// { choice: "billing", probabilities: {...}, confidence: 0.91 }멀티 레이블: 한 번의 호출에 여러 noul 질문
여러 태그가 동시에 참일 수 있는 멀티 레이블 분류는 같은 state에 대한 여러 noul 질문으로 매핑됩니다. 각 noul 질문은 한 레이블의 '예' 확률이며, 한 번의 호출에 최대 6개의 질문을 같은 1 크레딧으로 담을 수 있습니다.
멀티 레이블 noul 배치
// Multi-label moderation: several noul questions over the same state.
// Each noul answer is a yes-probability between 0 and 1.
const res = await fetch("https://decisions-api.net/api/v1/decisions", {
method: "POST",
headers: {
Authorization: "Bearer YOUR_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "decisions-1",
state: "Congratulations! Verify your account to claim your prize.",
questions: {
is_spam: { type: "noul", instructions: "Is this message spam or a scam?" },
pushes_action: {
type: "noul",
instructions: "Does it push the reader to click, pay, or verify something?",
},
needs_review: {
type: "noul",
instructions: "Should a human moderator review this message?",
},
},
}),
});
// Illustrative response: answers.is_spam -> { noul: 0.97 },
// answers.needs_review -> { noul: 0.88 }심각도와 순서: score
레이블에 순서가 있을 때 — low / medium / high, 또는 P3에서 P0까지 — choice 대신 score 질문을 사용하세요. criteria는 낮은 것부터 나열한 레벨 설명 배열이고, 답변은 레벨 인덱스와 모든 레벨의 확률입니다.
레이블뿐 아니라 확신도로 행동하기
자동화를 안전하게 만드는 것은 확률 분포입니다. 합리적인 시작점: 확신도가 0.8 이상이면 레이블을 자동 적용하고, 미만이면 모두 사람 검토로 보냅니다. 임계값은 본인 데이터로 튜닝하세요 — 적절한 값은 잘못된 레이블의 비용에 따라 달라집니다.
자주 묻는 질문
질문 하나에 레이블을 몇 개까지 둘 수 있나요?
choice 질문은 2~8개 옵션, score 질문은 2~10개의 순서 있는 레벨을 받습니다. 한 호출에 최대 6개 질문을 보낼 수 있어 한 번의 호출로 여러 축을 따라 분류할 수 있습니다.
멀티 레이블 분류는 어떻게 하나요?
같은 state에 대해 레이블당 하나씩 noul 질문을 보내세요 — 호출당 최대 6개. 각 답변은 독립적인 '예' 확률이므로 하나의 입력에 임의의 레이블 조합을 플래그할 수 있습니다.
분류 호출 비용은 얼마인가요?
이 사이트에서 성공한 호출은 1개든 6개 질문이든 1 크레딧입니다. 검증 오류와 업스트림 실패는 무료입니다.
지금 무언가를 분류하세요
신규 방문자에게 1회 무료 체험 의사결정 — 본인 텍스트를 플레이그라운드에 붙여넣고 확률을 읽어보세요.