Günlükler

Trackio logbook'ları, bir deneyin arkasındaki akıl yürütme, komutlar, sonuçlar, şekiller, artefaktlar (checkpoint'ler, veri setleri vb.) ve ajan izlerini kaydetmek için paylaşılabilir deney defterleridir. Bir logbook, çalışma alanındaki .trackio/logbook dizininde yerel olarak saklanır ve yerel olarak önizlenebilir veya statik bir Hugging Face Space olarak yayınlanabilir.

Kodlama ajanları için önerilen: Kodlama ajanlarıyla (ör. Codex, Claude Code, Pi, OpenCode) Logbooks kullanmanın en kolay yolu, kodlama ajanınıza bu talimatları vermenizdir:

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. 

Daha fazla ayrıntı ve ince ayarlı kontrol için okumaya devam edin!

Günlük defteriyle bir ajan oturumu başlatın

Bir günlük kullanmanın en kolay yolu, ajan değişiklikler yapmaya veya deneyler çalıştırmaya başlamadan önce günlüğü oluşturmaktır:

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

Bu, yerel günlük defterini oluşturur ve önizlemesini açar. Sadece yerel günlük defterini oluşturmak veya ona bağlanmak istediğinizde --no-serve kullanın. Önizlemeyi tarayıcı açmadan başlatmak için --no-browser kullanın veya farklı bir port seçmek için --port parametresini iletin.

Acenteya Trackio becerisini verin

Kullandığınız kodlama ajanı için Trackio becerisini yükleyin. Codex için:

trackio skills add --codex

Komut, beceriyi projeye yükler ve Codex için bağlantısını kurar. Gerekli durumlarda, becerinin yüklenebilmesi için kurulumdan sonra yeni bir Codex oturumu başlatın. Desteklenen başka bir ajan için --codex yerini, örneğin --claude, --cursor, --opencode veya --pi gibi ilgili bayrağı koyun.

Yetenek, ajanın bir deney komutunu doğrudan çağırmak yerine trackio logbook run -- ... ile kod çalıştırmasını söyler. Bu sarmalayıcı, tam komutu, algılanan betik ve yapılandırma dosyalarını, çıktıyı, çıkış kodunu, süreyi ve desteklenen çıktı artefaktlarını kaydeder. Örneğin:

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

Eğitim betiği yine trackio.init(), trackio.log() ve trackio.finish() fonksiyonlarını normal şekilde kullanmalıdır. Çalışma alanında bir günlük defteri (logbook) varsa, trackio.init() aktif Trackio projesi için canlı bir gösterge paneli hücresi de ekleyebilir.

Aktif oturum izini ekleyin

Oturumun başlangıcına yakın bir yere mevcut kodlama-ajanı transkriptini ekleyin:

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

Ajan çalışma zamanı, transkriptinin nerede saklanacağını belirler. Aktif konuşmanın JSON veya JSONL dosyasını, o çalışma zamanının oturum dizinini kullanarak bulun ve oturumla eşleşen zaman damgalarına ve meta verilere sahip dosyayı ekleyin. Aktif bir JSONL dosyası, oturum sona ermeden önce eklenebilir; Trackio, yerel önizleme açıkken dosyayı yeniler. Ekleme işlemi aynı zamanda Workspace temelini de oluşturur, böylece sonraki desteklenen model ve veri dosyaları oturumla ilişkilendirilebilir.

Trackio, varsayılan olarak ekli bir izden yaygın gizli bilgileri temizler. Yayınlamadan önce izleri gözden geçirin çünkü hâlâ istemler, araç girdileri, komut çıktıları, yollar veya kişisel veriler içerebilirler. --no-scrub bayrağını yalnızca zaten temizlenmiş bir kaynak için kullanın.

İş ilerledikçe sayfalar oluşturun

Zaten bir logbook içeren bir çalışma alanı açıldığında, bu logbook'a bağlanır. Logbook sayfalarından oluşur; bir sayfa oluşturun veya seçin:

trackio logbook page "Baseline"

Deney içeriği ekle

Markdown, kod, şekiller, artefaktlar veya gömülü bir Trackio paneli ekleyin:

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"

Bir deney komutunu çalıştırıp komutunu, çıktısını, betiklerini ve çıktı dosyalarını tek adımda yakalamak için:

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

Çıktı model ve veri dosyaları varsayılan olarak artefakt hücreleri olarak kaydedilir. Bu yakalamayı devre dışı bırakmak için --no-artifacts parametresini iletin.

Bir günlük defterini programatik olarak okuma

trackio logbook read komutu, kompakt ve ajan dostu bir görünüm üretir. Yerel bir çalışma alanını, yayımlanmış bir Space kimliğini veya bir logbook URL'sini okuyabilir:

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

Bir hücrenin tümüyle incelenmesi gerektiğinde trackio logbook read cell <cell-id> --full kullanın. JSON biçimi, otomasyon ve kodlama ajanları için faydalıdır.

Günlük yayımla

Mevcut günlük defterini bir Hugging Face Space'ine yayınlayın:

trackio logbook publish username/learning-rate-logbook

Yayınlanan günlük defterleri statik ve salt okunurdur. Space, varsayılan olarak iz veri kümelerine ve artefakt kovalarına referanslar saklar; yalnızca bu referans verilen kaynakların da herkese açık olması gerekiyorsa --public bayrağını kullanın. Space'i özel yapmak için --private bayrağını kullanın.