تتبعات الوكيل

تُدعَّم مسارات الوكلاء (Agent traces) من Claude Code وCodex وPi وHermes Agent وFactory Droid بشكل أصلي على Hugging Face Hub. ارفع جلسات JSONL الخام إلى Dataset أو Storage Bucket لفتحها في عارض مسارات مخصص. تعرض مجموعات البيانات المسارات في Data Studio؛ بينما تتيح لك الدلاء فتح ملفات .jsonl الفردية مباشرة.

This is a heading, so it should be translated as a noun phrase. "Traces" in the context of performance profiling or debugging refers to "تتبعات" or "سجلات التتبع". "سجلات التتبع" is more natural and precise in this technical context. "Find" is an imperative verb, so the translation should be an imperative noun phrase or a direct command. "ابحث عن" is a direct command. "سجلات التتبع الخاصة بك" means "your traces". ابحث عن سجلات التتبع الخاصة بك

تكتب معظم الوكلاء المدعومين جلسات JSONL إلى مجلدات محلية:

تُؤيَّد ملفات التتبع هذه بشكل افتراضي، لذا يمكنك رفعها دون الحاجة إلى تعديلها أو تحويلها أولاً.

يخزّن Hermes Agent الجلسات الحالية في قاعدة بيانات الجلسات الخاصة به. صدّر الجلسات التي تريد مشاركتها بصيغة JSONL قبل رفعها:

hermes sessions export session.jsonl --session-id <session_id>

هل تقوم ببناء إطار عمل خاص بك؟ إذا لم يكن وكيلك مدرجًا أعلاه، يمكنك جعل جلساته تُعرض في عارض التتبع من خلال إصدار Session Traces Format.

قد تتضمن ملفات التتبع (Trace files) أوامر استدعاء (prompts) ومدخلات الأدوات ومخرجات الأوامر والمسارات المحلية ولقطات الشاشة والبيانات السرية والكود الخاص والبيانات الشخصية. راجع ملفات التتبع واحذف أي معلومات حساسة منها قبل نشرها علنًا، أو أبقِ مجموعة البيانات أو الدلو (bucket) خاصًا إذا لم تكن متأكدًا مما تحتويه.

في جلسات Pi Agent، يمكن لـ pi-share-hf المساعدة في جمع جلسات المشروع، وإخفاء الأسرار المعروفة، وتشغيل TruffleHog ومراجعة LLM، ورفع الجلسات التي تجتاز الفحوصات فقط.

أسهل طريقة للرفع هي أن تطلب من وكيلك نفسه: وجّهه إلى المجلد أو ملف JSONL المُصدَّر أعلاه وأخبره برفع ملفات .jsonl إلى مجموعة بيانات أو حاوية على Hub.

تُعدّ الدلاء مفيدة بشكل خاص إذا كنت ترغب في مواصلة مزامنة المسارات مع وصول جلسات جديدة.

ارفع مساراتك

بعد إنشاء مجموعة بيانات أو حاوية، ثبّت hf CLI باستخدام المثبّت المستقل الموصى به وسجّل الدخول. يقوم المثبّت أيضًا بإعداد Hugging Face CLI Skill، مما يتيح لوكيل البرمجة لديك تنفيذ أوامر hf نيابةً عنك.

curl -LsSf https://hf.co/cli/install.sh | bash
hf auth login

hf upload <username>/<dataset-name> ~/.codex/sessions . --repo-type dataset
hf buckets sync ~/.codex/sessions hf://buckets/<username>/<bucket-name>/codex

استبدل ~/.codex/sessions بمجلد الجلسة المطابق لوكيلك، أو بمجلد يحتوي على ملفات JSONL مُصدَّرة من Hermes Agent. استخدم hf upload للمجموعات البيانات وhf buckets sync للمحاويط التي تريد تحديثها مع كتابة مسارات جديدة. الأمر الأقصر hf sync هو مرادف لـhf buckets sync.

عرض مساراتك

بمجرد أن تصبح لديك مسارات (traces) في مجموعة بيانات، افتح Data Studio وانقر على صف. أما بالنسبة للمسارات الموجودة في Storage Bucket، فتوجّه إلى ملف .jsonl الذي تريد فحصه وافتحه. يعرض عارض المسارات خط زمني للجلسة، والموجّهات (prompts)، ورسائل المساعد، واستدعاءات الأدوات، ومخرجات shell، ومكاتب الاستدلال، والنتائج.

كمثال عام، افتح TeichAI/DeepSeek-v4-Pro-Agent. يمكنك أيضًا تصفح المزيد من مجموعات البيانات الموسومة بـ traces.