title: “المفاهيم” description: “المصطلحات المستخدمة في Failproof AI Observability — الأحداث والجلسات والتقييمات والتدقيقات والنتائج والحوادث — معرّفة في مكان واحد.”
تحدد هذه الصفحة المصطلحات التي يستخدمها Failproof AI Observability. إذا كان هناك مصطلح غير مألوف في دليل آخر، فهو معرّف هنا. لا تحتاج إلى قراءة الصفحة كاملة: يمكنك تصفحها أو العودة إليها عند مصادفة كلمة تريد توضيحها.نموذج البيانات
Event (الحدث) أصغر وحدة بيانات. يسجل حدث واحد خطوة واحدة اتخذها وكيلك:tool_use أو model_request أو hook_completed أو error وغيرها. ينبعث وكيلك الأحداث عبر Python SDK؛ تظهر مباشرة على صفحة Events.
Session (الجلسة)
تشغيل واحد للوكيل، يتم تعريفه بواسطة session_id. الجلسة هي جميع الأحداث التي تشترك في نفس المعرّف، مدمجة في صف واحد على صفحة Sessions وموضحة كرسم بياني تنفيذي في صفحة التفاصيل الخاصة بها. عادة ما تبدأ الجلسة بـ agent_start وتنتهي بـ agent_end.
Agent (الوكيل)
فاعل مُسمّى داخل التشغيل، يتم تعريفه بواسطة agent_id. يمكن أن يشتمل التشغيل على عدة وكلاء: على سبيل المثال، مخطط ينتج وكيل فرعي للتلخيص. يحمل الوكلاء الفرعيون parent_id، وهذا هو ما يسمح لـ Failproof AI Observability برسمهم على مساراتهم الخاصة في الرسم البياني التنفيذي.
Environment (البيئة)
تصنيف للمكان الذي حدث فيه التشغيل: production أو staging أو dev. تعيّنها مرة واحدة عند تكوين SDK. يمكن لكل صفحة لوحة تحكم تقريباً التصفية حسب البيئة.
Context-window fill (ملء نافذة السياق)
نسبة مئوية من نافذة السياق للنموذج التي استهلكتها الاستجابة. يضيف Failproof AI Observability الطابع الزمني لها على أحداث model_response للنماذج التي يتعرف عليها، بحيث يكون نمو المطالبة والانضغاط الوشيك مرئياً مباشرة في تدفق الأحداث.
الجودة
Evaluation (التقييم) درجة جودة لجلسة منتهية، ينتجها خدمة تسجيل تديرها. التقييمات اختيارية: حتى تقوم بربط مُقيّم، يتم تسجيل الجلسات لكن لا يتم تقديرها. يمكن لكل تقييم أن يحمل عدة درجات مسمّاة (على سبيل المثالhelpfulness و factuality و tool_efficiency)، كل منها مع ملاحظة قصيرة للتفكير. انظر Evaluation suite.
Score key (مفتاح الدرجة)
اسم بُعد واحد يبلغ عنه المُقيّم، مثل helpfulness. يمكن للتنبيهات والتدقيقات مراقبة مفتاح درجة معين بمرور الوقت.
Evaluator (المُقيّم)
خدمة التسجيل الخاصة بك. يرسل Failproof AI Observability نسخة نصية من التشغيل المنتهي إليها ويخزن الدرجات التي ترجعها. لا توفر مُقيّماً افتراضياً؛ منطق التسجيل خاص بك.
العثور على الأخطاء وإصلاحها
Hook (الخطاف) حماية أو تأثير جانبي يقوم إطار عمل وكيلك بتشغيله حول خطوة: فحص سلامة المحتوى أو إخفاء معلومات التعريف الشخصية أو حماية الميزانية. تنبعث الخطافات من أحداثhook_triggered / hook_completed مع outcome (allow أو deny أو modify)، وتحصل على صفحة ملاحظة خاصة بها.
Alert rule (قاعدة التنبيه)
قاعدة تُطلق عندما تتجاوز مقياس حداً تعيّنه: معدل الخطأ أو كمون p95 أو تكلفة الرموز أو درجة المُقيّم. عند تفعيل القاعدة، تفتح حادثة وتُعلم القنوات المختارة لديك (البريد الإلكتروني أو Slack أو webhook أو داخل لوحة التحكم). انظر Alerts.
Incident (الحادثة)
مشكلة مفتوحة يتم إنشاؤها عند تفعيل قاعدة التنبيه. للحوادث دورة حياة (الإقرار والتعيين والحل) وخط زمني للنشاط يسجل كل إجراء. يمكنك أيضاً فتح واحدة يدويّاً.
Audit (التدقيق)
تحقيق متكرر (كل ساعة إلى أسبوعياً) يفحص السجلات عبر الجلسات للبحث عن أنماط الفشل التي لم تكتب قاعدة لها: تجمعات الأخطاء والدرجات المنخفضة والقيم الشاذة للكمون وحلقات استدعاء الأدوات والتشغيلات التي لم تنتهِ أبداً. حيث يراقب التنبيه مقياساً تعرفه بالفعل، يخبرك التدقيق بما يجب أن تنظر إليه بعد ذلك. انظر Audits.
Finding (النتيجة)
نتيجة واحدة مرتبة مدعومة بالأدلة من تشغيل التدقيق. تسمي النتيجة نمطاً وتربط بالجلسات الدقيقة وراءها وتحمل دورة حياة الفرز (الإقرار والحل والكتم والرفض). يقوم Failproof AI Observability بإزالة تكرار النتائج من تشغيل إلى آخر بحيث ينتج النمط المعروف تحديثاً بدلاً من التراكم.
The AI assistant (مساعد الذكاء الاصطناعي)
الدردشة داخل لوحة التحكم التي تجيب على أسئلة حول وكلائك بلغة إنجليزية عادية، على بياناتك الخاصة. هو للقراءة فقط بشكل افتراضي؛ أي شيء ينشئه (استعلام محفوظ أو لوحة تحكم) مُوافق عليه، ولا يمكنه أبداً الحذف. انظر AI assistant.
تشغيله
Organization (tenant) (المنظمة) مساحة عمل معزولة. يمكن لمثيل واحد من Failproof AI Observability استضافة عدة منظمات، كل منها مع المستخدمين والمفاتيح والبيانات الخاصة بها. كل عنوان URL لوحة التحكم مُحدد النطاق تحت رمز المنظمة الخاص بك (/<org-slug>/…).
Collector (المجمع)
agenteye-collector، الديمون الخفيف الذي يعمل على كل جهاز وكيل، يجمع الأحداث التي يكتبها SDK إلى القرص، وينقلها إلى الخادم.
API key (مفتاح API)
رمز مُحدد النطاق يوثّق عميل ضد الخادم. تحمل المفاتيح أذونات دقيقة (على سبيل المثال events:add للمجمع، نطاقات للقراءة فقط لمفتاح لوحة التحكم). انظر API keys.
Server (الخادم)
خدمة البلع والـ API. تبتلع الأحداث وتخزن الحالة التشغيلية في قواعد البيانات الخاصة بك وتخدم لوحة التحكم والـ CLI.
Dashboard (لوحة التحكم)
واجهة المستخدم على الويب. كل صفحة مُحددة النطاق لمنظمة وتقرأ من خلال API الخادم.
الخطوات التالية
- Overview: كيف تتناسب هذه الأجزاء معاً.
- Observability: سطح الملاحظة (Events و Sessions و Models و Tools و Hooks و Errors).