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