Keputusan

POST /v1/systemone mengevaluasi satu state terhadap pertanyaan bernama dan mengembalikan satu jawaban bertipe per pertanyaan. Responsnya adalah JSON sinkron: probabilitas, nama opsi, atau skor yang dapat dibandingkan dan dijadikan dasar percabangan oleh kode Anda. Ini tidak mengembalikan teks yang dihasilkan.

Keputusan atau chatCopy Anchor Link

Endpoint keputusan tidak menerima messages, tools, stream, atau kontrol chat lainnya, dan tidak tersedia dalam Batch. Jaga agar model chat utama Anda dikonfigurasi secara terpisah.

Pilih modelCopy Anchor Link

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

Anda juga dapat memfilter dengan category=decision. Baca GET /v1/models/{model} untuk model yang dipilih sebelum Anda mengirim permintaan, dan kirim ID model secara eksplisit. Contoh di halaman ini menggunakan jev-1.13.

Bentuk permintaanCopy Anchor Link

instructions dan setiap kriteria juga menerima string, objek JSON, atau array JSON. Permintaan menolak field yang tidak dikenal.

Evaluasi tiketCopy 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"]
      }
    }
  }'

Respons menyimpan nama pertanyaan Anda di bawah answers. Nilai di bawah ini bersifat ilustratif:

{
  "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}
}

Gunakan jawabanCopy Anchor Link

• Setiap pertanyaan mendapatkan jawaban dengan type yang sama, di bawah nama yang sama.
• Jawaban noul adalah probabilitas, bukan Boolean. Pilih ambang batas Anda sendiri untuk setiap tindakan.
• Jawaban choice selalu merupakan salah satu nama opsi yang Anda kirim.
• Jawaban score mengindeks array criteria Anda: 1 di atas berarti "Money affected".
• Uji keputusan terhadap kasus berlabel Anda sendiri sebelum keputusan tersebut memicu pengembalian dana, eskalasi, atau tindakan lainnya.

Gunakan dari MCPCopy Anchor Link

Server MCP TokenLab mengekspos evaluate_decisions dalam profil core dan full. Panggil list_models dengan {"category":"decision"} dan get_model terlebih dahulu, lalu teruskan model, state, dan questions yang sama sebagai argumen alat. Baca structuredContent.answers dan structuredContent.usage dari hasilnya. Alat ini mengembalikan hasil sinkron dan tidak menggunakan polling tugas asinkron.

Gunakan dari SDKCopy Anchor Link

SDK JavaScript TokenLab 0.1.2+ menyediakan evaluateDecisions(body); SDK Python 0.1.2+ menyediakan evaluate_decisions(body). Body-nya adalah JSON yang sama dengan permintaan HTTP. Keduanya mempertahankan jawaban bertipe dan penggunaan serta tidak secara otomatis memutar ulang permintaan yang gagal. Lihat SDK.

Biaya dan percobaan ulangCopy Anchor Link

• Keputusan dikenakan biaya berdasarkan token, dari usage.input_tokens dan usage.output_tokens dalam respons, sesuai harga token model saat ini.
• Harga dapat berubah. Baca detail harga model atau API Harga alih-alih melakukan hard-coding harga.
• Model dapat melaporkan token output bahkan ketika harga outputnya nol.
• Permintaan mengikuti opsi pengiriman Anda. Lihat Penagihan dan harga.
• Timeout membuat hasil menjadi tidak pasti. Periksa permintaan di log atau Konsol Anda sebelum mengirim permintaan berbayar lagi.

Kesalahan UmumCopy Anchor Link

Referensi APICopy Anchor Link