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