تتبع مهام وكلاء الذكاء الاصطناعي

يربط تتبع مهام الوكلاء العمل الذي طلبه المستخدم بالتنفيذ واستدعاءات الأدوات والتسليم والقرارات اللاحقة. غرضه إعادة بناء السببية والنتيجة. وقد يفيد نص المحادثة أو سجل استدعاءات النموذج، لكن أياً منهما ليس تاريخ مهمة كاملاً تلقائياً.

الاختيار المركزي هو فصل هوية المهمة عن هوية التنفيذ. قد تتعدد المحاولات والآثار لمهمة واحدة، وقد تحتوي المحادثة عدة مهام. وقد يعالج عامل خلفي العمل بعد انتهاء الطلب الأول بوقت طويل. يحفظ التصميم المفيد هذه الفروق بدلاً من إجبارها على شجرة جلسة واحدة.

اختر المعرفات بحسب أسئلتها

يجيب معرف المهمة عن ماهية العمل، ومعرف المحاولة عن التنفيذ الذي حاول تقدمه. وتصف معرفات الأثر والمقطع العلاقات التقنية. ويحدد مرجع الإجراء الخارجي طلباً أو نتيجة في نظام آخر، بينما يحدد مرجع قرار المراجع تصرفاً بشرياً مخولاً. لا يفترض أن يحل أحدها محل الجميع.

استخدم معرفات لا تتضمن أسماء أو عناوين بريد أو تفاصيل سرية. احفظ ربطها بسجلات الأعمال الحساسة في نظام مضبوط. يجب أن يبقى الربط ممكناً بعد إعادة المحاولة أو استبدال العامل أو استبعاد الأثر من العينة.

وثق إنشاء المعرفات وملكيتها. إذا قبلت خدمتا دخول العمل نفسه، فإن منع ازدواج المهمة مسؤولية التطبيق؛ ولا يحلها اختلاف معرفي التتبع. يتناول دليل عدم تكرار الأثر وإعادة المحاولة الضابط المستقل لمنع آثار أعمال مكررة.

شبكة توضيحية: موجز البحث BR-64

لنفترض وكيلاً للتخطيط الداخلي يجهز موجزاً لمقارنة مواقع اجتماع باستخدام سجلات اصطناعية. تفحص المحاولة الأولى السعة وإمكانية الوصول بالتوازي. يتأخر بحث، فينتظر الوكيل توضيح متطلب من المخطط. يستأنف تنفيذ لاحق ويجمع الموجز. لا يحجز الوكيل موقعاً ولا يتواصل معه.

انتهاء فحص السعة أولاً لا يجعله سبب فحص الوصول؛ فكلاهما بدأ من التنفيذ نفسه. وينتمي الاستئناف إلى BR-64 لكنه محاولة مختلفة. ويؤثر توضيح المخطط في الموجز اللاحق حتى لو وصل من تطبيق مستقل له أثره الخاص.

شبكة المهمة والمحاولات للموجز التوضيحي

العنصر المسجل	العلاقة	المعنى
المهمة BR-64	مرجع عمل مستمر	موجز التخطيط المطلوب
المحاولة BR-64-A	تقدم المهمة	التنفيذ الأول قبل التوضيح
بحث السعة	عملية فرعية للمحاولة الأولى	طلب مصدر مرصود مستقلاً
بحث إمكانية الوصول	فرع مواز للمحاولة الأولى	طلب مستقل لم تسببه نتيجة السعة
قرار التوضيح	يحسم طلب مراجعة للمهمة	مدخل مخول للعمل اللاحق
المحاولة BR-64-B	المهمة نفسها مع ربط بالتسليم والتوضيح	تنفيذ جديد بالمتطلب المعدل
قبول الموجز	يحكم على إصدار الموجز الناتج	قرار أعمال مستقل عن انتهاء التنفيذ

هذا نموذج مفاهيمي للتطبيق، وليس صيغة نقل OpenTelemetry. حوله إلى الحزمة والمنصة المستخدمتين، وتحقق من قدرة المشغل على استعادة العلاقات. يشرح دليل OpenTelemetry المعيار الحالي وقرارات الإصدارات.

