حذف وكيل ذكاء اصطناعي ملفًا، واستدعى أداة، واستهلك رموزًا (tokens). بعد ستة أشهر، من يستطيع أن يثبت أن سجل تلك الليلة لم يُعدَّل؟ في مجال تدقيق وكلاء الذكاء الاصطناعي يقدّم مشروع AgentLens جوابًا عمليًا: سجل تدقيق متسلسل بالتجزئة (hash). هذا المستودع على GitHub (agentkitai/agentlens) صغير وحديث. قرأته واستنسخته دون نشره، لذا أفصل فيما يلي بين ما تُظهره الشيفرة وما يدّعيه ملف README وما لم أتحقق منه.
يستحق المشروع الاهتمام لسبب محدد. أغلب أدوات مراقبة الوكلاء تقيس. أما هذه الأداة فتريد قبل كل شيء أن يصبح السجل التاريخي عصيًّا على التعديل الخفي، ثم تربطه بتتبعات OpenTelemetry وببروتوكول MCP. سنتبع هذا الخيط: السجل، ثم المداخل الثلاثة، ثم ما تعرضه الشاشة، ثم تجربة في عشر دقائق، وأخيرًا الحدود.
المعلومات محدّثة بتاريخ 9 نوفمبر 2026. المستودع برخصة MIT (قرأت ملف LICENSE، والمؤلف Amit Paz). تمتد آخر 50 عملية commit جلبتها من 2 يوليو إلى 1 أغسطس 2026. لا أذكر عدد النجوم ولا التنزيلات لأنني لم أتمكن من قراءتها في صفحة المستودع.
تدقيق وكلاء الذكاء الاصطناعي: سجل يتحقق من نفسه
يصف ملف README أداة AgentLens بأنها «صندوق أسود» (flight recorder) للوكلاء. كل استدعاء لنموذج، وكل استدعاء لأداة، وكل قرار موافقة، وكل خطأ، يُخزَّن حدثًا في سجل لا يقبل إلا الإضافة. والفكرة المركزية تُختصر في سطر واحد: كل حدث يحمل بصمة SHA-256 للحدث الذي قبله.
ويؤكد ذلك الملف packages/core/src/hash.ts. تغطي البصمة إصدار الصيغة والمعرّف والطابع الزمني والجلسة والوكيل والنوع ودرجة الخطورة والحمولة والبيانات الوصفية والبصمة السابقة. أول حدث في الجلسة يبدأ من null. وللتحقق تُعاد حساب كل بصمة ويُقارَن الرابط بالحدث السابق.
النتيجة العملية: إذا عدّل أحدهم سطرًا في قاعدة البيانات أو حذف سطرًا أو بدّل سطرين، فشل التحقق عند الموضع نفسه تمامًا. لكن انتبه، فهذا ليس توقيعًا رقميًا: من يتحكم في القاعدة كلها يستطيع إعادة حساب السلسلة بأكملها. يتحدث المشروع عن تصدير موقَّع للمدقّقين (GET /api/audit/verify/export)، لكنني لم أجرّبه.

تعيد الصورة أعلاه المخرجات التي يوردها README للأمر ./demo/aha.sh. يُدخل السكربت خمسة أحداث ويتحقق من السلسلة، ثم يعدّل سجلًا مباشرة في القاعدة ويتحقق مرة أخرى. لم أنفّذه بنفسي: هذه المخرجات كما أعلنها المشروع.
ثلاث طرق لتغذية سجل التدقيق
OpenTelemetry دون SDK
إذا كان وكيلك يصدر أصلًا spans وفق اتفاقيات GenAI في OpenTelemetry، فوجّه مُصدِّر OTLP إلى الخادم الذي يستمع على المنفذ 3400:
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:3400
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT=http://localhost:3400/v1/traces
بحسب README، تتحول spans من نوع chat إلى أزواج طلب واستجابة، ويصبح execute_tool استدعاء أداة، وinvoke_agent حدثًا خاصًا بالوكيل. وكل تتبّع (trace) يقابل جلسة. أما التكلفة، وقلّما تحملها الـ spans، فتُعاد بناؤها من جدول أسعار لكل نموذج: إنه تقدير من المشروع، فقارنه بفاتورتك. وفي الإنتاج يفرض المتغير OTLP_AUTH_TOKEN وجود رمز على هذه المسارات.
خادم MCP من جهة الوكيل
تُصرَّح الحزمة @agentkitai/agentlens-mcp في إعدادات MCP الخاصة بالوكيل، مثل إعدادات Claude Desktop أو Cursor. يصف الدليل docs/guide/mcp-integration.md نقل stdio وأدوات مثل agentlens_session_start وagentlens_log_event وagentlens_log_llm_call. يذكر README أن عدد الأدوات 22، بينما يذكر الدليل أكثر من 20، ولا يفسّر المشروع هذا الفرق.
وهنا تحفظ يخص الموثوقية. فالوكيل نفسه هو من يقرر استدعاء أداة التسجيل. فإن نسي، أو حرفته حقنة (injection) عن مساره، جاء السجل ناقصًا. وللحصول على تدقيق متين، فضّل التجهيز عبر OpenTelemetry لأنه يتم خارج الوكيل. وتجد مخاطر أدوات MCP مفصلة في مقالنا عن تسميم أدوات MCP.
حزم Python وTypeScript
لقراءة الجلسات والتحليلات، يمنحك الأمر pip install agentlensai أو npm install @agentkitai/agentlens-sdk عميلًا يعمل بمفتاح API. ويضيف README تجهيزًا تلقائيًا في Python لعدة مزودي نماذج، مع خيار لإخفاء البيانات.
ما تعرضه لوحة المتابعة
تعرض صفحة تفاصيل الجلسة خطًا زمنيًا: استدعاءات الأدوات، وخطأ واحد، والتكلفة المتراكمة، ونهاية الجلسة. وتشير شارة «Chain Valid» إلى حالة السلسلة. الصورة مأخوذة من المستودع (مجلد demo، رخصة MIT) وتعرض بيانات تجريبية: «Research Agent» استمر 45 ثانية بتكلفة 0.3420 دولار.

