Ajan İzleri

Claude Code, Codex, Pi, Hermes Agent ve Factory Droid'den gelen ajan izleri, Hugging Face Hub'da yerel olarak desteklenir. Ham JSONL oturumlarını bir Dataset'e veya bir Storage Bucket'a yükleyerek bunları özel bir iz görüntüleyicide açabilirsiniz. Dataset'ler izleri Data Studio'da gösterir; bucket'lar ise bireysel .jsonl dosyalarını doğrudan açmanıza olanak tanır.

İzlerinizi bulun

Desteklenen çoğu ajan, JSONL oturumlarını yerel dizinlere yazar:

Bu izleme dosyaları kutudan çıktığı gibi desteklenir, bu nedenle onları önce değiştirmeden veya dönüştürmeden yükleyebilirsiniz.

Hermes Agent, mevcut oturumları oturum veritabanında saklar. Yüklemekten önce paylaşmak istediğiniz oturumları JSONL olarak dışa aktarın:

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

Kendi harness'inizi mi oluşturuyorsunuz? Ajanınız yukarıda listelenmiyorsa, Session Traces Format yayınlayarak oturumlarını trace görüntüleyicide görüntüleyebilirsiniz.

İz dosyaları, istemler, araç girdileri, komut çıktıları, yerel yollar, ekran görüntüleri, gizli bilgiler, özel kod ve kişisel veriler içerebilir. İzleri kamuya açık olarak yayınlamadan önce inceleyip gizli bilgileri maskeleyin ya da içeriğin ne olduğunu tam olarak bilmiyorsanız veri setini veya kovayı özel olarak tutun.

Pi Agent oturumları için pi-share-hf, proje oturumlarını toplamak, bilinen gizli bilgileri maskelemek, TruffleHog ve LLM incelemesini çalıştırmak ve yalnızca kontrollerden geçen oturumları yüklemek için yardımcı olabilir.

Yükleme işlemini yapmanın en kolay yolu, ajanınızın kendisinden istemektir: Yukarıdaki dizine veya dışa aktarılmış JSONL dosyasına yönlendirin ve ona .jsonl dosyalarını bir Hub veri setine veya kovaya yüklemesini söyleyin.

Yeni oturumlar geldikçe izlemeleri senkronize etmeye devam etmek istiyorsanız, Buckets özellikle faydalıdır.

İzlerinizi yükleyin

Bir veri seti veya varlık kutusu oluşturduktan sonra, hf CLI'yi önerilen bağımsız kurulum aracını kullanarak yükleyin ve oturum açın. Kurulum aracı ayrıca Hugging Face CLI Skill bileşenini de yapılandırır, böylece kodlama aracınız sizin için hf komutlarını çalıştırabilir.

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 dizinini, ajanınıza ait eşleşen oturum diziniyle veya Hermes Agent’tan dışa aktarılmış JSONL dosyaları içeren bir dizinle değiştirin. Veri kümeleri için hf upload, yeni izler yazıldıkça güncellemek istediğiniz variller için hf buckets sync kullanın. Daha kısa olan hf sync komutu, hf buckets sync komutunun bir takma adıdır.

İzlerinizi görüntüleyin

Bir veri setinde izleriniz olduğunda, Data Studio'yu açın ve bir satıra tıklayın. Storage Bucket'taki izler için, incelemek istediğiniz .jsonl dosyasına gidin ve açın. İz görüntüleyici, oturum zaman çizelgesini, istemleri, asistan mesajlarını, araç çağrılarını, kabuk çıktısını, akıl yürütme bloklarını ve sonuçları gösterir.

Herkese açık bir örnek olarak TeichAI/DeepSeek-v4-Pro-Agent adlı veri setini açabilirsiniz. Ayrıca traces etiketiyle işaretlenmiş daha fazla veri setine göz atabilirsiniz.