الانتقال إلى المحتوى الرئيسي
مرّر إعداد DevTools إلى تشغيل أو متابعة أثناء التطوير لإلحاق سطر JSON واحد لكل تشغيل بالملف generations.jsonl في مجلد محلي. يتضمن كل سطر مدخلات التشغيل وخطواته ونشاط الأدوات والمخرجات والاستخدام ومعرّفات طلبات Gateway. لا يُلتقط أي شيء ما لم تفعّله.
لا يتوفر التقاط DevTools في Rust 0.2. استخدم خطافات دورة الحياة مع run_with_events واكتب الأحداث بنفسك.

فعّل الالتقاط من البيئة

في غياب إعداد DevTools، يُفعَّل الالتقاط عندما تكون PHASEO_DEVTOOLS=true. تُكتب الملفات في PHASEO_DEVTOOLS_DIR، أو في .phaseo-devtools داخل مجلد العمل إذا لم يكن مضبوطًا. يعمل هذا بالطريقة نفسها في كل لغة تتوفر فيها DevTools.

ما الذي يُكتب

قيمة type لكل إدخال هي agent.run للتشغيل وagent.continue للمتابعة. agent.continue نوع إدخال وليس اسم دالة: إنه ما يكتبه استدعاء continueRun() (TypeScript وPHP وJava) أو continue_run() (Python وRuby) أو Continue (Go) أو ContinueRun (C#). يتضمن الإدخال معرّفي التشغيل والوكيل، وعدد الأدوات، ونتيجة التشغيل كاملة: الحالة والرسائل والخطوات مع النموذج والمزوّد ومعرّفات طلبات Gateway، ونشاط الأدوات والاستخدام والمخرجات. يحصل التشغيل الفاشل على إدخال يتضمن الخطأ (error.message في Go وJava؛ وتفاصيل فشل منظَّمة في TypeScript). في Java تُتجاهل أخطاء الكتابة، لذا لا يتسبب الالتقاط أبدًا في فشل التشغيل.
تحتوي الإدخالات على المطالبات والرسائل وسياق التطبيق ومدخلات الأدوات ومخرجاتها كنص عادي. أبقِ المجلد خارج نظام التحكم بالمصدر وصور الإنتاج، ولا تستخدمه مخزنًا للتدقيق. لقياسات الإنتاج عن بُعد، استخدم خطافات دورة الحياة.
آخر تعديل في ٥ نوفمبر ٢٠٢٦