Decisions API para classificação

Quando rótulos finitos se encaixam

Uma chamada de decisão se encaixa sempre que seu código precisa de uma resposta de um conjunto conhecido: categorias de tickets, veredictos de moderação, rótulos de intenção, tipos de documento. Se um humano escolheria de uma lista fixa, uma pergunta choice é a tradução direta.

Se seus rótulos são ilimitados — cada entrada poderia ser uma categoria nova — classificação não é a forma certa; você quer geração. O ponto ideal é um conjunto fechado que você consegue nomear e descrever.

• Categorias de tickets de suporte: billing, bug, account, other
• Veredictos de moderação de conteúdo: spam, safe, needs review
• Rótulos de intenção: refund, cancel, change plan, question

Rótulo único: uma pergunta choice

Para classificação de rótulo único, envie uma pergunta choice cujos criteria mapeiam cada rótulo a uma descrição curta. Sempre inclua uma opção 'other' ou 'unclear' — dar ao modelo uma saída honesta mantém entradas ambíguas fora do balde errado.

// 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 }

Multi-rótulo: perguntas noul em uma chamada

Classificação multi-rótulo — onde várias tags podem ser verdadeiras ao mesmo tempo — mapeia para várias perguntas noul sobre o mesmo state. Cada pergunta noul é uma probabilidade de sim para um rótulo, e você pode empacotar até 6 perguntas em uma única chamada pelo mesmo 1 crédito.

// 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 }

Severidade e ordenação: score

Quando os rótulos são ordenados — low / medium / high, ou de P3 a P0 — use uma pergunta score em vez de choice. Os criteria são um array de descrições de nível, do mais baixo primeiro, e a resposta é um índice de nível mais probabilidades para cada nível.

Aja pela confiança, não só pelo rótulo

A distribuição de probabilidade é o que torna a automação segura. Um ponto de partida razoável: aplique o rótulo automaticamente quando a confiança for 0.8 ou maior, e envie tudo abaixo disso para revisão humana. Ajuste o limite com seus próprios dados — o valor certo depende do custo de um rótulo errado.

Perguntas frequentes