قالب دليل إجراءات تشغيل الوكلاء AgentOps

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

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

اكتب الشاشة الأولى لمن يستقبل التنبيه

ابدأ باسم الخدمة والبيئة والمالك المسؤول ونسخة الدليل وتاريخ مراجعته. صف العرض بلغة يمكن رصدها: تقادم طابور التأكيد، أو عدم حسم نتائج الإرسال، أو تعذر الوصول إلى مصدر المستلمين المعتمد. عبارة «الذكاء الاصطناعي يتصرف بغرابة» أوسع من أن تحدد استجابة آمنة.

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

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

حقول قابلة للاستخدام في دليل التشغيل

حقول دليل تشغيل خدمة إشعارات تجديد العضوية

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

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

إجراء تطبيقي: نتائج إرسال غير محسومة

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

1. تأكد من النطاق المتأثر. طابق التنبيه بالنشر والدفعة، وافحص هل تتأثر هذه المجموعة وحدها أم دفعات أخرى أو مكوّن توصيل مشترك. سجل نسختي الوكيل والرسالة المعتمدة.
2. علّق الطلبات الجديدة بالتحكم المأذون. تحقق من سريان التعليق عند نقطة الإرسال. توقف واجهة المستخدم لا يكفي إذا ظل عامل خلفي قادراً على إرسال عناصر الطابور.
3. احتفظ بالطلبات السبعة غير المحسومة. سجل معرّفاتها الثابتة ومراجع الوجهة المتاحة وآخر حالة معروفة. لا تصنفها فاشلة لمجرد انتهاء مهلة الجهة المستدعية.
4. استعلم من الوجهة المعتمدة. سوِّ كل طلب بآلية الحالة المدعومة. وعند تعذر الأدلة، احتفظ بوصف عدم اليقين وصعّد وفق الإجراء المعتمد.
5. حدّد مصير العناصر الاثني عشر غير المرسلة. تحقق من استمرار صلاحية مصدر المستلمين واعتماد الرسالة. قد يستدعي انقضاء نافذة التجديد قرار أعمال بشأن الصياغة أو التوقيت.
6. استأنف مجموعة محدودة بعد الموافقة. راقب أدلة التأكيد المطلوبة وسلوك الطابور، ولا توسع الاستقبال قبل تحقق شروط الاستعادة.

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

اكتب المسارات البديلة وشروط التوقف

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

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

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

وثّق المكوّنات التي يعتمد عليها القرار

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

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

أثبت عودة السلوك المطلوب

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

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

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

اختبر الوثيقة مع شخص لم يكتبها

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

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

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

اضبط تغييرات الخدمة أثناء تنفيذ الإجراء

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

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

اربط التشغيل المعتاد بالاستجابة للحوادث

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

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