سجلات

دفاتر Trackio هي دفاتر تجارب قابلة للمشاركة لتسجيل المنطق، والأوامر، والنتائج، والأشكال، والمخرجات (نقاط الحفظ، مجموعات البيانات، إلخ)، ومسارات الوكلاء الكامنة وراء تجربة ما. يُخزَّن الدفتر محليًا في مجلد .trackio/logbook ضمن مساحة العمل، ويمكن معاينته محليًا أو نشره كفضاء Hugging Face ثابت.

موصى به لوكلاء البرمجة: أسهل طريقة لاستخدام Logbooks مع وكلاء البرمجة (مثل Codex وClaude Code وPi وOpenCode) هي ببساطة إعطاء وكيل البرمجة لديك هذه التعليمات:

trackio skills add
trackio logbook open
trackio logbook attach trace <path to current trace>

Work in this workspace's Trackio logbook. Before running any experiment or
script, create or select the relevant page with `trackio logbook page "..."`. Run every experiment command with `trackio logbook run -- <command>` ratherthan invoking it directly, which will log the code and its outputs into the logbook. 

لمزيد من التفاصيل والتحكم الدقيق، تابع القراءة!

ابدأ جلسة وكيل مع سجل

أسهل طريقة لاستخدام دفتر السجل هي إنشاؤه قبل أن يبدأ الوكيل بإجراء التغييرات أو تنفيذ التجارب:

trackio logbook open --title "Learning-rate sweep"

ينشئ هذا الأمر دفتر السجلات المحلي ويفتح معاينته. استخدم --no-serve عندما تريد فقط إنشاء دفتر السجلات المحلي أو الارتباط به. استخدم --no-browser لبدء المعاينة دون فتح متصفح، أو مرّر --port لاختيار منفذ مختلف.

امنح الوكيل مهارة Trackio

قم بتثبيت مهارة Trackio لوكيل البرمجة الذي تستخدمه. فيما يلي الطريقة الخاصة بـ Codex:

trackio skills add --codex

يقوم الأمر بتثبيت المهارة في المشروع وربطها لـ Codex. ابدأ جلسة Codex جديدة بعد التثبيت عند الحاجة حتى يتمكن من تحميل المهارة. لوكيل مدعوم آخر، استبدل --codex بعلمه الخاص، مثل --claude أو --cursor أو --opencode أو --pi.

تُوجّه المهارة الوكيل إلى تنفيذ الأكواد باستخدام trackio logbook run -- ... بدلاً من استدعاء أمر التجربة مباشرةً. يسجّل هذا الغلاف الأمر الدقيق، وسكربتات الإعدادات والملفات المكتشفة، والمخرجات، ورمز الخروج، والمدة، والمخرجات المدعومة. على سبيل المثال:

trackio logbook page "Baseline"
trackio logbook run -- python train.py --learning-rate 0.001

يجب أن يستمر سكربت التدريب في استخدام trackio.init() وtrackio.log() وtrackio.finish() بشكل طبيعي. عند وجود دفتر سجلات في مساحة العمل، يمكن لـtrackio.init() أيضاً إضافة خلية لوحة تحكم مباشرة للمشروع النشط في Trackio.

إرفاق تتبع الجلسة النشطة

أرفق سجل وكيل البرمجة الحالي قرب بداية الجلسة:

trackio logbook attach trace /absolute/path/to/current-session.jsonl --title "Agent session"

يحدد وقت تشغيل الوكيل (agent runtime) مكان تخزين محضره. ابحث عن ملف JSON أو JSONL الخاص بالمحادثة النشطة باستخدام مجلد الجلسة الخاص بذلك وقت التشغيل، ثم أرفق الملف الذي تتطابق طوابعه الزمنية وبياناته الوصفية مع الجلسة. يمكن إرفاق ملف JSONL نشط قبل انتهاء الجلسة؛ حيث يقوم Trackio بتحديثه أثناء فتح المعاينة المحلية. كما أن الإرفاق يُنشئ خط الأساس (baseline) للمساحة العاملة (Workspace)، مما يتيح ربط ملفات النماذج والبيانات المدعومة لاحقًا بالجلسة.

تقوم Trackio بإزالة الأسرار الشائعة من الأثر المرفق افتراضيًا. راجع الآثار قبل نشرها لأنها قد لا تزال تحتوي على موجهات، أو مدخلات أدوات، أو مخرجات أوامر، أو مسارات، أو بيانات شخصية. استخدم --no-scrub فقط لمصدر تم تعقيمه مسبقًا.

أنشئ الصفحات مع تطور العمل

عند فتح مساحة عمل تحتوي بالفعل على دفتر سجل، يتم الارتباط به. يتكوّن دفتر السجل من صفحات؛ أنشئ صفحة أو اخترها باستخدام:

trackio logbook page "Baseline"

إضافة محتوى التجربة

أضف Markdown، أو كودًا، أو أشكالًا، أو مخرجات، أو لوحة تحكم Trackio مدمجة:

trackio logbook cell markdown "Baseline accuracy: 82.4%" --page "Baseline"
trackio logbook cell code --page "Baseline" --code-text "print(metrics)" --language python
trackio logbook cell figure --page "Baseline" --image plots/baseline.png
trackio logbook cell artifact "my-project/model:v1" --page "Baseline" --type model
trackio logbook cell dashboard my-project --page "Baseline"

لتنفيذ أمر تجربة والتقاط أمرها ومخرجاتها وسكربتاتها وملفات المخرجات في خطوة واحدة:

trackio logbook run --page "Sweep" -- python train.py --learning-rate 0.001

تُسجَّل ملفات النموذج والبيانات الناتجة كخلايا مُنتَجات افتراضيًا. مرّر --no-artifacts لتعطيل ذلك الالتقاط.

قراءة دفتر السجلات برمجياً

trackio logbook read يُنتج عرضًا مُدمجًا ومناسبًا للوكلاء. يمكنه قراءة مساحة عمل محلية، أو معرّف مساحة منشورة، أو عنوان URL لدفتر السجل:

trackio logbook read
trackio logbook read pages
trackio logbook read page "Baseline"
trackio logbook read --json

استخدم trackio logbook read cell <cell-id> --full عندما يحتاج الخلية إلى فحص كامل. يُعدّ شكل JSON مفيدًا للأتمتة ووكلاء البرمجة.

نشر سجل

انشر دفتر السجلات الحالي إلى مساحة Hugging Face:

trackio logbook publish username/learning-rate-logbook

سجلات التشغيل المنشورة ثابتة وقراءة فقط. يخزّن المساحة (Space) بشكل افتراضي مراجع إلى مجموعات بيانات التتبع (trace datasets) ودلاء المخرجات (artifact buckets)؛ استخدم --public فقط عندما يجب أن تكون الموارد المشار إليها عامةً أيضًا. استخدم --private لجعل المساحة (Space) خاصة.