
أجوبة محددة الأنواع مع احتمالات من API نموذج واحدة
, 3 دقائق قراءة, By Jaber Jaber
هندسةتقبل API نموذج القرار RightNow النص وحالة JSON (حالة الروبوت) والصور والصوت و PDF والفيديو (معاينة)، وتعيد أجوبة محددة الأنواع مع احتمالاتها.
يتخذ RightNow decision model قرارات منظمة: أرسل حالة وأسئلة مسماة، ثم اقرأ الاحتمالات والثقة والأجوبة المحددة الأنواع. يعود كل جواب تحت اسم سؤاله: احتمال نعم أو لا بين 0 و 1، أو الخيار المختار مع ثقته واحتمال كل خيار.
ما هو نموذج القرار؟
يزوج القرار حالتك بأسئلة مسماة ويعيد كل نتيجة تحت اسمها. الحالة إما نص أو كائن JSON أو مصفوفة JSON.
يمكن لحالة JSON وصف حالة روبوت، مثلا {"battery_percent":. أرسل الأكواد نصا داخل 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 هو تكلفة النداء.

كيف تناديه؟
ينادي مفتاح من صفحة مفاتيح API نموذج القرار RightNow على العنوان الأساس نفسه الذي تنادي به كل نموذج مفتوح. بمفتاح من صفحة مفاتيح API، نادِ POST /v1/decisions. أرسل rightnow-decision كقيمة model. استخدم الاسم المستعار لتتبع النموذج الحالي، أو معرفا مثبتا لاختيار إصدار.
اضبط 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، في مساحة عمل نشطة. ينتمي المفتاح إلى مساحة عمله ولا يظهر إلا مرة واحدة.
هل تحتسب الأسئلة المرفوضة؟
لا. الطلب المرفوض كله لا يتحمل رسم نص ولا سؤال ولا ملف ولا نداء.