Skip to main content
استخدم هذه الوصفة عندما يحتاج سير عمل الوكيل إلى:
  • التشغيل عبر TypeScript Agent SDK
  • الاعتماد على البحث المُدار على الويب
  • إرجاع JSON منظّم صارم
  • استعادة JSON غير السليم شبه الصالح بطريقة حتمية

1. ثبّت حزم SDK

2. عرّف عقدًا ضيق النطاق للمخرجات

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

3. أنشئ الوكيل

استخدم parseOutput ليعيد وقت التشغيل بيانات مكتوبة النوع بدلًا من نص خام.

4. هيّئ محوّل Gateway مرة واحدة

هذه هي النقاط المهمة:
  • يحدد responseFormat مخطط المخرجات بوضوح
  • يفعّل plugins إصلاح استجابات JSON شبه الصالحة
  • يتيح gatewayTools البحث المُدار على الويب للنموذج
  • يفرض toolChoice استخدام أداة البحث عندما ينبغي أن يستند سير العمل دائمًا إلى المصادر

5. شغّل سير العمل

6. ما ينبغي التحقق منه في السجلات

بعد نجاح التشغيل، افحص تفاصيل الطلب وتأكد مما يلي:
  • ظهور أدوات البحث الأصلية المطلوبة على الويب أو نشاط البحث المُدار
  • حفظ نتائج البحث والاستشهادات
  • ظهور response-healing ضمن تنفيذ الإضافة فقط عند الحاجة إلى الاستعادة
  • مطابقة المخرجات النهائية لمخطط JSON المطلوب

7. متى تستخدم هذا النمط

استخدم هذه الوصفة عندما:
  • يكون سير العمل بحثًا لمرة واحدة في الغالب، لا حلقة عميقة من الأدوات المحلية
  • ينبغي للنموذج الاستناد إلى المصادر قبل الإجابة
  • يحتاج المستدعون اللاحقون إلى JSON مكتوب النوع بدلًا من النثر
لا تستخدم هذا النمط عندما:
  • يعرف سير العمل عناوين URL الدقيقة مسبقًا ويكفي phaseo:web_fetch
  • يحتاج الوكيل إلى أدوات محلية متقدمة أكثر من أدوات الموفّر الأصلية
  • يكون عقد المخرجات مرنًا لدرجة تجعل كلفة JSON الصارم أكبر من فائدته

أدلة ذات صلة

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