Nace.AI: Drex v1.5

يقيّم Drex 1.5 النص أو JSON المقدّم وفق أسئلة محددة النوع، ويعيد احتمالات أو تسمية مختارة أو درجة كسرية وفق معايير تقييم. توثّق Nace.AI قرارات نصية فقط للتصنيف والتوجيه وترتيب الأولويات، مع حدود للحالة والطلب خاصة بكل إصدار.

Ailoot Ultra · System One POST /v1/systemone nace-ai/drex-v1.5

عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

Drex 1.5 هو نموذج القرارات النصية من Nace.AI. يقيّم الحقائق المقدّمة وفق أسئلة مغلقة ويعيد إجابات عددية محددة النوع بدلًا من استجابة مكتوبة مفتوحة. يجمع الطلب حالة واحدة مع أسئلة مسماة، وتعرّف النتيجة كل إجابة باستخدام اسم السؤال نفسه. يمنح ذلك سير العمل فئة ملموسة أو احتمالًا أو موضعًا على مقياس تقييم لاستخدامه، مع ترك الإجراء المتخذ بناءً على النتيجة للتطبيق.

إعداد الحالة

الحالة هي المعلومات التي تتعلق بها جميع الأسئلة. يقبل Drex قيمة JSON من نوع سلسلة نصية أو كائن أو مصفوفة أو عدد أو قيمة منطقية أو null، وحقل state إلزامي. قدّم أدلة ذات معنى حتى لو اجتازت null التحقق لدى الجهة المنتجة. تلائم السلسلة النصية رسالةً أو مستندًا أو تفريغًا نصيًا؛ ويلائم الكائن حقائق منظّمة مسبقًا في حقول. احتفظ بالمعلومات التي تؤثر في القرار، واحذف الحقول غير ذات الصلة عندما تكون المادة طويلة. حافظ على تنسيق مدخلات ثابت عند تفسير عتبات الاحتمالات، لأن تغيير التمثيل يمكن أن يغيّر الإجابة.

يقرأ Drex 1.5 النص فقط. ترفض الواجهة الموثّقة الصور والصوت والفيديو ومحتوى PDF داخل الحالة أو الأسئلة، بما في ذلك الوسائط المرمّزة وكائنات محتوى الوسائط. جهّز وصفًا للصورة أو نص مستند مستخرجًا بالتعرّف أو تفريغًا نصيًا قبل استخدام تلك المادة دليلًا. العنوان النصي ليس مستندًا أو صورة جرى جلبهما: لا يستطيع النموذج فتحه. بالنسبة إلى طلب دعم، الحالة المفيدة هي الرسالة الفعلية والسياق ذي الصلة، لا إشارة إلى مادة لم يتلقها النموذج.

احتمال نعم/لا أو اختيار أو درجة

يسأل سؤال noul عما إذا كان شرط ما متحققًا ويعيد عددًا من 0 إلى 1 يمثل الاحتمال المقدّر لنعم. عرّف السؤال بتعليمات غير فارغة أو بمعيار واحد غير فارغ على الأقل لـtrue/false. على سبيل المثال، اسأل عما إذا كانت رسالة تبلغ عن ميزة معطلة وحدّد ما إذا كان البطء يُحتسب عطلًا. لا يفرض Drex عتبة نعم/لا مدمجة؛ بل يختار سير العمل المستهلك كيفية تفسير الاحتمال.

يختار سؤال choice تسمية واحدة مقدّمة من مجموعة غير مرتبة ويعيد احتمالًا لكل تسمية. المعايير كائن تمثل مفاتيحه التسميات المُعادة، ويكون كل وصف سلسلة نصية أو null. استخدم مفاتيح قصيرة وثابتة وصِف حدود الفئات بوضوح. يمكن لمهمة توجيه توضيحية التمييز بين مشكلة وصول وعيب في المنتج وسؤال عام، مع فئة other للرسائل التي لا تلائمها. تفيد التسمية المختارة في التوجيه؛ ويساعد التوزيع في تحديد الحالات التي يظل فيها فصل خيارين صعبًا.

