مركز تعلّم الذكاء الاصطناعيEnglish
ترجمة عربية جديدة ✦ نراجعها باستمرار لتحسينها.

الأخطاء وإعادة المحاولة والآثار الجانبية

⁧أعِد المحاولة تحت الحلقة، واجعل التكرار آمنًا⁩⁧الأعطال العابرة تُعالَج داخل الأداة؛ والنموذج لا يرى إلا القرارات — وكل أثر جانبي يفترض التنفيذ مرة واحدة على الأقل⁩⁧حلقة النموذج⁩⁧لا ترى إلا الأخطاء التي تحتاج قرارًا — فكل إعادة⁩⁧محاولة ظاهرة تكلّف خطوة كاملة وقد تغيّر الاستراتيجية⁩⁧يحتاج قرارًا — أظهِره⁩⁧عابر — لا يظهر أبدًا⁩⁧طبقة الأداة⁩⁧انتهاء المهلة، وحدود المعدّل، والانقطاع القصير تُعاد⁩⁧هنا بتأخير متزايد محدود — دون أن يراها النموذج⁩⁧إعادات المحاولة تتراكب بشكل سيئ⁩⁧الوكيل الذي يعيد محاولة أداة⁩⁧تعيد المحاولة داخليًا قد⁩⁧يُثقل تبعية متعثّرة أصلًا⁩⁧السقف يوضع في بيئة التشغيل⁩⁧حدّد طبقة إعادة المحاولة⁩⁧لكل أداة، واذكر التوقيت في⁩⁧الوصف، وضع سقفًا لإجمالي⁩⁧المحاولات لكل أداة في كل تشغيل⁩⁧عدم التأثّر بالتكرار — «مرة على الأقل» هو الافتراض الصادق لأي أثر جانبي⁩⁧معرّف التشغيل + الإجراء المنطقي⁩⁧مفتاح ثابت لمنع التكرار⁩⁧رُئي من قبل؟⁩⁧لا ← نفّذ، وسجّل المفتاح⁩⁧نعم ← أعِد النتيجة الأصلية⁩⁧اشتقّ المفتاح من النيّة، لا من نص الوسائط الذي كتبه النموذج — وإن لم يوفّر النظام اللاحق شيئًا، فاحتفظ بالسجل بنفسك⁩⁧الفشل بعد إنجاز جزئي — مصدر أسوأ الحوادث⁩⁧أُنشئ السجل⁩⁧فشل الإشعار⁩⁧التقرير: «فشل»⁩⁧النموذج يعيد المحاولة⁩⁧سجلّان⁩⁧فضّل العمليات الذرّية · وإلا فأبلغ بدقة بما حدث وما لم يحدث، مع المعرّفات · وأتِح الإجراء التعويضي⁩
⁧أعِد محاولة الأعطال العابرة داخل الأداة، واجعل كل أثر جانبي آمنًا عند التكرار، وأبلغ عن الإنجاز الجزئي بدقة لا كفشل⁩

أعِد المحاولة تحت الحلقة لا داخلها

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

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

عدم تكرار الأثر ليس اختياريًا هنا

الوكلاء يعيدون المحاولة، ويعيدونها بشكل غير حتمي، ما يجعل التنفيذ مرة واحدة على الأقل (At-least-once) هو الافتراض الصادق لأي أداة ذات أثر جانبي. وهذا يعني رسائل مكررة، ومدفوعات مكررة، وتذاكر مكررة، وسجلات مكررة، ما لم تُبنَ الأداة لمنع ذلك. والآلية المعيارية تنطبق: اشتقّ مفتاح عدم تكرار (Idempotency key) ثابتًا من معرّف التشغيل مضافًا إليه الفعل المنطقي، واجعل الأداة تسجّله، وأعِد النتيجة الأصلية عند التكرار بدل تنفيذ الفعل مرة أخرى. وتأكد أن المفتاح مشتق من القصد لا من المعاملات كما صاغها النموذج، لأن إعادة المحاولة بحقل نص حر أُعيدت صياغته يجب أن تُعرف على أنها الفعل نفسه. وحيث لا يقدّم النظام التابع أي دعم لعدم تكرار الأثر، نفّذ السجل في طبقة الأدوات لديك، لأن ترك هذا لحسن تقدير النموذج سيفشل في مرحلة ما.

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

الآثار الجزئية والفعل المنجز نصفه

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

  • أسوأ الحوادث تأتي من إخفاقات بعد إنجاز جزئي، يُبلَّغ عنها كفشل كامل
  • فضّل العمليات الذرّية؛ وحيث يتعذر ذلك، بلّغ بالضبط بما حدث وما لم يحدث
  • أعِد المعرّفات عند النجاح الجزئي كي تُكمل الخطوة التالية العمل بدل أن تبدأ من جديد
  • أتِح الأفعال التعويضية كأدوات حيث لا تتوفر الذرّية ولا عدم تكرار الأثر