تمنح صفحة Health كل وكيل درجة من 100 اعتمادًا على عدة أبعاد. لم أقرأ معادلة الحساب، ولذلك لا أحكم عليها.

جرّب AgentLens في عشر دقائق
- ثبّت Docker ثم شغّل الصورة التي ينشرها المشروع. بحسب README، العلم
AUTH_DISABLED=trueمخصص للتجربة المحلية فقط.docker run -p 3400:3400 -e AUTH_DISABLED=true -e JWT_SECRET=dev-secret ghcr.io/agentkitai/agentlens - افتح
http://localhost:3400. وإن لم يتوفر Docker، يقترح README الأمرnpx @agentkitai/agentlens-server(يتطلب Node.js 20 أو أحدث). - لترى انكسار السلسلة، استنسخ المستودع ونفّذ
./demo/aha.sh(يتطلب Docker). - بعد ذلك وجّه وكيلًا مجهزًا إلى المنفذ 3400 بمتغيرات OTLP المذكورة أعلاه.
وإذا أردت قاعدة مشتركة، يوفر المستودع ملف Docker Compose يضم Postgres وRedis والمصادقة وTLS. أما للتجربة فيكفي SQLite، وهو الخيار الافتراضي.
الحدود ونقاط لم تُحسم
- النضج. المستودع حديث ولا يظهر في الرخصة سوى مؤلف واحد. لم أتمكن من قراءة عدد النجوم ولا وتيرة معالجة التذاكر.
- الامتثال. يشير README إلى المادة 12 من لائحة الاتحاد الأوروبي للذكاء الاصطناعي. وهذا ليس اعتمادًا رسميًا: سلسلة التجزئة تساعد في حفظ السجلات لكنها لا تغني عن تحليل قانوني ولا عن سياسة احتفاظ.
- السلامة. من دون تثبيت خارجي لبصمة رأس السلسلة، تبقى القاعدة المعاد كتابتها بالكامل غير قابلة للاكتشاف.
- البيانات. قد تحتوي المطالبات (prompts) والمخرجات على أسرار. فعّل الإخفاء وشفّر القرص.
- Dynatrace. لا شيء يربط AgentLens بـ Dynatrace. فهو يستقبل OTLP، لكنه ليس مُصدِّرًا ولا تكاملًا رسميًا.
ممارسات مقترحة
- جهّز الوكيل من الخارج (OpenTelemetry) بدل أن تطلب منه تسجيل نفسه.
- دوّن بصمة رأس السلسلة بانتظام في نظام طرف ثالث لتثبيت السلسلة.
- استخدم معرّف المحادثة نفسه في APM وفي سجل التدقيق لتربط التتبعات بالأدلة.
- عطّل
AUTH_DISABLEDبمجرد أن يغادر الخادم جهازك. - اربط الإنفاق بتنبيهات: راجع تكلفة وكيل الذكاء الاصطناعي بالرموز.
ولمراقبة وكلاء البرمجة محليًا، قارن مع Observal، وللحدود التي ينبغي فرضها على الوكلاء، اقرأ ضوابط وكلاء الذكاء الاصطناعي في الإنتاج.
الأسئلة الشائعة
هل يحل AgentLens محل أداة مراقبة مثل Dynatrace؟
لا. فهو يحفظ أثر ما يفعله الوكيل ويثبت أنه لم يتغير. أما أهداف مستوى الخدمة (SLO) والربط بالبنية التحتية وتحليل السبب الجذري فتبقى من مهام منصة المراقبة لديك.
هل تمنع سلسلة التجزئة التلاعب؟
إنها تجعله قابلًا للاكتشاف لا مستحيلًا. فمن يعيد كتابة السلسلة كلها يحصل على سجل متماسك. ثبّت بصمة الرأس خارج القاعدة لتغلق هذا الباب.
هل يصلح للإنتاج؟
القرار لك: المشروع حديث ولم أختبره اختبارًا شاقًا. ابدأ بوكيل غير حرج، مع المصادقة والإخفاء والنسخ الاحتياطي.
الخلاصة
يقدّم AgentLens فكرة بسيطة ومفيدة: سجل وكيل يمكن التحقق منه من جديد. يستحق القراءة لنمط سلسلة التجزئة، والتجربة عبر العرض التوضيحي، ولا أنصح بترقيته إلى الإنتاج قبل اختبار حدوده. وللاطلاع على سمات span الواجب إصدارها، راجع إطار GenAI في OpenTelemetry.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC. Dynatrace علامة تجارية لشركة Dynatrace LLC. المشروع AgentLens ملك لأصحابه. الصور مأخوذة من مستودع المشروع (رخصة MIT) دون أي اختبار من جانبي. تحقق دائمًا من القيم (المنافذ والإصدارات والأحجام) في الوثائق الرسمية الخاصة بإصدارك.