النتيجة، معادة الصياغة بدقة
ربع عمليات نشر الوكلاء تعمل دون مراقبة. القراءة الشائعة تنظيمية: الفرق أطلقت بسرعة مفرطة، ولم يتحمّل أحد مسؤولية الموثوقية، وتخلّفت الحوكمة. هذه القراءة مريحة وخاطئة في معظمها. عندما يفتقر النظام إلى حدّ خطوة مستقر، ومعرّف ارتباط مشترك، ومخطط span، فإن المراقبة ليست مشكلة انضباط — بل عنصر أولي غائب. لا يمكنك أن تتغلّب بلوحات المعلومات على معمارية لم تُصدر قط الأحداث التي تريد التنبيه عليها.
لماذا تُتجاهل المراقبة
الأطر تُصدر سجلات، لا آثاراً. حلقة الوكيل النموذجية تكتب أسطراً مقروءة بشرياً: أُرسل الـ prompt، اختيرت الأداة، حُلّل الرد. أسطر السجل رخيصة الإنتاج وشبه عديمة الفائدة للتجميع. لا علاقة أب-ابن، ولا مدة، ولا حقل حالة، ولا نطاق سمات. يصبح الاستعلام عن "أي التشغيلات استدعت أداة الاسترداد أكثر من ثلاث مرات" تمريناً في التعبيرات النمطية على نص غير مُهيكل، ولهذا لا يبني أحد التنبيه.
البيانات تعيش في أنظمة مختلفة. استدعاءات النموذج لدى مزوّد الاستدلال. استدعاءات الأدوات في سجلات التطبيق. عمليات الاسترجاع في مخزن المتجهات. قرارات السياسة في بوابة. لكل نظام معرّفه الخاص للعملية المنطقية نفسها، ولا يتفق أي منها. دون معرّف ارتباط يُنشأ عند حدّ التشغيل وينتشر عبر كل قفزة، يتطلب إعادة بناء خطوة وكيل واحدة ضمّ صادرات أربعة مزوّدين حسب الطابع الزمني — وهو نهج يفشل لحظة وقوع استدعاءين في المللي ثانية نفسها.
يُضاف التجهيز بعد الإطلاق. بحلول الوقت الذي تقرر فيه الفرقة أنها تحتاج الآثار، يكون الوكيل قد أُعيد هيكلته مرتين، ولفّت الأدوات بمنطق إعادة المحاولة، وذاب حدّ الخطوة في سلسلة من ردود النداء غير المتزامنة. إضافة الـ spans بأثر رجعي تعني إعادة تعريف ما هي الخطوة، وهذا تغيير تصميمي، لا تغيير في الرصد. ويُؤجَّل إلى أجل غير مسمى لأنه ينافس عمل الميزات ولا أثر مرئي له حتى أول حادثة جسيمة.
التجهيز كعقد وقت البناء