يستخدم سؤال score مصفوفة مرتبة من تسميات المستويات. تبدأ الفهارس عند 0، وتساوي الدرجة المُعادة مجموع حاصل ضرب فهرس كل مستوى في احتماله. لذلك يمكن أن تقع بين المستويات المسماة. بالنسبة إلى مقياس خطورة، عرّف ما يميّز مشكلة شكلية، ومشكلة لها حل بديل، ومهمة معطلة بالكامل. تتضمن النتيجة مفتاح المستويات التوضيحي واحتمالاتها إلى جانب الدرجة المتوقعة. احتفظ بالدرجة الكسرية لحساب المتوسطات أو الاتجاهات؛ فاختيار المستوى الأكثر احتمالًا وتقريب الدرجة المتوقعة يجيبان عن سؤالين مختلفين.

الأدلة المشتركة وقراءة النتيجة

تسمح الجهة المنتجة بسؤال واحد إلى 512 سؤالًا عن الحالة نفسها. امنح كل سؤال معرّفًا غير فارغ وذا معنى، مثل category أو severity، حتى يمكن فهم الإجابة المقابلة دون الرجوع إلى سؤال مرقّم. افصل الجوانب المستقلة في أسئلتها الخاصة بدلًا من جمع عدة متطلبات في معيار واحد غير واضح. يمكن لرسالة واحدة دعم اختيار فئة ودرجة خطورة وفحص شرط، مع احتفاظ كل منها بمعناه الخاص.

تتضمن إجابات choice وscore الثقة بصورة منفصلة عن توزيعاتها الاحتمالية. وتفرّق الجهة المنتجة صراحةً بين الثقة وأعلى احتمال لخيار؛ فلا تحسب إحداهما من الآخر. لقرار نعم/لا، احتفظ بالاحتمال الخام مع النتيجة المختارة. وللاختيار غير اليقيني، افحص الاحتمالات المتنافسة بدلًا من اعتبار التسمية الفائزة وحدها دليلًا على اليقين. حدّد عتبات المراجعة وفق عواقب نتيجة إيجابية أو سلبية خاطئة، واستخدم حالات موسومة تمثيلية لتقييمها.

الإصدار وحدود الحجم

يوثّق Drex 1.5 حدًا للحالة من 131,072 رمزًا وحدًا للصف من 139,264 رمزًا. يتعلق حد الصف بالحالة مع أطول سؤال منفرد، بما يشمل تعليماته وخياراته؛ ولا يعني مجموع كل الأسئلة في الطلب. ويجب أيضًا أن تتّسع الحالة والأسئلة بعد تسلسلها معًا ضمن 1,048,576 بايت بترميز UTF-8. قد يستوفي الطلب حد البايتات مع تجاوزه حد الرموز. ويذكر إصدار 1.0 الأقدم بصورة منفصلة 32,768 رمزًا لكل من الحالة والصف، لذا لا ينبغي نقل حدوده إلى 1.5.

توثّق Nace اسم drex-v1.5 بوصفه معرّف المنتج المرتبط بإصدار، بينما drex-latest اسم مستعار متغير. اجعل الإصدار المقصود صريحًا عندما يعتمد سير العمل على حدوده. السؤال سيئ البنية أو الحالة المفقودة أو المدخلات الأكبر من الحد مشكلة تحقق تتطلب تصحيح المدخلات، لا تغيير الفئة أو تخمين الإجابة. جهّز المعايير حول أدلة قابلة للملاحظة واحتفظ بالنتيجة المحددة النوع والحقائق الأصلية وتعريف السؤال معًا. يجعل ذلك القرار قابلًا للاستخدام في التوجيه أو ترتيب الأولويات أو المراجعة دون الخلط بين الاحتمال والحكم المضمون.

Ailoot Ultra · System One POST /v1/systemone nace-ai/drex-v1.5

nace-ai/drex-v1.5

Nace.AI /nace-ai/drex-v1.5

البداية

المدخلات المقبولة: النص
النتائج: decisions

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · System One POST /v1/systemone

