Kullanım örneği
Sınıflandırma için Decisions API
Sınıflandırma, bir girdi için sonlu bir etiket seçme işidir — ki bu tam olarak bir karar uç noktasının doğal olarak yaptığı şeydir. Üretilmiş metinden etiket ayrıştırmak yerine etiketleri önceden tanımlar, kazananı ve her seçenek için bir olasılık alırsınız.
Güncellendi
Sonlu etiketler ne zaman uygun
Alt akış kodunuz bilinen bir yanıt kümesinden birine ihtiyaç duyduğunda karar çağrısı uygundur: ticket kategorileri, moderasyon kararları, niyet etiketleri, belge türleri. Bir insan sabit bir listeden seçecekse, choice sorusu bunun doğrudan karşılığıdır.
Etiketleriniz sınırsızsa — her girdi yeni bir kategori olabilirse — sınıflandırma doğru biçim değildir; üretim istersiniz. İdeal nokta, adlandırıp tanımlayabileceğiniz kapalı bir kümedir.
- Destek ticket kategorileri: billing, bug, account, other
- İçerik moderasyon kararları: spam, safe, needs review
- Niyet etiketleri: refund, cancel, change plan, question
Tek etiket: bir choice sorusu
Tek etiketli sınıflandırma için, her etiketi kısa bir açıklamayla eşleyen criteria'ya sahip bir choice sorusu gönderin. Her zaman bir 'other' veya 'unclear' seçeneği ekleyin — modele dürüst bir çıkış vermek, sınırda girdilerin yanlış gruba düşmesini önler.
Tek etiketli 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 }Çok etiketli: tek çağrıda noul soruları
Aynı anda birden fazla etiketin doğru olabildiği çok etiketli sınıflandırma, aynı state üzerindeki birden fazla noul sorusuna karşılık gelir. Her noul sorusu bir etiket için evet olasılığıdır ve tek çağrıda aynı 1 krediyle en fazla 6 soru paketleyebilirsiniz.
Çok etiketli noul toplu işi
// 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 }Önem derecesi ve sıralama: score
Etiketler sıralı olduğunda — low / medium / high veya P3'ten P0'a — choice yerine score sorusu kullanın. criteria, en düşükten başlayan seviye açıklamaları dizisidir ve yanıt, bir seviye indeksi artı her seviye için olasılıklardır.
Sadece etikete değil, güvene göre hareket edin
Otomasyonu güvenli kılan olasılık dağılımıdır. Makul bir başlangıç noktası: güven 0.8 veya üzeri olduğunda etiketi otomatik uygulayın, altındakileri insan incelemesine gönderin. Eşiği kendi verinizle ayarlayın — doğru değer yanlış etiketin maliyetine bağlıdır.
SSS
Bir soru kaç etiket içerebilir?
Bir choice sorusu 2–8 seçenek, bir score sorusu 2–10 sıralı seviye alır. Çağrı başına en fazla 6 soru gönderebilirsiniz, böylece tek çağrı aynı anda birkaç eksende sınıflandırma yapabilir.
Çok etiketli sınıflandırmayı nasıl yaparım?
Aynı state üzerinde etiket başına bir noul sorusu gönderin — çağrı başına en fazla 6. Her yanıt bağımsız bir evet olasılığıdır, yani bir girdi herhangi bir etiket kombinasyonuyla işaretlenebilir.
Bir sınıflandırma çağrısı ne kadar?
Bu sitede başarılı çağrı başına 1 kredi — 1 veya 6 soru sormanız fark etmez. Doğrulama hataları ve upstream hataları ücretsizdir.
Şimdi bir şeyi sınıflandırın
Yeni ziyaretçilere bir ücretsiz deneme kararı — kendi metninizi oyun alanına yapıştırın ve olasılıkları okuyun.