البديل هو التعامل مع الرصد كجزء من واجهة الوكيل، يُفرض بالطريقة نفسها التي يُفرض بها توقيع النوع أو ترحيل المخطط.
كل خطوة تُصدر span. الخطوة هي أي وحدة يمكن للنظام إعادة محاولتها أو رفضها أو فوترتها باستقلالية: استدعاء نموذج واحد، استدعاء أداة واحد، استرجاع واحد، تقييم سياسة واحد. يحمل الـ span المدخلات والمخرجات والتكلفة والزمن الكامن وقرار السياسة الذي أذن به. التكلفة ليست مقياساً مشتقاً يُحسب لاحقاً من عدد الـ tokens؛ بل سمة تُكتب عند الإصدار، لأن الأسعار تتغير وإعادة الحساب بأثر رجعي عبر نافذة احتفاظ طويلة هي حيث تموت مسارات التدقيق.
معرّفات الارتباط تنتشر عبر الحدود. يُنشأ معرّف التشغيل مرة واحدة، ثم يُمرَّر عبر ترويسات HTTP الصادرة وسياق جلسة قاعدة البيانات وبيانات وصفية لطابور الرسائل. الآلية الملموسة هي كائن سياق يحقنه وقت التشغيل ويقرأه كل محوّل، فلا تحتاج أداة تستدعي API خارجياً إلى معرفة أنها تُتتبَّع — غلاف عميل HTTP يرفق الترويسة، ومشغّل قاعدة البيانات يضبط متغير جلسة، وناشر الطابور ينسخ الحقل. عندما يسجّل خدمة لاحقة المعرّف نفسه، يُغلق الأثر من طرف إلى طرف دون خياطة يدوية.
يُعلَن أخذ العينات مسبقاً. التتبع كامل الدقة لكل تشغيل نادراً ما يكون ممكناً التكلفة عند الحجم الكبير. يحدد عقد وقت البناء سياسة أخذ العينات: أي التشغيلات تُتتبَّع دائماً (الإجراءات المرفوضة، التشغيلات عالية التكلفة، أول N لكل نشر)، وأيها يُؤخذ عشوائياً، وما يُسقَط. تُتخذ قرارات أخذ العينات عند الـ span الجذري حتى يكون التشغيل المُستبعَد غائباً باتساق بدلاً من أن يكون حاضراً جزئياً، وهو نمط الفشل الذي يجعل بيانات الأثر غير موثوقة.
مخطط span أدنى يبدو هكذا:
{
"trace_id": "run_8f2c...",
"span_id": "step_01",
"parent_span_id": null,
"kind": "model.invoke",
"started_at": "2025-01-01T10:00:00.000Z",
"duration_ms": 812,
"attributes": {
"model": "...",
"input_tokens": 1042,
"output_tokens": 233,
"cost_units": 0.0041,
"policy_decision": "allow",
"polic
المقايضة حقيقية: على كل محوّل أن يشارك، وأداة واحدة غير مجهّزة تكسر السلسلة. التخفيف هو جعل وقت التشغيل يرفض تنفيذ أداة لا تقبل كائن السياق — فحص وقت الترجمة أو وقت البدء بدلاً من رهان وقت التشغيل. هذا القيد غير محبوب لدى الفرق التي تريد إضافة الأدوات بسرعة، وهو ثمن أثر مكتمل فعلاً.

## من الآثار إلى الضوابط
الآثار لا تكون مفيدة إلا إذا أجابت عن أسئلة حول إجراءات محددة.
**القابلية للاستعلام هي اختبار التدقيق.** الأثر الذي لا يمكنك تصفيته حسب اسم الأداة أو بصمة الوسائط أو قاعدة السياسة أو الفاعل هو أداة تصحيح أخطاء، لا مسار تدقيق. هذا يعني أن المخطط يجب أن يتضمن الحقول التي يطلبها المنظّمون والمستجيبون للحوادث، لا فقط الحقول التي تصادف أن يصدرها الإطار. إذا لم يكن السؤال "أظهر كل تشغيل استدعى فيه الوكيل أداة الدفع دون span موافقة بشرية" قابلاً للإجابة باستعلام واحد، فالتجهيز ناقص.
**نبّه على الثوابت السلوكية.** أعداد الأخطاء أضعف إشارة في نظام وكيل، لأن نمط الفشل عادةً استدعاء ناجح ما كان ينبغي أن يحدث. الثوابت المفيدة بنيوية: معدل استدعاء الأدوات لكل تشغيل مقابل سقف معلن، والإنفاق لكل تشغيل مقابل سمة ميزانية، وعدد الإجراءات المرفوضة، ونسبة عمليات الاسترجاع إلى استدعاءات النموذج، وظهور أداة خارج مجموعة سياساتها المسموح بها. هذه قابلة للحساب من الـ spans ومستقرة عبر ترقيات النموذج، بخلاف عتبات الزمن الكامن التي تنحرف مع تغيرات المزوّد.
**الاحتفاظ والتنقيح ينتميان إلى المخطط.** تحديد الحقول التي تحتوي بيانات شخصية لاحقاً يعني إعادة معالجة الآثار التاريخية، وهو مكلف وغالباً مستحيل بمجرد زوال الحمولات الخام. بدلاً من ذلك، ضع علامة على كل سمة عند التعريف كـ محتفظ بها أو مُجزَّأة أو مُنقَّحة، ودع خط المعالجة يطبّق القاعدة عند الكتابة. المقايضة هي دقة تصحيح أقل للحقول المنقّحة، ومخطط يجب ترقيمه مع تغيّر قواعد التصنيف. هذه التكلفة أقل من اكتشاف، أثناء طلب وصول لصاحب البيانات، أن الـ prompts ومخرجات الأدوات موجودة في تخزين مزوّد رصد دون سياسة على مستوى الحقل.
## ما الذي يتغير عندما يصبح هذا متطلباً وقت البناء
إحصائية ربع الوكلاء تصف مجموعة لم تملك العناصر الأولية قط. الفرق التي تعرّف حدّ خطوة، وتنشئ معرّف تشغيل، وتنشره عبر كل محوّل، وتعلن أخذ العينات والاحتفاظ قبل الإطلاق، لا تواجه قرار مراقبة لاحقاً — بل تواجه ترحيل مخطط، وهو مهمة هندسية مفهومة جيداً. الجزء غير المريح أن هذا العمل يحدث قبل وجود أي مشكلة مرئية تبرره، وأنه يقيّد سرعة إضافة أدوات جديدة. تلك هي المقايضة الصادقة: تكامل أدوات أبطأ مقابل نظام يمكن إعادة بناء سلوكه واستعلامه والتحكم فيه. البديل هو أسطول من الوكلاء يُوثق به تحديداً لأن لا أحد يستطيع رؤية ما تفعله.
