# 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şılabilecek 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: ```txt trackio skills add trackio logbook open trackio logbook attach 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 -- ` 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 defterini kullanmanın en kolay yolu, ajan değişiklik yapmaya veya deneyler çalıştırmaya başlamadan önce onu oluşturmaktır: ```sh 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: ```sh 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: ```sh 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: ```sh 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ı oturumle 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: ```sh trackio logbook page "Baseline" ``` ## Deney içeriği ekle Markdown, kod, şekiller, artefaktlar veya gömülü bir Trackio paneli ekleyin: ```sh 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: ```sh 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: ```sh 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 --full` komutunu 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: ```sh 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.