نموذج البيانات
الحدث أصغر وحدة من البيانات. يسجل الحدث الواحد خطوة واحدة اتخذتها الوكيل:tool_use، أو model_request، أو hook_completed، أو error، وما إلى ذلك. يصدر الوكيل الأحداث من خلال Python SDK؛ تظهر مباشرة على صفحة الأحداث.
الجلسة
تشغيل واحد للوكيل، يُعرّف بـ session_id. الجلسة هي كل الأحداث التي تشترك في هذا المعرف، مدمجة في صف واحد على صفحة الجلسات وموضحة كرسم بياني للتنفيذ على صفحة التفاصيل الخاصة بها. عادةً تبدأ الجلسة بـ agent_start وتنتهي بـ agent_end.
الوكيل
ممثل مسمى داخل تشغيل، يُعرّف بـ agent_id. قد يشتمل التشغيل الواحد على عدة وكلاء: مخطط يولد وكيل تلخيص فرعي، على سبيل المثال. تحمل الوكلاء الفرعيون parent_id، وهو ما يسمح لـ FailproofAI Observability برسمهم على مساراتهم الخاصة في رسم البياني للتنفيذ.
البيئة
تسمية للمكان الذي حدث فيه التشغيل: production أو staging أو dev. تعيّنها مرة واحدة عند تكوين SDK. يمكن لكل صفحة من صفحات لوحة المعلومات تقريباً أن تقوم بالتصفية حسب البيئة.
ملء نافذة السياق
النسبة المئوية لنافذة السياق للنموذج التي استهلكتها الاستجابة. يضع FailproofAI Observability طابعاً عليها على أحداث model_response للنماذج التي يتعرف عليها، بحيث يكون نمو الموجه والضغط الوشيك مرئياً مباشرة في تيار الأحداث.
الجودة
التقييم درجة الجودة للجلسة المنتهية، يتم إنتاجها بواسطة خدمة التسجيل التي تقوم بتشغيلها. التقييمات اختيارية: حتى تقوم بتوصيل محيّم، يتم تسجيل الجلسات لكن لا يتم تسجيل درجات لها. يمكن لكل تقييم أن يحمل عدة درجات مسماة (على سبيل المثالhelpfulness و factuality و tool_efficiency)، كل منها مع ملاحظة توضيحية قصيرة. انظر مجموعة التقييم.
مفتاح الدرجة
اسم أحد الأبعاد التي يبلغ عنها المقيّم، مثل helpfulness. يمكن للتنبيهات والتدقيقات مراقبة مفتاح درجة معين بمرور الوقت.
المقيّم
خدمة التسجيل الخاصة بك. يقوم FailproofAI Observability بإرسال نسخة التشغيل المنتهي عبر POST إليها ويخزن الدرجات التي ترجعها. لا يأتي مع محيّم افتراضي؛ منطق التسجيل يكون من عندك.
البحث والإصلاح والفشل
الخطاف حاجز أو تأثير جانبي يشغله إطار عمل الوكيل حول خطوة: فحص سلامة المحتوى، أو تحرير معرّفات المعلومات الشخصية، أو حاجز الميزانية. تصدر الخطافات أحداثhook_triggered / hook_completed مع outcome (allow أو deny أو modify)، وتحصل على صفحة observe خاصة بها.
قاعدة التنبيه
قاعدة تتفعل عند عبور مقياس للحد الذي تعيّنه: معدل الخطأ، أو كمون p95، أو تكلفة الرموز، أو درجة المقيّم. عندما تتفعل القاعدة، تفتح حادثة وتخطر القنوات المختارة (البريد الإلكتروني أو Slack أو webhook أو لوحة المعلومات). انظر التنبيهات.
الحادثة
قضية مفتوحة تم إنشاؤها عند تفعل قاعدة تنبيه. للحوادث دورة حياة (إقرار أو إسناد أو حل) وخط زمني للنشاط يسجل كل إجراء. يمكنك أيضاً فتح واحدة يدويّاً.
التدقيق
تحقيق متكرر (كل ساعة إلى أسبوع) يستخرج سجلاتك عبر الجلسات بحثاً عن أنماط الفشل التي لم تكتب قاعدة لها: مجموعات الأخطاء أو الدرجات المنخفضة أو الكمون الشاذ أو حلقات استدعاء الأدوات أو التشغيلات التي لم تنتهِ أبداً. بينما يراقب التنبيه مقياساً تعرفه بالفعل، يخبرك التدقيق بما يجب الانتباه له بعد ذلك. انظر التدقيقات.
الاكتشاف
نتيجة واحدة مرتبة ومدعومة بالأدلة من تشغيل التدقيق. يسمي الاكتشاف نمطاً ويرتبط بالجلسات الدقيقة وراءه ويحمل دورة حياة الفرز (إقرار أو حل أو كتم أو رفض). يقوم FailproofAI Observability بإلغاء تكرار الاكتشافات من تشغيل إلى آخر بحيث يتم تحديث النمط المعروف بدلاً من تراكمه.
مساعد الذكاء الاصطناعي
الدردشة داخل لوحة المعلومات التي تجيب على الأسئلة حول وكلائك باللغة الإنجليزية العادية، على بيانات خاصة بك. إنها بدون تعديل افتراضياً؛ أي شيء تنشئه (استعلام محفوظ أو لوحة معلومات) خاضع للموافقة، ولا يمكنها حذف أبداً. انظر مساعد الذكاء الاصطناعي.
تشغيله
المؤسسة (المستأجر) مساحة عمل معزولة. يمكن لنسخة واحدة من FailproofAI Observability استضافة عدة مؤسسات، لكل منها مستخدموها ومفاتيحها وبياناتها الخاصة. كل عنوان URL لوحة معلومات مشمول بنطاق slug المؤسسة (/<org-slug>/…).
جامع البيانات
agenteye-collector، وهو برنامج توضيح خفيف الوزن يعمل على كل جهاز وكيل، ويجمع الأحداث التي يكتبها SDK على القرص، وينقلها إلى الخادم.
مفتاح واجهة برمجية التطبيقات
رمز مشروط يصادق عميل ضد الخادم. تحمل المفاتيح أذونات دقيقة (على سبيل المثال events:add للجامع أو نطاقات بدون تعديل لمفتاح لوحة المعلومات). انظر مفاتيح واجهة برمجية التطبيقات.
الخادم
خدمة الاستقبال و واجهة برمجية التطبيقات. إنه يستقبل الأحداث ويخزن الحالة التشغيلية في قواعد بيانات خاصة بك وينشر لوحة المعلومات و CLI.
لوحة المعلومات
واجهة المستخدم على الويب. كل صفحة مشمولة بنطاق المؤسسة وتقرأ من خلال واجهة برمجية التطبيقات للخادم.