Karar API’si

Jev API

Tek bir POST durum ve sorularınızı gönderir. Yanıt, kodun dallanabileceği olasılıklı Noul, Choice veya Score’dur.

POST /api/v1/decisions

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}

Örnekler

Çalıştırabileceğiniz sekiz karar

İsteği görmek için kartın üzerine gelin. Kopyalayın veya playground’da açın.

Boş ödemeyi yönlendir

Choice sorumlu ekibi ve her ekibin olasılığını döner.

{
  "model": "jev-1.13",
  "state": "Checkout shows a blank page after Pay is clicked. The customer is on the live store, not a sandbox.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout, billing, or payment processing.",
        "frontend": "Rendering, layout, or browser behavior.",
        "account": "Login, permissions, or profile access."
      }
    }
  }
}
Playground’da aç

Bu bir iade isteği mi?

Noul, ayrıştırılacak bir paragraf değil, evet olasılığı döner.

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan this morning. Please send the extra charge back.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}
Playground’da aç

Ödeme hatası ne kadar acil

Score notu sizin ölçeğinize koyar ve dağılımı döner.

{
  "model": "jev-1.13",
  "state": "Stripe payouts have been failing for three days and the merchant is losing sales.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": [
        "Can wait for the next release",
        "Should be handled this week",
        "Blocking revenue right now"
      ]
    }
  }
}
Playground’da aç

Mesajda kimlik bilgisi isteği

Noul olasılığı, insan incelemesinden önceki kapıdır.

{
  "model": "jev-1.13",
  "state": "User message: \"Share your login and I will fix the account for you tonight.\"",
  "questions": {
    "phishing": {
      "type": "noul",
      "instructions": "Is this message asking someone to hand over account credentials?"
    }
  }
}
Playground’da aç

Gelen notu nitelendir

Choice satın alma penceresini salt ilgiden ayırır.

{
  "model": "jev-1.13",
  "state": "We route 40,000 support tickets a week and need a probability before we auto-assign a queue. Budget is approved this quarter.",
  "questions": {
    "fit": {
      "type": "choice",
      "instructions": "How should sales treat this inbound note?",
      "criteria": {
        "ready": "A real workflow, a volume, and a buying window.",
        "nurture": "Interest without a stated workflow or timeline.",
        "ignore": "No product fit."
      }
    }
  }
}
Playground’da aç

Garantili getiri ilanı

Noul, yazdığınız politika sorusunu yanıtlar.

{
  "model": "jev-1.13",
  "state": "Listing text: \"Guaranteed 30% returns every month. Send crypto to this wallet to join.\"",
  "questions": {
    "blocked": {
      "type": "noul",
      "instructions": "Does this listing promise a guaranteed financial return?"
    }
  }
}
Playground’da aç

Yenileme notundaki kayıp riski

Score, olası değil ile iptal olası arasında sizin üç düzeyinizi kullanır.

{
  "model": "jev-1.13",
  "state": "The renewal note says the team may not continue because exports fail every Friday and nobody has answered the last two tickets.",
  "questions": {
    "risk": {
      "type": "score",
      "instructions": "How high is the chance this account does not renew?",
      "criteria": [
        "Unlikely to leave",
        "Unhappy, still using the product",
        "Likely to cancel"
      ]
    }
  }
}
Playground’da aç

Hangi fatura istisnası

Choice, sipariş aşımı, beklenmeyen satır veya ikisini olasılıkla işaretler.

{
  "model": "jev-1.13",
  "state": "Vendor invoice 4481 is $18,400. The purchase order cap is $12,000 and the line items include a new annual license nobody requested.",
  "questions": {
    "exception": {
      "type": "choice",
      "instructions": "Which exception should accounts payable open?",
      "criteria": {
        "over_po": "The amount is above the purchase order.",
        "unexpected_item": "A line item was not requested.",
        "both": "The amount and a line item are both wrong."
      }
    }
  }
}
Playground’da aç

