Respan: Span-01 Lite (free)
Span-01 Lite هو ملف Respan المستقل في اسمه لتقييم السلوك في المحادثات النصية وسجلات تنفيذ الوكلاء. يستخدم سلوكيات يحددها المستدعي ويعيد لكل منها احتمالات الوجود والغياب وعدم قابلية الرصد، وفق سير عمل التقييم الموثّق نفسه المستخدم في Span-01.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Span-01 Lite هو ملف نموذج ذو اسم مستقل ضمن عائلة Span-01 من Respan لتقييم السلوك. يعرّف دليل البدء السريع وجدول النماذج لدى الجهة المنتجة Lite بوصفه أحد ملفين يستخدمان سير عمل التقييم نفسه. يستقبل تفاعلًا نصيًا وتعريفات للسلوك بلغة واضحة، ثم يعيد ثلاثة احتمالات لكل تعريف: موجود، وغائب، وغير قابل للرصد. ناتجه المفيد سجل سلوك يعبّر صراحةً عن عدم اليقين، وليس إجابة مكتوبة عن المحادثة.
اختر الملاحظة وحدودها
عرّف السلوك بالكلمات التي تطابق مهمتك. لفحص التحويل إلى شخص، حدّد ما إذا كان المقصود أن المستخدم يطلب شخصًا صراحةً، أو أن المساعد يقول إن التحويل مطلوب، أو تحقق أي من الشرطين. وإذا كان مجرد خيبة الأمل لا ينبغي أن يُحتسب، فاذكر ذلك. ولفحص الاعتذار، حدّد الصياغة التي تُعد اعتذارًا بدلًا من الاعتماد على تسمية غير واضحة. لكل تعريف معرّف يعيده المُقيِّم مع احتمالاته.
تعود مجموعة السلوكيات إلى المستدعي. فأمثلة مثل الإحباط أو الوعود غير المسندة أو إساءة استخدام الأدوات أو أفعال الوكيل المتكررة هي تعريفات يجب تقديمها، وليست قائمة ثابتة من فئات أصلية. اجعل كل تعريف قابلًا للملاحظة في التفاعل المقدّم. قد يحسم مقطع قصير ما إذا كان المساعد قد اعتذر، مع افتقاره إلى الدليل على أن مشكلة خارجية حُلّت فعلًا.
جهّز مقطع المحادثة
تضع مدخلات Respan الموثّقة الرسائل السابقة في span.input والدور المراد تقييمه في span.output. محتوى الرسالة سلسلة نصية. حافظ على السياق اللازم لفهم الدور، بما في ذلك أدوار المتحدثين وطلب المستخدم ذي الصلة وأي دليل نصي استخدمه المساعد. لفحص الجودة، قدّم الدور الفعلي بدلًا من إعادة صياغة تزيل السلوك موضع التقييم.
يمكن لمراجعة توضيحية أن تستخدم رسالة من المستخدم تصف مشكلة متكررة وردًا من المساعد يعرض التحقيق. عرّف إحباط المستخدم ووعد المساعد بوصفهما ملاحظتين منفصلتين. وإذا كانت نتيجة أداة مهمة للحكم على استناد ادعاء إلى أدلة، فاحتفظ بالنص ذي الصلة من تلك النتيجة في السياق. الناتج تقييم لهذه التعريفات في المقطع المقدّم؛ ولا يجري النموذج التحقيق الموعود ولا يعدّل المحادثة نفسها.
موجود وغائب وغير قابل للرصد
تحتوي استجابة التقييم على معرّف السلوك مع p_present وp_absent وp_not_observable، ويبلغ مجموعها نحو 1. تعني «غير قابل للرصد» أن سجل التنفيذ لا يستطيع الإجابة عن السؤال. وهي تختلف عن «غائب». بالنسبة إلى تعريف مثل قبول العميل للحل، فإن مقطعًا ينتهي قبل رد فعل العميل يوفّر أدلة غير مكتملة، حتى إذا بدا رد المساعد واثقًا.
احتفظ بالقيم الثلاث كلها عند إعداد نتيجة للمراجعة. قد يفيد اختيار فئة ذات أعلى قيمة في العرض، لكن التوزيع يحتفظ بدرجة عدم اليقين في الملاحظة. لا تستخدم قيمة الوجود المنخفضة وحدها لاستنتاج أن السلوك لم يحدث قطعًا. وعندما يهيمن غياب الأدلة، قد يكون الإجراء المفيد هو الحصول على السياق ذي الصلة أو الاحتفاظ بالنتيجة باعتبارها مجهولة بدلًا من ابتكار تفسير.
عدة تعريفات على الأدلة نفسها
يقيّم سير عمل التقييم لدى الجهة المنتجة عدة تعريفات سلوكية معًا على سجل تنفيذ واحد، ويعيد نتيجة لكل معرّف وفق ترتيب الطلب. ولا تحدد وثائقه سقفًا لعدد السلوكيات في الطلب الواحد. ولا يثبت ذلك وجود نافذة رموز عامة أو حجم غير محدود لسجل التنفيذ. اجعل التعريفات هادفة والأدلة ذات صلة، واحتفظ بالربط بين كل نتيجة مُعادة والتعريف الذي أنتجها.
نتائج السلوك ملاحظات مستقلة وليست إجابة اختيار حصري واحدة. يمكن أن يوجد الإحباط والاعتذار واقتراح التحويل جميعًا في التبادل نفسه. وللتوزيع الثلاثي الخاص بكل منها معنى داخل تعريفه؛ ولا يؤدي جمع قيم الوجود عبر سلوكيات مختلفة إلى إنشاء توزيع فئات مطبّع أو درجة وفق معايير مرتبة.
احتفظ بالملف المختار مع نتائجه
توثّق الجهة المصنّعة اسمي Lite والنسخة القياسية مع بنية مشتركة للطلب والنتيجة. يدعم هذا العقد إعداد سجلات التنفيذ وتفسير احتمالات السلوك لأي من الملفين المسميين. لكنه لا يثبت أن Lite يمتلك الأوزان نفسها أو عدد المعلمات نفسه أو الجودة نفسها التي يمتلكها الإصدار الآخر. حافظ على إمكانية التعرف إلى الملف المختار عند مراجعة نتائجه بدلًا من استبدال نتائج الإصدارات المختلفة بصمت.
استخدم محادثات موسومة من المهمة المقصودة لاختيار عتبات التسجيل أو التوجيه أو المراجعة. احتفظ بالنتائج المرتفعة لعدم قابلية الرصد والملاحظات القريبة من الحدود للفحص، وقارن أي خطأ ظاهر بالدور الأصلي وتعريف السلوك. يتضمن الأثر النهائي المفيد معرّف المقطع النصي والتعريف والملف المختار والنتيجة الاحتمالية الثلاثية كاملة. وتقرر خطوة لاحقة في التطبيق ما ينبغي فعله بهذه الملاحظة؛ أما ناتج تقييم Lite فلا ينفّذ بنفسه تحويلًا ولا يمنع ردًا ولا ينشئ إصلاحًا.
Ailoot Ultra · System One POST /v1/systemone respan/span-01-lite:free
respan/span-01-lite:freeالبداية
Span-01 Lite هو ملف Respan المستقل في اسمه لتقييم السلوك في المحادثات النصية وسجلات تنفيذ الوكلاء. يستخدم سلوكيات يحددها المستدعي ويعيد لكل منها احتمالات الوجود والغياب وعدم قابلية الرصد، وفق سير عمل التقييم الموثّق نفسه المستخدم في Span-01.
- المدخلات المقبولة
- النص
- النتائج
- decisions
متاح في Ailoot · المدخلات والطرائق
Ailoot Ultra · System One POST /v1/systemone
- الإدخال
text- الإخراج
decisions- صيغة الإخراج
- json
| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقلmodel | النوعstring | المتطلبمطلوب | القيم والحدود respan/span-01-lite:free | القيمة الافتراضية— |
الحقل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 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
| الإعداداتالشريحة 1 لطول الطلب | جدول التعرفة— | رموز السياق، أكثر من0 | رموز السياق، حتى القيمة شاملةًلا يوجد حد أقصى | الرسوم الإدخال · رموز الإدخال $0 / 1K من الرموز الإخراج · رموز الإخراج $0 / 1K من الرموز الإدخال · قراءة ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت — / 1K من الرموز الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة — / 1K من الرموز |
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
أمثلة للطلبات
Ailoot Ultra · System One
{
"model": "respan/span-01-lite:free",
"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']='respan/span-01-lite:free'
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 respan/span-01-lite:free
الأسماء البديلة لمسارات الطرائق
استخدم مسارات الطرائق المعروضة أعلاه.
معرّفات النماذج ذات الصلة IDs
FAQ · Respan: Span-01 Lite (free)
- ما المدخلات والنتائج المتاحة؟
POST /v1/systemone·respan/span-01-lite:free:text→decisions- ما الحقول التي يستخدمها الطلب؟
POST /v1/systemone·respan/span-01-lite:free:model,provider,questions,session_id,state,trace,user