ثبات أثر طلبات الوكلاء وسلامة إعادة المحاولة

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

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

لا تجيب المهلة عن السؤال التجاري

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

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

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

عرّف ما يمثل القصد نفسه

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

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

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

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

اكتب عقد الوجهة قبل إضافة الإعادة

عقد ثبات أثر حجز قطع إصلاح

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

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

أغلق الفجوة بين منع التكرار والأثر

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

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

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

قيّد الإعادات بسياسة تصنيف للفشل

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

استخدم حدود محاولات وزمن منقضٍ وتأخيراً تدريجياً مناسباً للعقد. تجنب مضاعفة الإعادة في كل طبقة؛ فقد يعيد الوكيل والمكتبة والبوابة والعامل دون معرفة بعضهم. سجل المحاولات الفعلية عبر المسار واحترم حدود معدل الوجهة.

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

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

عامل العمل متعدد الخطوات كآثار لها مسؤولية

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

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

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

أعد التحقق من الصلاحية دون اختراع قصد جديد

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

ميّز استرجاع نتيجة عملية مخولة نُفذت سابقاً من تخويل أثر جديد. قد تختلف صلاحية فحص RSV-91 عن إنشاء حجز. تحدد ضوابط إجراءات الوكيل الاثنين وهوية من يتصرف الوكيل نيابة عنه.

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

اختبر نوافذ الفشل المؤثرة

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

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

استخدم تتبّع المهام والمحاولات لربط القصد بكل محاولة ومرجع وجهة. سؤال التحقيق المفيد هو «أي آثار تخص هذا القصد؟» لا «كم مرة استدعى النموذج أداة؟». احفظ ثبات المعرّفات عبر التعافي والنشر.

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

اجعل سلامة الإعادة من أدلة التسليم

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

اربط التصميم بـإدارة الإصدارات والرجوع كي لا تنشئ استعادة حالة داخلية قديمة مفاتيح جديدة لقصود نُفذت. جرّب الإعادة بالسجلات المخزنة فعلياً. وجود حلقة إعادة ليس دليلاً على سلامة التعافي.

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