أعد محاولة طلبات النموذج الفاشلة
0. تسجّل كل خطوة عدد المحاولات التي استغرقتها في حقل محاولات النموذج (modelAttempts أو model_attempts أو ModelAttempts). لا تُعاد محاولة إلا طلبات النموذج: تتبع أخطاء الأدوات سياسة الخطأ الخاصة بكل أداة، لذا ضع إعادة المحاولات للأدوات ذات الآثار الجانبية داخل الأداة نفسها واجعلها متساوية القوة (idempotent).
يختلف الانتظار بين المحاولات وأي الأخطاء تُعاد محاولتها حسب اللغة:
مع انتظار خطي وفاصل 500 ms، تنتظر ثلاث إعادات محاولة 0.5 s ثم 1 s ثم 1.5 s.
تحقّق من المخرجات النهائية
عندما يجيب النموذج دون استدعاء أداة، يحوّل المحلّل النص النهائي إلى قيمتك ويتحقق منها المخطط. إذا فشل أيٌّ منهما، يفشل التشغيل بالخطأInvalid agent output: ...، لذا تتوقف المخرجات السيئة عند حدود الوكيل. أبقِ المدقّقات حتمية وخالية من الآثار الجانبية.
لسلوك أكثر صرامة من النموذج، اطلب أيضًا من Gateway مخرجات منظَّمة. اضبط تنسيق استجابة JSON Schema (واختياريًا إضافة response-healing) على عميل وكيل Gateway:
response_format/responseFormat وplugins. لا يوجد في Go وC# وJava خيار لتنسيق الاستجابة؛ اضبط الحقل عبر منفذ العميل للحقول الأخرى في الطلب (القسم التالي).
احتفظ بإعدادات التوجيه الافتراضية في إعداد مسبق
اضبطpreset على الوكيل (Preset في Go وC#) عندما ينبغي أن تبقى الإعدادات الافتراضية للتوجيه أو المطالبة أو المعاملات في لوحة التحكم:
preset في Rust.
اضبط إعدادات Gateway الافتراضية على العميل
يحمل عميل وكيل Gateway (createGatewayAgentClient() وcreate_gateway_agent_client() وCreateGatewayAgentClient) القيم الافتراضية للطلبات لكل دور للنموذج، لذا لا تعيد بناءها في كل تشغيل. يظل الوكيل هو من يحدد model وinput وinstructions وأدوات الدوال الخاصة به؛ ولا يُطبَّق النموذج الافتراضي إلا عندما لا يحدد الوكيل نموذجًا.
تأخذ Java وRust خيارات أقل:
تشرح صفحة معاملات Responses كل حقل. لقراءة الاستخدام والتكلفة والحالة من النتيجة، راجع المراقبة.