Decisions API ile istek yönlendirme

Yönlendirme neden doğal uyuyor

Yönlendirme sonlu bir soru sorar — kuyruklarımdan hangisi bunu üstlenir — ve bu tam olarak bir karar uç noktasının doğal olarak yanıtladığı şeydir. Üretilmiş metinden kuyruk adı ayrıştırmak ya da beşinci bir kuyruk icat etmesini engelleyecek prompt mühendisliği gerekmez.

Aynı çağrı, aynı ticket için birden fazla soru taşıyabilir: kuyruk, aciliyet ve inceleme gerektiren bayrak tek gidiş-dönüşte 1 krediye çözülür.

• Kuyruk ataması: billing, platform, account, other
• Öncelik: düşükten bloklayana sıralı bir score
• Eskalasyon: insanın önce bakıp bakmayacağına dair noul kontrolü

Criteria'yı kuyruk açıklamaları olarak yazın

Bir choice sorusundaki her seçenek, oraya neyin ait olduğunun kısa açıklamasını taşır. Yeni bir triyaj analistine brifing verir gibi yazın — bu açıklamalar sizin yönlendirme politikanızdır.

Her zaman bir 'other' ya da 'unclear' seçeneği ekleyin. Modele dürüst bir çıkış vermek, belirsiz ticket'ların güvenli görünümlü yanlış yönlendirilmesini önler.

Tek çağrı: kuyruk artı aciliyet

Ticket metnini state olarak gönderin ve iki soru sorun: sorumlu ekibi seçen choice ve aciliyeti ölçen score. Yanıt answers.team.choice, answers.urgency.score ve her iki sorudaki tüm seçeneklerin olasılığını içerir.

// Route a ticket: ask for team + urgency in one call,
// then gate the automation on confidence.
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: "Payments fail with a 500 since your last deploy. Enterprise plan customer.",
    questions: {
      team: {
        type: "choice",
        instructions: "Which queue should handle this request?",
        criteria: {
          payments: "Billing, charges, or payment failures.",
          platform: "Deploys, infrastructure, or API errors.",
          account: "Login, SSO, or permissions.",
          other: "Unclear or out of scope.",
        },
      },
      urgency: {
        type: "score",
        instructions: "How urgent is this for the customer?",
        criteria: ["can wait", "normal queue", "needs attention today", "blocking revenue"],
      },
    },
  }),
});
const { answers } = await res.json();

// Illustrative response: answers.team -> { choice: "payments", confidence: 0.84 }
//                        answers.urgency -> { score: 3, confidence: 0.79 } (0 = lowest level)
if (answers.team.confidence >= 0.8 && answers.team.choice !== "other") {
  assignToQueue(answers.team.choice, { priority: answers.urgency.score });
} else {
  assignToQueue("human_triage", { note: "low confidence" });
}

Otomatik atamayı confidence'a bağlayın

Olasılık dağılımı, yönlendirmeyi otomatikleştirmeyi güvenli kılar. Çalışılabilir bir varsayılan: confidence 0.8 ve üzerindeyse yönlendirmeyi uygulayın, altındakini insan triyaj kuyruğuna gönderin.

Eşiği kendi ticket geçmişinize göre ayarlayın — doğru değer, yanlış yönlendirilen ticket'ın gecikmiş bir ticket'a oranla maliyetine bağlıdır.

İstekleri modeller arasında yönlendirin

Aynı desen hangi modelin yanıtlayacağını da seçer. fast_model (kısa olgusal ya da biçimlendirme istekleri), strong_model (çok adımlı akıl yürütme, kod, uzun bağlam) ve human (hukuk, iade ya da bir modelin tek başına yanıtlamaması gereken her şey) gibi seçeneklerle bir choice sorusu sorun. Her seçenek bir olasılıkla döner — atamanın ne kadar çekişmeli olduğunu görürsünüz.

Aynı şekilde eşikleyin: güven düşükken, en üstteki seçeneğe güvenmek yerine isteği bir insana veya daha güvenli bir yola yönlendirin — ikinci seçeneğin olasılığı kararın ne kadar yakın olduğunu gösterir.

Maliyet ve hacim

Başarılı bir çağrı 1 kredidir — 1 ya da 6 soru sorsanız da. Geçmiş ticket yığını için paneldeki batch aracı aynı istek biçimini CSV veya JSONL üzerinde çalıştırır.

SSS