Yanıt

Kodun dallanabileceği yanıtlar

Jev ayrıştırılacak bir paragraf yazmaz. İstenen kararı ve olasılığını döner.

Her seçenek olasılığını korur

Choice kazananı söyler ve tanımladığınız her seçeneğin olasılığını da döner.

Tek çağrıda Noul, Choice ve Score

Evet/hayır, etiketli seçim ve ölçekteki konum aynı durumu paylaşabilir.

Sorular birlikte çalışır

Aynı duruma ek sorular yeni tur yerine o istekte kalır.

Eşik önemliyse modeli sabitleyin

Eşik ayarlarken jev-1.13 gönderin. jev-latest bu API’nin şu an sunduğu sürümü izler.

Nasıl kullanılır

Jev API nasıl çağrılır

  1. 01

    Anahtar oluşturun

    Giriş yapıp panodan anahtar kopyalayın. Playground oturum açmış hesap için bir tane oluşturabilir.

  2. 02

    Durum ve soruları POST edin

    Gövdede model, state ve soru haritası vardır. Kimlikler etikettir; soru metni instructions içindedir.

  3. 03

    Tipli yanıtta dallanın

    noul, choice veya score okuyun. Choice ve Score’da confidence seçeneklerin yakın olduğunu söyler.

Kullanım

Tipli kararın serbest istemin yerini aldığı yer

Destek yönlendirme

Bilet metnini ve gerçekten baktığınız kuyrukları gönderin. Kazanan ekibe dallanın veya olasılıklar yakınsa insana verin.

Güven ve moderasyon

Somut politika sorusunu sorun. Yüksek Noul tutar, düşük geçer, orta inceleme kuyruğuna gider.

Gelen nitelendirme

İş akışı ve satın alma penceresi olan notu, yalnızca ilgi gösteren nottan ayırın.

Fatura istisnaları

Borçlar ekibinin zaten kullandığı istisna adlarını kullanın.

İlk çağrılardan sonra

Yanıt tipli olunca ne değişir

Biletin iade olup olmadığını anlamak için paragraf ayrıştırmayı bıraktık. Dal, noul değeridir.
Destek sorumlusu
İki ekip yakınken confidence, tahmin etmek yerine bileti bir kişiye vermemizi söyledi.
Güven mühendisi
Puan düzeyleri bizim cümlelerimiz, bu yüzden yanıttaki açıklama kullandığımız rubrikle aynı.
Faturalama operasyonu

İstek ve yanıt hakkında sorular

Noul, Choice ve Score arasındaki fark nedir?

Noul olasılıklı evet/hayırdır. Choice adlandırdığınız seçeneklerden birini seçer ve her birinin olasılığını döner. Score durumu, en düşük önce olmak üzere ölçeğinize koyar.

Kazanamayan seçeneklerin olasılığı neden duruyor?

İkinci sıra, insana devretme sinyalidir. İki seçenek yakınsa kazananı kesin saymayın.

jev-1.13 mü jev-latest mi?

Kodunuzdaki eşik olasılıkların biçimine bağlıysa jev-1.13 sabitleyin. Bu API jev-latest kabul eder ve şu an aynı modele çözer.

state içine ne konur?

Bir dize, JSON nesnesi veya metin dizisi. Soruların ihtiyaç duyduğu olguları koyun, umduğunuz yanıtı değil.

confidence düşükse ne yapmalı?

Vakayı belirsiz sayın. Bir kişiye verin veya bir soru daha sorun. Bu yakın vakalara bakmadan eşiği düşürmeyin.

422 ne anlama gelir?

Gövde doğrulamadan geçmedi. Mesaj alanı söyler: eksik instructions, ikiden az Choice seçeneği, sırasız Score düzeyleri veya snake_case olmayan bir id.

İlk kararı gönderin

Bir örnekle playground’u açın veya Jev Docs’u izleyip kendi anahtarınızla endpoint’i çağırın.