استخدم العلاقات الأبوية والروابط عمداً

يصف OpenTelemetry المقاطع والأحداث وروابط المقاطع لتمثيل التنفيذ والسببية. تفيد علاقة الأب والفرع للعمل داخل عملية، ويفيد الرابط عندما لا تمثل العلاقة طبيعياً كفرع بسيط في شجرة التنفيذ نفسها.

عند التفرع، سجل كل فرع مستقلاً وشرط الجمع. هل يحتاج الموجز إلى المصدرين، أم أحدهما، أم استثناء صريح من المراجع؟ تختلف المتابعة بعد نتيجة واحدة عن انتظار جميع الأدلة المطلوبة. احفظ المدخلات المستخدمة فعلياً، لا الاستدعاءات التي بدأت فقط.

وعند جمع عدة مسارات، قد تعتمد عملية لاحقة على نتائج متعددة. احفظ صلتها بكل مصدر وإصداره. لا تخترع تسلسلاً بفرز أوقات الانتهاء؛ فالخط الزمني عرض للأحداث، بينما تأتي السببية من العلاقات المسجلة وعقد التطبيق.

مرر السياق عبر القوائم وحدود العمليات

يشرح دليل تمرير السياق إرسال السياق في حامل واستخراجه لدى المستقبل. حدد بيانات الرسالة المسموح بها في التطبيق القائم على قوائم، وتحقق من توافق تسجيل المنتج والمستهلك. اختبر حداً غير متزامن فعلياً، لا دالتين في عملية واحدة.

احفظ مرجع المهمة المستمر مستقلاً عن سياق التنفيذ المؤقت. قد تعالج رسالة متأخرة بعد اختفاء العامل الأصلي. يجب أن يحدد الاستئناف المهمة وإصدار المدخل وسبب العودة. خزّن بيانات ربط معتمدة فقط، لا كائن تنفيذ كاملاً يحتوي بيانات اعتماد أو محتوى غير مقيد.

عامل سياق التتبع الوارد من خارج حدود الثقة كبيانات غير موثوقة. لا يمنح وصولاً ولا يصرح باستدعاء أداة. طبق المصادقة والتصريح بصورة مستقلة. معرفة معرف الأثر لا ينبغي أن تتيح قراءة المهمة المرتبطة به.

مثل إعادة المحاولة دون إعادة كتابة التاريخ

ميز إعادة المحاولة الداخلية لعميل المورد عن محاولة تطبيق جديدة لتقدم المهمة. قد تظهر الأولى داخل عملية منطقية واحدة بحسب التسجيل، بينما تحتاج الثانية إلى هوية وسبب مستقلين. سجل ما كان معروفاً قبل التكرار، خصوصاً عند غموض إجراء خارجي سابق.

لا تستبدل الإخفاق الأول بالنتيجة الناجحة الأخيرة. يحتاج المشغل إلى المحاولة الأولى وقرار التكرار ونتائج الإجراءات. وفي المقابل، لا تحسب المحاولات الداخلية كمهام أعمال جديدة مقبولة. تحفظ علاقة المهمة والمحاولة التفسيرين دون خلط.

في BR-64، يمكن ربط القراءة المتكررة للمصدر بعملية البحث ومحاولاتها. ولو كتب الوكيل في نظام أعمال، لسجل التتبع مراجع الإجراءات، بينما تحدد ضوابط التطبيق المستقلة جواز كتابة أخرى. وضوح الأثر دليل، وليس تنفيذاً لمنع الازدواج.

أظهر الانتظار والإلغاء والنتائج المتأخرة

انتظار المخطط حالة مشروعة غير نهائية. سجل طلب المراجعة ومدتها في دورة الحياة المستمرة. ينتهي مقطع التنفيذ بانتهاء عمله الفعلي، وتبقى المهمة مفتوحة. وعند الاستئناف، أنشئ التنفيذ الجديد واربطه بالحالة السابقة.

