تنسيق تنفيذ وكلاء الذكاء الاصطناعي

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

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

نمذج حالة الأعمال قبل حلقة الوكيل

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

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

اجعل الحالات مفهومة. لا يحتاج كل تفكير للنموذج حالة دائمة؛ احفظ ما يلزم للاستئناف ومراجعة الأفعال المؤثرة وعرض وضع صادق. يوضح دليل البنية حدود المكونات.

امنح المهمة والعملية هوية مستقرة

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

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

تناقش AWS معرّفات طلب يقدمها المتصل لدعم التكرار الآمن في واجهات مصممة لمنع الأثر المكرر. يعتمد وجود الحماية على عقد النظام المستقبل. انظر مناقشة AWS Builders' Library.

افصل قرار النموذج عن الأمر الدائم

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

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

أعد فحص ما يتغير قبل التثبيت: التوافر وصلاحية المتصل وسريان الموافقة. قد يبطل المقترح أثناء الانتظار. يشرح دليل الإشراف البشري الموافقة ذات المعنى.

استخدم نقاط الحفظ للاستمرارية

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

تتيح آلية المقاطعة في LangGraph تعليق التنفيذ وحفظ الحالة لمدخل خارجي، وتشرح الوثائق متطلبات الحفظ والاستئناف. يظل التعامل مع الآثار الخارجية وإعادة التحقق مسؤولية التطبيق. انظر مقاطعات LangGraph.

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

صنّف الفشل قبل تكرار المحاولة

خطأ الشبكة المؤقت والحقل غير الصالح ورفض الصلاحية وغموض الكتابة ليست شيئاً واحداً. قد يهدر تكرارها بسياسة واحدة الموارد أو يتجاوز قراراً أو يكرر الأثر.

سياسة فشل مقترحة لمنسق إعارة معدات

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

تُكيّف السياسة مع الأنظمة الفعلية. يجب التحقق من النتائج القابلة للاستعلام والعمليات التي تدعم التكرار الآمن.

تتبّع سيناريو التثبيت غير المحسوم

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

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

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

اختبر السيناريو بإحداث فشل عند الحد المعني في بيئة مصرح بها. لا يثبت النجاح المعتاد التعافي من ضياع الرد. يشرح دليل التقييم فحص الوجهة بجانب الرسائل.

استخدم التعويض عندما يتطلبه العمل

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

توضح إرشادات Microsoft للمعاملات التعويضية أن التعافي بين الخدمات خاص بالتطبيق وقد لا يعيد الحالة الأصلية تماماً. وقد يفشل التعويض نفسه ويحتاج تتبعاً. انظر إرشادات نمط Azure.

احفظ معلومات التعافي المختار. لا تفترض أن إعادة تشغيل الوكيل تلغي حجزاً خارجياً، ولا تعتبر الإلغاء مكتملًا حتى تؤكد الوجهة أو تُصعّد الحالة صراحة.

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

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

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

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

احفظ إصدار المسار الذي سيُستأنف

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

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

ميّز حالة المهمة، التي تسجل ما فعله المسار، عن ذاكرة قد تفيد تفاعلاً آخر. يعالج دليل الذاكرة دورة الحياة المستقلة.

مكّن التشغيل من الفهم والتدخل

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

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

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