Kararlar

POST /v1/systemone, bir state değerini adlandırılmış sorulara göre değerlendirir ve soru başına bir tipli yanıt döndürür. Yanıt senkron bir JSON'dır: kodunuzun karşılaştırabileceği ve dallanabileceği bir olasılık, seçenek adı veya puan. Üretilmiş metin döndürmez.

Kararlar mı, sohbet mi?Copy Anchor Link

Karar uç noktası messages, tools, stream veya diğer sohbet kontrollerini kabul etmez ve Batch içinde kullanılamaz. Ana sohbet modelinizi ayrı olarak yapılandırılmış halde tutun.

Bir model seçinCopy Anchor Link

curl "https://api.tokenlab.sh/v1/models?recommended_for=decision" \
  -H "Authorization: Bearer sk-your-api-key"

Ayrıca category=decision ile filtreleme yapabilirsiniz. İstek göndermeden önce seçilen model için GET /v1/models/{model} uç noktasını okuyun ve model kimliğini (ID) açıkça gönderin. Bu sayfadaki örnekler jev-1.13 kullanmaktadır.

İstek yapısıCopy Anchor Link

instructions ve her kriter ayrıca bir string, JSON nesnesi veya JSON dizisi kabul eder. İstek, bilinmeyen alanları reddeder.

Bir destek talebini değerlendirinCopy Anchor Link

curl https://api.tokenlab.sh/v1/systemone \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-1.13",
    "state": "I was charged twice. Please refund the duplicate payment.",
    "questions": {
      "refund_requested": {"type": "noul", "instructions": "Is a refund requested?"},
      "department": {
        "type": "choice", "instructions": "Which team should handle this?",
        "criteria": {"refunds": "Charges and refunds", "technical": "Software bugs"}
      },
      "urgency": {
        "type": "score", "instructions": "Rate urgency",
        "criteria": ["Routine enquiry", "Money affected", "Safety emergency"]
      }
    }
  }'

Yanıt, soru adlarınızı answers altında tutar. Aşağıdaki değerler örnektir:

{
  "model": "jev-1.13",
  "answers": {
    "refund_requested": {"type": "noul", "noul": 0.97},
    "department": {"type": "choice", "choice": "refunds"},
    "urgency": {"type": "score", "score": 1}
  },
  "usage": {"input_tokens": 96, "output_tokens": 12}
}

Yanıtları kullanmaCopy Anchor Link

• Her soru, aynı isim altında ve aynı type değerinde bir yanıt alır.
• Bir noul yanıtı bir Boolean değil, bir olasılıktır. Her işlem için kendi eşik değerinizi seçin.
• Bir choice yanıtı her zaman gönderdiğiniz seçenek adlarından biridir.
• Bir score yanıtı criteria dizinizi indeksler: yukarıdaki 1 değeri 'Money affected' anlamına gelir.
• Kararları iadeleri, yükseltmeleri veya diğer işlemleri tetiklemeden önce kendi etiketli vakalarınızla test edin.

MCP üzerinden kullanmaCopy Anchor Link

TokenLab MCP sunucusu, core ve full profillerinde evaluate_decisions işlevini sunar. Önce {"category":"decision"} ile list_models ve get_model çağrılarını yapın, ardından aynı model, state ve questions değerlerini araç argümanları olarak geçin. Sonuçtan structuredContent.answers ve structuredContent.usage değerlerini okuyun. Araç senkron bir sonuç döndürür ve asenkron görev yoklaması (polling) kullanmaz.

SDK'lar üzerinden kullanmaCopy Anchor Link

TokenLab JavaScript SDK 0.1.2+ sürümü evaluateDecisions(body) işlevini; Python SDK 0.1.2+ sürümü ise evaluate_decisions(body) işlevini sağlar. Gövde (body), HTTP isteğiyle aynı JSON yapısındadır. Her ikisi de tipli yanıtları ve kullanım verilerini korur ve başarısız bir isteği otomatik olarak tekrar oynatmaz. Bkz. SDK'lar.

Maliyet ve yeniden denemelerCopy Anchor Link

• Kararlar, yanıttaki usage.input_tokens ve usage.output_tokens değerleri üzerinden, modelin güncel token fiyatlarıyla ücretlendirilir.
• Fiyatlar değişebilir. Fiyatı kodunuza sabit yazmak yerine modelin fiyatlandırma detaylarını veya Fiyatlandırma API'sini okuyun.
• Bir model, çıktı fiyatı sıfır olsa bile çıktı token'larını raporlayabilir.
• İstekler teslimat seçeneğinizi takip eder. Bkz. Faturalandırma ve fiyatlandırma.
• Zaman aşımı, sonucun belirsiz kalmasına neden olur. Ücretli bir istek göndermeden önce günlüklerinizden veya Konsoldan isteği kontrol edin.

Yaygın HatalarCopy Anchor Link

API ReferansıCopy Anchor Link