사용 사례

분류를 위한 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회 무료 체험 의사결정 — 본인 텍스트를 플레이그라운드에 붙여넣고 확률을 읽어보세요.