Сценарий
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. Ошибки валидации и сбои апстрима бесплатны.
Классифицируйте что-нибудь сейчас
Одно бесплатное пробное решение для новых посетителей — вставьте свой текст в песочницу и прочитайте вероятности.