Сценарий

Decisions API для классификации

Классификация — это выбор конечной метки для входа, а именно это эндпоинт решений и делает нативно. Вместо извлечения метки из сгенерированного текста вы заранее определяете метки и получаете победителя плюс вероятность для каждого варианта.

Обновлено

Когда подходят конечные метки

Вызов решения подходит всегда, когда вашему коду нужен один из известного набора ответов: категории тикетов, вердикты модерации, метки интентов, типы документов. Если человек выбирал бы из фиксированного списка, вопрос choice — это прямой перевод.

Если метки не ограничены — каждый вход может стать новой категорией — классификация не подходит: вам нужна генерация. Оптимум — замкнутый набор, который можно назвать и описать.

  • Категории тикетов поддержки: billing, bug, account, other
  • Вердикты модерации: spam, safe, needs review
  • Метки интентов: refund, cancel, change plan, question

Одна метка: один вопрос choice

Для однометочной классификации отправьте один вопрос choice, чьи criteria сопоставляют каждую метку с коротким описанием. Всегда добавляйте вариант 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 в одном вызове

Мультиметочная классификация — когда несколько тегов могут быть истинны одновременно — отображается на несколько вопросов noul по одному state. Каждый вопрос 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 — используйте вопрос score вместо choice. criteria — это массив описаний уровней, начиная с самого низкого, а ответ — индекс уровня плюс вероятности для каждого уровня.

Действуйте по уверенности, а не только по метке

Безопасной автоматизацию делает распределение вероятностей. Разумная отправная точка: применять метку автоматически при уверенности 0.8 и выше, а всё ниже отправлять на проверку человеку. Подберите порог на своих данных — правильное значение зависит от цены неверной метки.

Частые вопросы

Сколько меток может быть в одном вопросе?

Вопрос choice принимает от 2 до 8 вариантов, вопрос score — от 2 до 10 упорядоченных уровней. В одном вызове можно отправить до 6 вопросов, так что один вызов может классифицировать сразу по нескольким осям.

Как сделать мультиметочную классификацию?

Отправьте по одному вопросу noul на метку по одному state — до 6 за вызов. Каждый ответ — независимая вероятность «да», так что вход может быть помечен любой комбинацией меток.

Сколько стоит вызов классификации?

1 кредит за успешный вызов на этом сайте, независимо от того, задан 1 вопрос или 6. Ошибки валидации и сбои апстрима бесплатны.

Классифицируйте что-нибудь сейчас

Одно бесплатное пробное решение для новых посетителей — вставьте свой текст в песочницу и прочитайте вероятности.