الانتقال إلى المحتوى الرئيسي
أنشئ وكيل فرز بلغة TypeScript يأتي نموذجه ومطالبته وقواعد مزوّديه من إعداد مسبق في لوحة التحكم، كي لا يتولى الكود إلا سير العمل. في النهاية يُرجع قرار فرز بصيغة JSON صارمة، ويوقف الحالات التي تحتاج إلى شخص، ويعيد محاولة استدعاءات النموذج عددًا محدودًا من المرات، ويسجّل إخفاقات الـ Gateway مع المعرّفات التي تحتاج إليها للعثور عليها. يصبح السكربت جاهزًا للإنتاج بمجرد وجود الإعداد المسبق وتخزينك للتشغيلات المتوقفة، كما في حلقة الوكيل المستدامة. توجد نسخة جاهزة في packages/sdk/agent-sdk-ts/examples/support-triage-agent.ts.

أنشئه

1

أنشئ الإعداد المسبق

في الإعدادات → الإعدادات المسبقة، أنشئ support-triage مع النموذج الموجَّه وتفضيلات المزوّدين ومطالبة النظام الخاصة بالدعم ومعاملات فك ترميز ثابتة. يجب أن يدعم النموذج مخرجات JSON Schema. تشرح صفحة الإعدادات المسبقة كيف يُدمج الإعداد المسبق مع كل طلب.
2

التثبيت

3

اكتب الوكيل

triage-agent.ts
4

شغّله

لإنهاء حالة متوقفة، تابعها بقرار المراجع:

تحقّق من نجاحه

شغّل تذكرة روتينية واحدة وتذكرة خطرة واحدة، ثم تحقّق مما يلي:
  • في الإعدادات → الاستخدام → السجلات، يُظهر نموذج الطلب أن الإعداد المسبق قد استُخدم.
  • تنتهي الحالة الخطرة عند waiting_for_human مع وجود القرار في pause.payload.
  • يُسجَّل استدعاء النموذج المُعاد على الخطوة بوصفه modelAttempts، وتسجّل كل إعادة محاولة model.retrying.
  • يُسجَّل الطلب المحظور مع requestId وreason الخاصين به، ويُظهر الطلب نفسه في السجلات سبب حظره.

أبقِ إخفاقات الـ Gateway ظاهرة

لا تبتلع الأخطاء داخل دوال رد النداء الخاصة بالوكيل. التقط AgentGatewayError عند الحافة، وسجّل معرّفاته، ثم أعد رميه. بمجرد فشل التشغيل، تحتفظ حالته المحفوظة بالتفاصيل نفسها في run.errorDetails وsteps[n].errorDetails، كي تتمكن مهمة استرداد لاحقة من قراءتها بعد زوال الاستثناء. تأتي هذه الإخفاقات من سياسة الـ Gateway، لا من الوكيل، لذا فالطلب في السجلات هو المكان الذي تبحث فيه:
آخر تعديل في ٥ نوفمبر ٢٠٢٦