Skip to main content
استخدم هذه الوصفة عندما يحتاج سير عمل الدعم إلى:
  • وراثة إعدادات التوجيه والموجّهات الافتراضية من إعداد مسبق في لوحة التحكم
  • إرجاع مخرجات منظمة صارمة
  • إيقاف الحالات الخطرة مؤقتًا لمراجعتها بشريًا
  • إبقاء إخفاقات البوابة ظاهرة في السجلات بدلًا من إخفائها داخل رمز الوكيل

1. ابدأ بإعداد مسبق

أنشئ إعدادًا مسبقًا مثل support-triage يتولى:
  • النموذج الموجّه افتراضيًا أو هدف الموجّه
  • تفضيلات مزودي الخدمة
  • موجّه نظام الدعم
  • معلمات فك الترميز الثابتة
وبذلك يركز رمز الوكيل على التحكم في سير العمل بدلًا من تكرار سياسات الطلبات.

2. حدّد عقدًا واضحًا لعملية الفرز

اجعل بنية المخرجات الأولى صغيرة بما يكفي ليفحصها المشغلون بسرعة.

3. أنشئ الوكيل المعتمد على الإعداد المسبق

يحل SDK القيمة preset: "support-triage" إلى صيغة الاسم المستعار للبوابة @support-triage.

4. هيّئ المهايئ المتصل بالبوابة

استخدم القيم الافتراضية للمهايئ للعناصر التي يجب أن تبقى ثابتة في كل عملية فرز:

5. شغّل سير العمل مع عدد محدود من محاولات الإعادة

إذا توقف التشغيل للمراجعة، فاستأنفه صراحةً:

6. تعامل مع إخفاقات البوابة كأحداث تشغيلية

لا تُخفِ الإخفاقات بابتلاعها داخل سلسلة استدعاءات الوكيل. بدلًا من ذلك، التقط AgentGatewayError صراحةً:
ثم:
  1. دع بيئة التشغيل تحفظ حالة التشغيل والخطوة failed
  2. افحص loaded.run.errorDetails أو loaded.steps[n].errorDetails في مسارات الاستعادة اللاحقة عندما لا يعود الاستثناء الأصلي في الذاكرة
  3. افحص تفاصيل الطلب بحثًا عن:
    • تطبيق الحواجز
    • تفاصيل التوجيه
    • تنفيذ الإضافات
    • معرّفات الطلب وبيانات مزود الخدمة
وهذا مهم بشكل خاص عندما:
  • يحظر أحد الحواجز الطلب
  • ترفض قائمة السماح في الإعداد المسبق النموذج المطلوب
  • تؤدي بيانات اعتماد مزود الخدمة أو عوامل تصفية التفعيل إلى إزالة المرشحين للتوجيه
  • يفشل إصلاح الاستجابة في استعادة JSON صالح وفق المخطط

7. ما ينبغي التحقق منه

بعد تشغيل ناجح وآخر يتضمن مخاطر عمدًا، تحقق مما يلي:
  • يعرض عرض تفاصيل الطلب الهدف المحدد بواسطة الإعداد المسبق
  • تتوقف الحالات عالية المخاطر عند waiting_for_human
  • تحتفظ خطوات النموذج المعاد تنفيذها بـ modelAttempts
  • تظل إخفاقات الحواجز أو الإعداد المسبق ظاهرة في تفاصيل الطلب ولا تُخفى ضمن استثناءات الوكيل

أدلة ذات صلة

آخر تعديل في ٢ أكتوبر ٢٠٢٦