Hub documentation
Ajan İzleri
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.
OpenRouter üzerinden yönlendirilen istekler doğrudan bir kovaya (bucket) dışa aktarılabilir ve aynı görüntüleyicide açılabilir, bkz. OpenRouter Broadcast traces.
İzlerinizi bulun
Desteklenen çoğu ajan, JSONL oturumlarını yerel dizinlere yazar:
| Ajan | Yerel oturum dizini |
|---|---|
| Claude Code | ~/.claude/projects |
| Codex | ~/.codex/sessions |
| Codex arşivi | ~/.codex/archived_sessions |
| Factory/Droid | ~/.factory/sessions |
| Pi | ~/.pi/agent/sessions |
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
.jsonldosyaları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.
OpenRouter Yayınlama izleri
OpenRouter Broadcast, OpenRouter üzerinden yönlendirdiğiniz isteklerin izlerini bir Storage Bucket'a gönderebilir ve Hub bu dosyaları iz görüntüleyicide açar. Uygulamanızda veya ajanınızda hiçbir değişiklik yapılmadığından, OpenRouter üzerinden geçen her şey için çalışır: OpenRouter'a yönlendirilmiş Claude Code veya Codex, OpenCode ya da düz bir chat-completions uygulaması.
Kurulum için bir bucket oluşturun, bu bucket'a yazma erişimine sahip bir token'dan S3 kimlik bilgileri oluşturun ve OpenRouter'da Ayarlar > Gözlemlenebilirlik altında Hugging Face Storage Buckets'ı bir hedef olarak ekleyin. OpenRouter'ın Hugging Face Storage Buckets kılavuzu tüm adımları içerir.
Kova (bucket) özel olarak oluşturulur:
hf buckets create <username>/openrouter-traces --private
Dosyalar, tam istemleri, sistem istemlerini ve dosya yolları ile kabuk çıktısı gibi araç çıktılarını, ayrıca OpenRouter hesabınızı ve kullanıcı kimliklerinizi ile API anahtarının adını içerir. OpenRouter’ın kılavuzu, varlık kovası görünürlüğünü kapsamaz ve herkese açık bir kovayı herkes okuyabilir.
Her iz, {traceId}-{timestamp}.json adıyla ayrı bir JSON dosyası olarak kaydedilir. Varsayılan yol şablonu olan openrouter-traces/{date} ile, gün başına bir klasörde toplanırlar:
openrouter-traces/<date>/gen-<unix>-<id>-<timestamp>.json
Bir iz (trace), tek bir model isteğidir, tüm bir oturum değildir. Tek bir ajan turu genellikle birkaç model isteği oluşturur, bu nedenle üç turluk bir oturum yaklaşık on dosya üretebilir. Her dosya, o istek anına kadar olan konuşmayı içerir; bu da oturumun son dosyasının tüm oturumu barındırdığı anlamına gelir. Aynı oturuma ait dosyalar aynı trace.sessionId değerini paylaşır.
Bucket'teki bu .json dosyalarından herhangi birini açarak, izleme görünümü ile ham JSON arasında geçiş yapılabilen bir OpenRouter izi olarak görüntüleyebilirsiniz. Görüntüleyici; mesajları, araç çağrılarını ve sonuçlarını, modeli, token sayılarını (önbelleğe alınan tokenlar dahil) ve maliyeti gösterir. Alt bilgideki maliyet, oturum için değil, yalnızca o tek istek içindir.
Bu izleri okurken bilmeniz gereken iki şey:
- Görüntüler saklanmaz. OpenRouter, dışa aktarma işleminden önce mesajlardan çok modlu içeriği kaldırır ve görüntüleyici bunun yerine
[image]gösterir. - Bazı istekler eksik olabilir veya içerik içermeyebilir. OpenRouter’ın örneklem oranı ve API anahtarı filtreleri, bir hedefe gönderilen istekleri sınırlar ve Gizlilik Modu, istem ve tamamlama içeriğini kaldırır.