LiquidAI: d1
يقيّم سير عمل القرارات النصية في d1 من Liquid AI الأدلة المقدّمة وفق نتائج ثابتة ويعيد احتمالات أو اختيار فئة أو درجة وفق معايير تقييم. يدعم التصنيف والتوجيه والترشيح بحسب الصلة وترتيب الأولويات دون توليد إجابة مكتوبة.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
d1 هو نموذج القرار المستضاف من Liquid AI لمهام التصنيف والتوجيه والتقييم المحدودة النطاق. يغطي هذا الملف سير عمله للقرارات النصية: قدّم الأدلة في صورة حالة، وحدّد سؤالًا واحدًا أو أكثر، وتلقَّ إجابات عددية محددة النوع لنتائج معروفة. تصف Liquid هذه القرارات بأنها تقييمات تعيد الاحتمالات مباشرةً، مع صفر من رموز المخرجات المولّدة. النتيجة المفيدة قرار محدد وعدم اليقين المحيط به، بدلًا من مقطع نصي مؤلَّف حديثًا.
جهّز الأدلة والسؤال معًا
قدّم النص الذي يجعل القرار ممكنًا، بما في ذلك السياق اللازم لتفسيره. افصل الحالة عن التعليمات التي تصف ما ينبغي تقييمه. قد تحتاج رسالة دعم إلى وصف للمنتج أو المشكلة؛ وقد يحتاج مقطع من مستند إلى سؤال البحث لدى المستخدم. حدّد مجموعة الإجابات قبل طرح السؤال، وامنح كل خيار معنى يناسب سير العمل المقصود. يمكن للتسميات القصيرة أن تعمل مفاتيح إخراج ثابتة، بينما تشرح الأوصاف الحدود بينها.
استخدم أسئلة مسماة على حالة مشتركة. يحافظ اسم واضح مثل intent أو urgency أو relevant على ربط الناتج بالقرار الذي يمثله. على سبيل المثال، يمكن لرسالة تبلغ عن تعطل صفحة أن تدعم اختيار نية، ومعيارًا لتقييم الإلحاح، وفحص نعم/لا لعيب مُبلَّغ عنه. ينبغي أن يحتفظ كل سؤال بمعياره الخاص بدلًا من جمع الأحكام الثلاثة في تسمية ملتبسة واحدة.
choice للفئات والتوجيه
يختار سؤال choice تسمية واحدة من مجموعة غير مرتبة ويعيد التوزيع على الخيارات المسماة. عرّف الخيارات من خلال أوصاف المعايير؛ وتتضمن النتيجة الاختيار المحدد والاحتمالات والثقة. لتنظيم المستندات، حدّد المجلدات أو الموضوعات الممكنة واذكر المحتوى الذي ينتمي إلى كل منها. ولتوجيه الطلبات، صِف الوجهات الموجودة فعلًا. يستطيع التطبيق استخدام التسمية الناتجة لاختيار خطوته التالية مع الاحتفاظ بالاحتمالات المتنافسة للمراجعة.
يمكن لمهمة تصنيف مستندات توضيحية أن تفصل بين سؤال عن المنتج ومشكلة تكامل ومشكلة وصول، مع خيار other للمادة الخارجة عن تلك التعريفات. اجعل الحدود ملموسة: فالرسالة التي يتعذر عليها إجراء المصادقة تختلف عن رسالة تسأل عن كيفية ضبط ميزة. تختار التسمية المُعادة من بين المعاني المقدّمة؛ ولا تنشئ وجهة مفقودة ولا تنفّذ تغييرًا في نظام آخر.
noul لفحص الشروط والصلة
يعيد سؤال noul احتمالًا من 0 إلى 1 لتحقق شرط نعم/لا المحدد. تعرض Liquid فحوصًا ثنائية لمراجعة المحتوى وصلة المقاطع. صُغ الشرط بدقة واختر كيفية استخدام الاحتمال الناتج: الإشارة إلى تطابق مرجح، أو ترشيح مقطع، أو إرسال حالة غير يقينية للمراجعة. تعود العتبة إلى المهمة التي تستخدم النتيجة، ولا ينبغي التعامل مع الاحتمال بوصفه حكمًا واقعيًا مضمونًا.
للترشيح بحسب الصلة، قدّم الاستعلام والمقطع المرشح معًا. اسأل عما إذا كان ذلك المقطع يساعد في الإجابة عن الاستعلام، ثم احتفظ بالمقطع الأصلي مع احتماله. يمكن لذلك دعم اختيار مادة مصدرية لإجابة لاحقة دون مطالبة d1 بتأليف تلك الإجابة بنفسه. وإذا احتاجت الصلة إلى عدة درجات بدلًا من شرط نعم/لا، فحدّد معايير تقييم مرتبة واستخدم سؤال score.
score للمستويات المرتبة
يضع سؤال score الحالة على مقياس تقييم بمستويات مرتبة وموصوفة. تبدأ فهارس المستويات عند 0، وتكون الدرجة موضعها المرجّح بالاحتمالات، وقد تقع بين المستويات. تتضمن النتيجة أيضًا توزيع المستويات والثقة. بالنسبة إلى الإلحاح، حدّد ما يميّز مشكلة دون أثر فوري، وإزعاجًا ذا شأن، ومهمة معطلة. لذلك يكون لمقياس من أربعة مستويات فهارس من 0 إلى 3؛ ولا تكون درجته المتوقعة تلقائيًا فئة مرقمة من 1 إلى 4.
استخدم الدرجة الكسرية للترتيب أو التجميع عندما تكون تلك هي النتيجة المقصودة، واحتفظ بالتوزيع الكامل عندما يكون الالتباس مهمًا. لا تملك فئات مثل الأقسام ترتيبًا طبيعيًا، ومكانها سؤال choice. تلخّص الثقة مدى حسم الإجابة المعلنة في الواجهة الموثّقة؛ وينبغي أن تبقى منفصلة عن الدرجة التي تستهدفها المهمة وعن ضمان مفترض لصحة القرار.
أسئلة متعددة وتطبيقات الجهة المنتجة
يمكن لعدة أسئلة تقييم الحالة نفسها في استدعاء واحد للمنتج، مع احتفاظ كل منها بنوعه واحتمالاته. تتضمن أمثلة Liquid النصية ترشيح تذاكر الدعم، وتصنيف المستندات ضمن تصنيف للمجلدات، واختيار مسارات البحث في الشيفرة، والاختيار بين إجراءات الوكيل المتاحة، وتحديد مادة مخرجات الأدوات التي ينبغي الاحتفاظ بها. تملك كل مسارات العمل هذه قرارًا تاليًا محدد النطاق. يمكن لخطوة بحث في الشيفرة اختيار مجلد واعد من أوصافه؛ ويمكن لخطوة اختيار محتوى الاختيار بين keep وtrim وdrop للمادة المقدّمة. ويظل التطبيق المحيط هو من يحصل على البيانات المصدرية وينفّذ العملية المختارة.
النطاق وأثر قرار مفيد
تلائم العمليات الأساسية الموثّقة النتائج المعروفة والتقييم وفق معايير وفحص الشروط. أما النص الجديد والملخصات والشيفرة والمحادثة المفتوحة فتتطلب سير عمل توليديًا، ولا يُفترض أنها تترتب على نتيجة قرار d1. جهّز سؤالًا حول أدلة قابلة للملاحظة واحتفظ بتعريفاته مع المخرجات حتى يمكن تفسير التسمية أو الدرجة لاحقًا.
اجعل كل حالة مركّزة على الأدلة التي تجيب عن أسئلتها المحددة، وافصل مهام القرار غير المترابطة حتى تظل معاييرها واضحة. أبقِ المادة المصدرية ذات صلة، وحدّد معاني احتياطية عند عدم اكتمال تغطية الفئات، وقيّم عتبات الاحتمالات باستخدام أمثلة موسومة من المهمة. يسجل الأثر المفيد الفئة المختارة أو الدرجة المتوقعة إلى جانب توزيعها وهوية السؤال والأدلة الأصلية.
Ailoot Ultra · System One POST /v1/systemone liquid/d1
liquid/d1البداية
يقيّم سير عمل القرارات النصية في d1 من Liquid AI الأدلة المقدّمة وفق نتائج ثابتة ويعيد احتمالات أو اختيار فئة أو درجة وفق معايير تقييم. يدعم التصنيف والتوجيه والترشيح بحسب الصلة وترتيب الأولويات دون توليد إجابة مكتوبة.
- المدخلات المقبولة
- النص
- النتائج
- decisions
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · System One POST /v1/systemone
- الإدخال
text- الإخراج
decisions- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود liquid/d1 | القيمة الافتراضية— |
الحقل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 من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت $0.00008 / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
| الإعداداتالشريحة 1 لطول الطلب | جدول التعرفة— | رموز السياق، أكثر من0 | رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى | الرسوم الإدخال · رموز الإدخال $0.00008 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت $0.00008 / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · System One
{
"model": "liquid/d1",
"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']='liquid/d1'
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 liquid/d1
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · LiquidAI: d1
- ما المدخلات والنتائج المتاحة؟
POST /v1/systemone·liquid/d1:text→decisions- ما الحقول التي يستخدمها الطلب؟
POST /v1/systemone·liquid/d1:model,provider,questions,session_id,state,trace,user