الإدخال: text
الإخراج: decisions
صيغة الإخراج: json

الحقل	النوع	المتطلب	القيم والحدود	القيمة الافتراضية
الحقل`model`	النوع`string`	المتطلبمطلوب	القيم والحدود nace-ai/drex-v1.5	القيمة الافتراضية—
الحقل`provider`	النوع`schema`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—
الحقل`questions`	النوع`object`	المتطلبمطلوب	القيم والحدود	القيمة الافتراضية—
الحقل`session_id`	النوع`string`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—
الحقل`state`	النوع`schema`	المتطلبمطلوب	القيم والحدود	القيمة الافتراضية—
الحقل`trace`	النوع`schema`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—
الحقل`user`	النوع`string`	المتطلباختياري	القيم والحدود	القيمة الافتراضية—
الحقل`questions.<id>.type`	النوع`string`	المتطلبمطلوب	القيم والحدود noul, choice, score	القيمة الافتراضية—
الحقل`questions.<id>.instructions`	النوع`string\|object\|array`	المتطلبمطلوب	القيم والحدود	القيمة الافتراضية—
الحقل`questions.<id>.criteria`	النوع`object\|array`	المتطلباختياري	القيم والحدود الشروط: choice/score: مطلوبان؛ noul: اختياري. معايير choice كائن؛ وscore مصفوفة تتطلب minItems1.	القيمة الافتراضية—
الحقل`questions.<id>.criteria.true`	النوع`string\|object\|array`	المتطلبمطلوب	القيم والحدود ينطبق عندما: تم توفير كائن معايير noul	القيمة الافتراضية—
الحقل`questions.<id>.criteria.false`	النوع`string\|object\|array`	المتطلبمطلوب	القيم والحدود ينطبق عندما: تم توفير كائن معايير noul	القيمة الافتراضية—

تركيبات مواد الإدخال

noul · مطلوب: state, questions.<id>.type=noul, questions.<id>.instructions

choice · مطلوب: state, questions.<id>.type=choice, questions.<id>.instructions, criteria object

score · مطلوب: state, questions.<id>.type=score, questions.<id>.instructions, criteria array with minItems1

معلمات الطريقة ودورة حياتها

المعلمة	المواصفات
المعلمة`content_type`	المواصفاتapplication/json
المعلمة`required`	المواصفاتmodel, state, questions
المعلمة`material_types`	المواصفاتtext
المعلمة`optional_controls`	المواصفاتprovider, session_id, trace, user
المعلمة`multimodal_input_binding`	المواصفاتnull

دورة الحياة: synchronous

أرسل معرّف النموذج الدقيق واحتفظ بالاستجابة الأصلية كاملة.

الباقات

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع: غير محدد عند اختيار الوضع السريع
الوضع المرن: غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال: غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات Ailoot

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعدادات	جدول التعرفة	رموز السياق، أكثر من	رموز السياق، حتى القيمة شاملةً	الرسوم
الإعداداتالتعرفات الأساسية للرموز	جدول التعرفةالتعرفة الأساسية	رموز السياق، أكثر من—	رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى	الرسوم الإدخال · رموز الإدخال $0.00008 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز
الإعداداتالشريحة 1 لطول الطلب	جدول التعرفة—	رموز السياق، أكثر من⁦0⁩	رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى	الرسوم الإدخال · رموز الإدخال $0.00008 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

Ailoot Ultra · System One

بنية الطلب الرسمية المحفوظة؛ مثال توثيقياستخدم مواد طلبك الفعلية واحتفظ بالنتيجة كاملة

