.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 سجل الاستدعاء الذي لم يحصل على نتيجة قبل أن يتابع. تشرح صفحة الحالة والموافقة التوقفات والموافقات.