عن المشروع

Peaky Peek (agent_debugger) هي وحدة تحكم للتدقيق والثقة مفتوحة المصدر وتعمل محليًا أولاً، مصممة خصيصًا لتصحيح أخطاء وكلاء الذكاء الاصطناعي. على عكس أدوات المراقبة التقليدية مثل LangSmith وOpenTelemetry أو Sentry، تركز Peaky Peek على الإجابة عن السؤال الذي يهم المشغلين فعليًا: هل يمكنني الوثوق بما فعله هذا الوكيل؟ تلتقط الأداة السلسلة السببية الكاملة وراء كل إجراء يقوم به الوكيل، وتعيد صياغة كل تشغيل كسجل تدقيق يجيب عن خمسة أسئلة رئيسية: ماذا حدث، ولماذا، وما الدليل، وما النتيجة، وأين فشل. يتم تصنيف كل ادعاء بشكل حتمي على أنه موثَّق، أو موثَّق جزئيًا، أو مناقَض، أو غير مدعوم، أو غير موثَّق، أو قديم، وتتلقى كل جلسة درجة ثقة قابلة للتفسير بالإضافة إلى بطاقة حكم مع وضع مسمى (تصرف، أو تحقق أولاً، أو لا تتصرف). تشمل الميزات الرئيسية: - وحدة تحكم تدقيق وثقة للوكلاء مع بطاقات حكم حتمية، ودرجات ثقة قابلة للتفسير، وسرديات فشل، وشارات تحقق، وإشارات مخاطر - تصور شجرة القرار للتنقل في منطق الوكيل كشجرة تفاعلية - إعادة تشغيل نقاط التفتيش للسفر عبر الزمن أثناء تنفيذ الوكيل مع تشغيل مدرك لنقاط التفتيش - بحث التتبع للعثور على أحداث محددة عبر جميع الجلسات - تجميع حالات الفشل وتنسيق متعدد الوكلاء للتحليل التكيفي لحالات الفشل المتشابهة - مقارنة الجلسات للمقارنة جنبًا إلى جنب بين تشغيلين للوكيل يتوفر التكامل من خلال ثلاث طرق: مُزيِّن بسيط (@trace)، ومدير سياق (trace_session)، وتصحيح تلقائي صفري الإعداد يعمل مع PydanticAI وLangChain وOpenAI SDK وCrewAI وAutoGen وLlamaIndex وAnthropic دون تغييرات في الكود. تتكون البنية من طبقة SDK للقياس، وطبقة ذكاء للكشف وإعادة التشغيل، وخادم FastAPI مع تخزين SQLite، وواجهة أمامية React/TypeScript مع تسع لوحات متخصصة. المشروع مرخص بموجب MIT، ويتطلب Python 3.10+، ومتاح عبر pip باسم peaky-peek-server. تشمل ميزات الخصوصية العمل محليًا أولاً دون أي قياس عن بعد خارجي، وخط أنابيب تنقيح اختياري، ومصادقة بمفتاح API مع تجزئة bcrypt، وتخزين SQLite دون أي اعتماد على السحابة.