إذا ألغى المخطط BR-64 أثناء بحث جار، فسجل قرار الإلغاء وهل وصل إلى كل مكون نشط. لا تعيد نتيجة متأخرة فتح المهمة أو إصدار الموجز تلقائياً. يحتاج التطبيق إلى فحص حالة، ويبين الأثر طريقة التعامل مع الحدث المتأخر.

ميز طلب الإلغاء عن تأكيد التوقف. فقد تكمل خدمة خارجية عملاً قبلته. أبق هذا الغموض ظاهراً حيث يؤثر. يتناول دليل التعافي من الحوادث المطابقة والاحتواء عندما تكشف الآثار عملاً خارجياً ناقصاً أو ملتبساً.

سجل مراجع الأدلة لا تفكيراً داخلياً مفترضاً

يمكن تسجيل المدخلات والمخرجات وطلبات الأدوات والمصادر المختارة والتحقق وقرارات التطبيق المشاهدة. لا يكشف الأثر كل الحسابات الداخلية للنموذج. لا تصف تفسيراً مولداً بأنه بيان مثبت لسبب التصرف؛ وإذا جمعته، فحدد مصدره واعتبره مخرجاً آخر يحتاج إلى تقييم.

سجل إصدارات التعليمات والمصادر وعقد الأداة وإعداد التشغيل اللازمة للفهم. لا يفيد المرجع إلا إذا أمكن للمحقق المخول الوصول إليه لاحقاً. وعندما لا يلزم المحتوى الكامل أو يكون حساساً، احتفظ بمقتطف معتمد أو مرجع ذي سياسة وصول واحتفاظ موثقة.

تميز اصطلاحات GenAI الحالية للوكلاء استدعاء الوكيل عن تنفيذ الأداة. طابق الخصائص التقنية مع الإصدار المنطبق واحتفظ بمعاني الأعمال صريحة. يساعد عقد حقول الرصد على منع تحول الحقول المخصصة إلى نصوص عشوائية بلا تعريف.

تحقق من الشبكة بمنظور المحقق

جهز شبكات متوقعة لمهمة سليمة وتفرع ومحاولة مكررة وانتظار وإلغاء وفقد رصد. قارن العلاقات المسجلة بها. واطلب من مهندس لا يعرف التنفيذ شرح الأدلة التي أنتجت الموجز المقبول والنتائج السابقة التي استبدلت.

افصل وقت الحدث عن وقت الاستقبال. قد يشوه تأخر التصدير واختلاف الساعات الخط الزمني. احفظ المراجع السببية وسجل عدم يقين التوقيت عند الحاجة. يجب أن تدفع مدة تبدو سالبة إلى فحص الساعات أو التحويل، لا إلى اختراع قصة عن ترتيب التنفيذ.

طابق الشبكة مع المهام المقبولة. قد تترك العينات أو فقد التصدير آثاراً جزئية، فأظهر حدود الاكتمال. احفظ حداً أدنى لحالة المهمة عندما يتطلب العقد ذلك. وقد تحتاج أدلة التدقيق إلى اكتمال ووصول أشد من أثر تشخيص مأخوذ بالعينة.

مخرجات تتبع مفيدة

سلم قاموس المعرفات وخريطة الأحداث والعلاقات وقواعد تمرير السياق وسياسة المحتوى وحالات آثار معروفة. أدرج استعلامات المشغل لإعادة بناء كل حالة. تجعل هذه المواد تحديث الحزمة أو نقل المنصة قابلاً للاختبار دون الاعتماد على المطور الأصلي.

ناقش تصميم تتبع مهام وكلائك مع مسار يخفي التفاصيل الحساسة ويشمل قائمة أو تكراراً أو تسليماً بشرياً. يمكن تحديد نطاق خدمات AgentOps حول فجوات الأدلة والقرارات. الهدف تاريخ مهمة يساعد المخول على فهم ما وقع وتحديد الخطوة التالية.