لماذا تحتاج إلى التتبع للوكلاء
ينفّذ الوكلاء عدة استدعاءات لـ LLM واستدعاءات للأدوات في كل طلب؛ ومن دون آثار تتبع، ستعمل دون رؤية واضحة.
لماذا تحتاج إلى التتبع للوكلاء درس مجاني في AI Agents على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في AI Agents، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة AI Agents 4 دروس في المجموع.
بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.
يصعب تصحيح أخطاء الوكلاء
قد تؤدي رسالة مستخدم واحدة إلى تشغيل 10 استدعاءات لـ LLM و5 استدعاءات للأدوات، مع زمن استجابة يبلغ 30 ثانية. وعندما يحدث خطأ ما، فإن قولكم "أعطى الوكيل إجابة غريبة" لا يخبركم بشيء.
التتبّع هو الطريقة التي تتيح لكم رؤية ما حدث فعليًا.
ما الذي يلتقطه التتبّع؟
بالنسبة إلى طلب مستخدم واحد:
- كل استدعاء لـ LLM: النموذج، والرسائل الواردة، والاستجابة الصادرة، وعدد الرموز، وزمن الاستجابة
- كل استدعاء لأداة: الاسم، والوسائط، والنتيجة، والخطأ
- ترتيب جميع الخطوات وتوقيتها
- الإجابة النهائية الظاهرة للمستخدم
السجلات لا تكفي
تفقد السجلات النصية البسيطة (عبارات الطباعة) بنية التتبّع — فلا يمكنكم معرفة استدعاء LLM المرتبط بطلب مستخدم معين، أو كيفية ترابط الخطوات في شجرة.
وتعالج أدوات التتبّع المهيكلة ذلك.
Span مقابل Trace
مصطلحان مستعاران من OpenTelemetry:
- Trace — تشغيل الوكيل بأكمله (طلب مستخدم واحد)
- Span — خطوة واحدة داخل التتبّع (استدعاء LLM أو أداة أو استرجاع)
- تملك Spans عناصر أصل، فتشكّل شجرة
A Concrete Trace Tree
Trace: user asks 'What is our return policy?'
|-- Span: retrieve_docs (12 ms)
|-- Span: llm_call_planner (820 ms)
| |-- tool_call: search_kb
|-- Span: tool_call: search_kb (340 ms)
|-- Span: llm_call_synthesise (1100 ms)
Total: 2.3 s, 8400 tokens, $0.012لماذا يتفوّق التتبّع على السجلات؟
- تُظهر البنية الشجرية علاقات الأصل والفرع
- يكشف التسلسل الزمني المتتالي الخطوات البطيئة
- تتراكم الرموز والتكلفة لكل تتبّع
- إعادة التشغيل: أعيدوا تشغيل التتبّع باستخدام prompt جديد لاختبار التغييرات
متى تضيف التتبّع؟
من اليوم الأول. يكشف التتبّع أثناء التطوير أخطاءً قد لا تلاحظونها عند تصحيح الأخطاء عبر الدردشة فقط. وإضافته بعد وقوع حادث في الإنتاج تكون متأخرة جدًا.
الخصوصية والتتبّع
تحتوي عمليات التتبّع على بيانات المستخدمين. تعاملوا معها كما تتعاملون مع السجلات:
- اطمسوا معلومات التعريف الشخصية قبل التصدير
- شفّروها أثناء التخزين
- التزموا بسياسات الاحتفاظ
التتبّع مقابل التقييمات
التتبّع = "ما حدث في هذا التشغيل الواحد". التقييمات = "ما مدى جودة أداء الوكيل على مجموعة اختبار". تحتاجون إلى كليهما، لكن التتبّع يأتي أولًا — فلا يمكنكم تقييم ما لا يمكنكم فحصه.
تكلفة التتبّع
يضيف التتبّع عبئًا على زمن الاستجابة بنسبة 1-2% ويزيد مساحة التخزين. بالنسبة إلى الوكلاء كثيري التفاعل، خذوا عينات (مثلًا: 10% من عمليات التتبّع بالكامل، و100% من حالات الفشل) بدلًا من التقاط كل شيء.
التهيئة اليدوية مقابل التهيئة التلقائية للتتبّع
تُجري بعض أُطر العمل (LangChain وLlamaIndex) التهيئة التلقائية — فتحصلون على عمليات التتبّع مجانًا. أما في الكود المخصص، فأحاطوا استدعاءات LLM والأدوات بمساعدات span.
معرّفات التتبّع في الأخطاء الظاهرة للمستخدم
عند فشل الوكيل، أعيدوا معرّف التتبّع إلى المستخدم:
"حدث خطأ ما. المعرّف المرجعي: trace-9c4a... اعرض هذا على فريق الدعم."
يمكن لفريق الدعم فتح التتبّع ومعرفة ما حدث بالضبط.
لماذا التتبّع؟
لماذا يُعد التتبّع المهيكل أفضل من تسجيل عبارات الطباعة البسيط للوكلاء؟
مراجعة
التتبّع أمر لا غنى عنه. أدمجوه منذ اليوم الأول. تغطي الدروس التالية ما ينبغي تسجيله والأدوات التي ينبغي استخدامها.
الأسئلة الشائعة
هل درس «لماذا تحتاج إلى التتبع للوكلاء» مجاني؟
نعم — نص درس «لماذا تحتاج إلى التتبع للوكلاء» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة AI Agents، انتقل إلى CoddyKit PRO. تتضمن دورة AI Agents 4 دروس في المجموع.
ماذا ستتعلم في «لماذا تحتاج إلى التتبع للوكلاء»؟
ينفّذ الوكلاء عدة استدعاءات لـ LLM واستدعاءات للأدوات في كل طلب؛ ومن دون آثار تتبع، ستعمل دون رؤية واضحة. تتمرن على AI Agents مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ AI Agents؟
لا تُشترط خبرة سابقة. AI Agents على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.
كم من الوقت يستغرق درس «لماذا تحتاج إلى التتبع للوكلاء»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس AI Agents هذا؟
نعم. كل درس في AI Agents يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- لماذا تحتاج إلى التتبع للوكلاء
- تسجيل استدعاءات الأدوات ومدخلاتها ومخرجاتها
- زمن الاستجابة والتكلفة لكل خطوة
- تصوير عمليات تشغيل الوكلاء (Langfuse وLangSmith)