{
  "model": "nace-ai/drex-v1.5",
  "questions": {
    "is_bug": {
      "criteria": {
        "false": "The customer is asking a question or requesting a feature.",
        "true": "The customer describes broken or unexpected product behavior."
      },
      "instructions": "Is the customer reporting a software defect?",
      "type": "noul"
    },
    "team": {
      "criteria": {
        "account": "Login, permissions, or profile issues.",
        "frontend": "Rendering, layout, or browser compatibility issues.",
        "payments": "Checkout, billing, or payment processing issues."
      },
      "instructions": "Which team should own this ticket?",
      "type": "choice"
    },
    "urgency": {
      "criteria": [
        "Can wait for the next release",
        "Should be fixed this week",
        "Blocking revenue right now"
      ],
      "instructions": "How urgent is this ticket?",
      "type": "score"
    }
  },
  "state": {
    "customer_tier": "enterprise",
    "ticket": "My checkout page shows a blank screen after I click Pay. I have tried two browsers."
  }
}

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_REQUEST_FILE:?Set your actual JSON request file}"
export AILOOT_REQUEST_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads(Path(os.environ['AILOOT_REQUEST_FILE']).read_text(encoding='utf-8'))
if not isinstance(p,dict): raise SystemExit('Request must be a JSON object')
p['model']='nace-ai/drex-v1.5'
Path('request.json').write_text(json.dumps(p,ensure_ascii=False),encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/systemone \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path('result.json').read_text()),ensure_ascii=False,indent=2))
PY_RESULT

استلام النتائج وحفظها

Ailoot Ultra · System One

json

الاحتفاظ بكل النتائج المكتملة

احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.

يُحتفظ بكل إجابة مقدَّمة مرتبطة بمعرّف سؤال، مع نوعها الدقيق وقيمة noul/choice/score والثقة والاحتمالات ودليل تفسير القيم. يُخزَّن JSON الأصلي كاملاً ولا يُعاد إلا بعد التسوية.

عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بالعملية الأصلية وبالرد كاملاً أو جزئياً؛ ولا تعِد تنفيذ POST.

حقول الاستجابة

الحقل	النوع
الحقل`model`	النوعstring
الحقل`id`	النوعstring
الحقل`provider`	النوعstring
الحقل`answers.<id>.type`	النوعstring
الحقل`answers.<id>.noul`	النوعnumber
الحقل`answers.<id>.choice`	النوعstring
الحقل`answers.<id>.score`	النوعnumber
الحقل`answers.<id>.confidence`	النوعnumber
الحقل`answers.<id>.probabilities`	النوعobject
الحقل`answers.<id>.legend`	النوعobject
الحقل`usage.input_tokens`	النوعinteger
الحقل`usage.output_tokens`	النوعinteger
الحقل`usage.cost`	النوعnumber

الأخطاء والخطوات التالية

الاستجابة	الشرط	الخطوة التالية
الاستجابة⁦400⁩ · `invalid_request_error`	الشرطحقل مطلوب أو صيغة تمثيل أو قيمة غير صالحة	الخطوة التاليةصحّح حقل الطلب المشار إليه.

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra nace-ai/drex-v1.5

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

nace-ai/drex-v1.5

FAQ · Nace.AI: Drex v1.5

ما المدخلات والنتائج المتاحة؟: POST /v1/systemone · nace-ai/drex-v1.5: text → decisions
ما الحقول التي يستخدمها الطلب؟: POST /v1/systemone · nace-ai/drex-v1.5: model, provider, questions, session_id, state, trace, user

Nace.AI: Drex v1.5

Nace.AI: Drex v1.5

إعداد الحالة

احتمال نعم/لا أو اختيار أو درجة

الأدلة المشتركة وقراءة النتيجة

الإصدار وحدود الحجم

البداية

متاح في Ailoot · المدخلات والطرائق

الباقات

تعرفات Ailoot

الأسعار حسب الإعدادات

أمثلة للطلبات

Ailoot Ultra · System One

استلام النتائج وحفظها

Ailoot Ultra · System One

الاحتفاظ بكل النتائج المكتملة

عند الحاجة إلى التحقق من الاستجابة الأصلية

الأسماء البديلة

الأسماء البديلة للنموذج

الأسماء البديلة لمسارات الطرائق

معرّفات النماذج ذات الصلة IDs

الشركة ومحفظة مشاريعها

اشتر الرموز بخصم.

اربط API بالمنتج الذي تبيعه.