الانتقال إلى المحتوى الرئيسي
شغّل وكيلًا يستخدم الأدوات عبر TypeScript Agent SDK واحفظ حالته بعد كل خطوة، كي تتابع العملية التي تعطّلت أو أُعيد تشغيلها من حيث توقفت. في النهاية يكون لديك سكربت واحد يجيب عن سؤال حول الوثائق باستخدام أداة بحث، ويكتب كل تشغيل إلى .agent-runs/<run id>.json، ويستأنف التشغيل عندما تمرّر معرّفه. السكربت توضيحي: مخزن الملفات يناسب جهازًا واحدًا. في الإنتاج، احتفظ بزوج load/save نفسه لكن اجعل قاعدة بياناتك خلفه. لا يخزّن Phaseo تشغيلات Agent SDK نيابةً عنك.

أنشئها

1

التثبيت

تثبّت @phaseo/agent-sdk الحزمة @phaseo/sdk معها. اضبط مفتاحك:
2

اكتب الوكيل

agent.ts
3

شغّلها

لاختبار الاستئناف، أوقف السكربت بـ Ctrl+C بعد أول سطر checkpoint، ثم مرّر معرّف التشغيل الذي طبعه (UUID):

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

  • يطبع السكربت checkpoint مرة لكل خطوة، ثم معرّف التشغيل وcompleted وإجابة تتضمن رابط phaseo.app/docs.
  • يحتوي .agent-runs/<run id>.json على معرّف التشغيل وحالته وسجل الرسائل واستدعاءات الأدوات ونتائجها في كل خطوة والمخرجات النهائية.
  • بعد تشغيل مقطوع، يُكمل أمر الاستئناف معرّف التشغيل نفسه بدلًا من بدء تشغيل جديد.
  • يظهر كل دور للنموذج في الإعدادات → الاستخدام → السجلات. سجّل معرّف التشغيل بجانب كل معرّف طلب كي تتمكن من مطابقتهما.

ما تحتويه الحالة المحفوظة

كل نتيجة محفوظة هي AgentRunResult كاملة: run (المعرّف والحالة والرسائل والاستخدام وأي توقف)، وsteps مع معرّفات طلبات الـ Gateway واستدعاءات الأدوات الخاصة بها، وoutput بعد اكتمال التشغيل. تقبلها continueRun() مباشرةً، أو تقبل runId مع state فتستدعي load() بنفسها. قد يكون استدعاء الأداة الذي كان قيد التشغيل عند توقف العملية قد أحدث أثره بالفعل، لذا اجعل الأدوات متساوية القوى (idempotent). يُصلح SDK سجل الاستدعاء الذي لم يحصل على نتيجة قبل أن يتابع. تشرح صفحة الحالة والموافقة التوقفات والموافقات.

وسّعها بحذر

احتفظ بوكيل واحد لكل سير عمل، وقائمة أدوات قصيرة، وسطر سجل واحد لكل تشغيل يتضمن معرّف التشغيل ومعرّفات الطلبات. عندما تحتاج إلى توقفات للموافقة أو عدة وكلاء يتشاركون الأدوات، احتفظ بزوج عميل الـ Gateway والحالة هذا وابنِ حولهما: يضيف وكيل مراجعة الشيفرة توقفًا للموافقة، ويشغّل الأدوات المتوازية الأدوات جنبًا إلى جنب. للإعدادات الافتراضية المشتركة للطلبات، استدعِ إعدادًا مسبقًا بدلًا من نموذج ثابت.
آخر تعديل في ٥ نوفمبر ٢٠٢٦