القرارات

POST /v1/systemone يقوم بتقييم state واحد مقابل أسئلة مسماة ويعيد إجابة واحدة محددة النوع لكل سؤال. الاستجابة عبارة عن JSON متزامن: احتمال، أو اسم خيار، أو نتيجة (score) يمكن للكود الخاص بك مقارنتها والتفرع بناءً عليها. لا يعيد هذا الطلب نصاً مولداً.

القرارات أم الدردشةCopy Anchor Link

لا تقبل نقطة نهاية القرار messages أو tools أو stream أو عناصر تحكم الدردشة الأخرى، وهي غير متاحة في Batch. احتفظ بنموذج الدردشة الرئيسي الخاص بك مهيأً بشكل منفصل.

اختر نموذجاًCopy Anchor Link

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

يمكنك أيضاً التصفية باستخدام category=decision. اقرأ GET /v1/models/{model} للنموذج المحدد قبل إرسال الطلبات، وأرسل معرف النموذج بشكل صريح. تستخدم الأمثلة في هذه الصفحة jev-1.13.

شكل الطلبCopy Anchor Link

تقبل instructions وكل معيار أيضاً سلسلة نصية أو كائن JSON أو مصفوفة JSON. يرفض الطلب الحقول غير المعروفة.

تقييم تذكرةCopy 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"]
      }
    }
  }'

تحتفظ الاستجابة بأسماء أسئلتك تحت answers. القيم أدناه توضيحية:

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

استخدام الإجاباتCopy Anchor Link

• يحصل كل سؤال على إجابة من نفس type، تحت نفس الاسم.
• إجابة noul هي احتمال، وليست قيمة منطقية (Boolean). اختر حدك الخاص لكل إجراء.
• إجابة choice هي دائماً أحد أسماء الخيارات التي أرسلتها.
• إجابة score تقوم بفهرسة مصفوفة criteria الخاصة بك: 1 أعلاه تعني "تأثر الأموال".
• اختبر القرارات مقابل حالاتك المصنفة الخاصة قبل أن تؤدي إلى استرداد الأموال أو التصعيد أو إجراءات أخرى.

الاستخدام من MCPCopy Anchor Link

يكشف خادم TokenLab MCP عن evaluate_decisions في ملفات تعريف core و full. استدعِ list_models مع {"category":"decision"} و get_model أولاً، ثم مرر نفس model و state و questions كمعاملات للأداة. اقرأ structuredContent.answers و structuredContent.usage من النتيجة. تعيد الأداة نتيجة متزامنة ولا تستخدم استطلاع المهام غير المتزامنة (async task polling).

الاستخدام من SDKsCopy Anchor Link

توفر مكتبة TokenLab JavaScript SDK 0.1.2+ الدالة evaluateDecisions(body)؛ وتوفر Python SDK 0.1.2+ الدالة evaluate_decisions(body). الجسم (body) هو نفس JSON الخاص بطلب HTTP. كلاهما يحافظ على الإجابات محددة النوع والاستخدام ولا يعيد تشغيل الطلب الفاشل تلقائياً. انظر SDKs.

التكلفة وإعادة المحاولةCopy Anchor Link

• يتم محاسبة القرارات بالرموز (tokens)، من usage.input_tokens و usage.output_tokens في الاستجابة، وفقاً لأسعار الرموز الحالية للنموذج.
• الأسعار قابلة للتغيير. اقرأ تفاصيل تسعير النموذج أو Pricing API بدلاً من كتابة السعر بشكل ثابت (hard-coding).
• يمكن للنموذج الإبلاغ عن رموز الإخراج حتى عندما يكون سعر الإخراج صفراً.
• تتبع الطلبات خيار التسليم الخاص بك. انظر الفواتير والتسعير.
• مهلة زمنية (timeout) تجعل النتيجة غير مؤكدة. تحقق من الطلب في سجلاتك أو وحدة التحكم (Console) قبل إرسال طلب مدفوع مرة أخرى.

الأخطاء الشائعةCopy Anchor Link

مرجع APICopy Anchor Link