انتقل إلى المحتوى
أجوبة محددة الأنواع مع احتمالات: نداء واحد بسؤالين، احتمال نعم أو لا، وخيار مع ثقته.

أجوبة محددة الأنواع مع احتمالات من API نموذج واحدة

, 3 دقائق قراءة, By Jaber Jaber

هندسة

تقبل API نموذج القرار RightNow النص وحالة JSON (حالة الروبوت) والصور والصوت و PDF والفيديو (معاينة)، وتعيد أجوبة محددة الأنواع مع احتمالاتها.

يتخذ RightNow decision model قرارات منظمة: أرسل حالة وأسئلة مسماة، ثم اقرأ الاحتمالات والثقة والأجوبة المحددة الأنواع. يعود كل جواب تحت اسم سؤاله: احتمال نعم أو لا بين 0 و 1، أو الخيار المختار مع ثقته واحتمال كل خيار.

ما هو نموذج القرار؟

يزوج القرار حالتك بأسئلة مسماة ويعيد كل نتيجة تحت اسمها. الحالة إما نص أو كائن JSON أو مصفوفة JSON.

يمكن لحالة JSON وصف حالة روبوت، مثلا {"battery_percent":80,"moving":false}. أرسل الأكواد نصا داخل state.

لكل سؤال اسم و type و instructions. طالع القرارات، أو اقرأ تقديم RightNow decision model.

ماذا يمكنك أن ترسل؟

مدخل مضمّن: نص، حالة JSON (حالة الروبوت)، صور، صوت، PDF، فيديو (معاينة). لا تدعم إلا الصيغ المذكورة.

يُرسل الملف عنصرا داخل state. أرسل الصورة data URL بصيغة PNG أو JPEG، و PDF بصيغة data URL مع اسمه، والفيديو data URL بصيغة MP4، والصوت بيانات WAV بصيغة base64 مع صيغته. طالع المدخلات.

ما الذي يعود؟

يحمل answers جوابا واحدا لكل سؤال، تحت اسم السؤال. جواب noul احتمال نعم أو لا، بين 0 و 1. وجواب choice هو الخيار المختار، مع confidence له بين 0 و 1 واحتمال كل خيار في probabilities. و usage.cost هو تكلفة النداء.

نداء واحد بسؤالين محددي النوع. تقول الحالة إن الطلب 1234 يطلب استردادا بعد 45 يوما من التسليم، وأن السياسة تجيز 30 يوما. يعود سؤال نعم أو لا refund_allowed احتمالا بين 0 و 1. ويعود سؤال الخيار next_step بأحد approve أو deny أو escalate، مع ثقته واحتمال لكل خيار.
شكل الرد. كل نوع يقوم مقام قيمة. نادِه بمفتاحك

كيف تناديه؟

ينادي مفتاح من صفحة مفاتيح API نموذج القرار RightNow على العنوان الأساس نفسه الذي تنادي به كل نموذج مفتوح. بمفتاح من صفحة مفاتيح API، نادِ POST /v1/decisions. أرسل rightnow-decision كقيمة model. استخدم الاسم المستعار لتتبع النموذج الحالي، أو معرفا مثبتا لاختيار إصدار.

Shell
curl https://api.rightnowai.co/v1/decisions \
  -H "Authorization: Bearer $RIGHTNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "rightnow-decision",
    "state": "Order 1234: the customer asks for a refund 45 days after delivery. The policy allows 30 days.",
    "questions": {
      "refund_allowed": {"type": "noul", "instructions": "Is the refund allowed under the policy?"},
      "next_step": {"type": "choice", "instructions": "What should support do next?",
        "options": ["approve", "deny", "escalate"]}
    }
  }'
A call with your key. Call it with your key

اضبط RIGHTNOW_API_KEY في العملية التي تجري النداء. أبق المفتاح على خادمك ونادِ عبر HTTPS. طالع دليل البدء السريع.

كم يكلف؟

مع RightNow decision model تدفع على المدخل والأسئلة المجابة والنداء المجاب.

Uncached text input costs USD 0.19 per million input tokens, and cached text input USD 0.019. Each answered question costs USD 0.0001, and each answered call USD 0.00001. Output is free.

النداء بملف يكلف سعر النص ورسم كل ملف على بطاقة الأسعار. الأسئلة المرفوضة لا تحتسب. طالع التسعير.

أين الحدود؟

تدعم حالة النص القياسية حتى 38,000 رمز. بمفتاح من صفحة مفاتيح API، الصوت WAV فقط ويحمل النداء 32 سؤالا على الأكثر.

الصوت محدود بمدة 60 ثانية لكل طلب. أرسل حتى 4 صور لكل طلب. يمكن لملف PDF أن يصل إلى 500 صفحة. أرسل فيديو MP4 بصيغة H.264 صامتا حتى 10 ثوان، من دون ملفات أخرى.

calibrated هي false في هذا الإصدار.

لكل مفتاح من صفحة مفاتيح API حدوده الخاصة في الدقيقة: اقرأ X-RateLimit-Limit على ردوده. طالع المدخلات و الحدود.

أجوبة قصيرة

أي نوع سؤال أستخدم؟

noul احتمال نعم أو لا. على نداء نصي، يقبل choice من 2 إلى 10 options و score من 2 إلى 4 levels.

أأرسل ملفات؟

نعم. أرسل الملفات مضمّنة. لا تتوفر إلا الصيغ المذكورة.

أي معرف نموذج أرسل؟

أرسل rightnow-decision. لتثبيت إصدار، استخدم rightnow-decision-3.0.0.

كيف أحصل على مفتاح؟

أنشئ مفتاحا مسمى تحت مفاتيح API، في مساحة عمل نشطة. ينتمي المفتاح إلى مساحة عمله ولا يظهر إلا مرة واحدة.

هل تحتسب الأسئلة المرفوضة؟

لا. الطلب المرفوض كله لا يتحمل رسم نص ولا سؤال ولا ملف ولا نداء.