Yerel panel: çalışma alanın, ajanın gördüğü gibi

Yerel panel, çalışma alanını ajanının gördüğü şekilde gösteren küçük bir web uygulamasıdır: ürünler, ajanın her biri hakkında bildikleri, onboarding ilerlemesi, kaydedilmiş her gönderim durumu, senin ilgilenmen gereken işler ve takip tarihleri. Yalnızca senin makinende çalışır, hiçbir dizinle iletişim kurmaz ve değişiklik günlüğünde listelenen 15 Eylül 2026 sürümüyle eklendi. Bu rehber, paneli nasıl başlatacağını, her ekranın ne işe yaradığını ve uyguladığı kuralları anlatıyor.

Başlatma

Windows’ta aşağıdaki komutlarda python3 yerine py -3 kullan (Python 3.10+ komutun buysa python). Çalışma alanını OneDrive ya da başka senkronizasyon klasörlerinin dışında, özel bir yerel klasörde tut.

python3 scripts/dashboard.py            # opens 127.0.0.1:8765 in your browser
python3 scripts/dashboard.py --demo     # explore a throwaway sample workspace
python3 scripts/dashboard.py --port 8790 --no-open

Yalnızca Python 3.10+ standart kütüphanesini kullanır: bağımlılık yok, build adımı yok. Paneli, scripts/init-workspace.py betiğinin oluşturduğu klasör olan özel çalışma alanından çalıştır. Bunun yerine ortak teslimat kopyasından başlatırsan yalnızca o çalışma alanını oluşturmayı önerir. En kolay yol yine üç adımda başlangıç rehberindeki tek satırlık başlangıç promptudur: ajan çalışma alanını oluşturur, sunucuyu başlatır ve bağlantıyı sana verir.

Genel bakış

İlk ekran her şeyden önce “benim ne yapmam gerekiyor?” sorusunu yanıtlar: ajanın tamamlayamadığı CAPTCHA ve iki faktörlü doğrulama devirleri, engellendi olarak işaretlenen platformlar, süresi geçmiş takipler ve bitmemiş onboarding. Bunların altında, durum gruplarına göre toplamlarıyla ürünlerin (seni bekleyenler, sorunlar, incelemede, planlanmış, yayında) ve workspace.json dosyasından okunan çalışma alanı sağlığı yer alır. Paneli haftada yalnızca bir kez açıyorsan bakman gereken sayfa budur.

Ürün sayfası

Her ürün için doctor.py tarafından üretilen bir hazırlık kontrol listesi, son oturum özeti, filtrelenebilir gönderim listesi, onboarding kontrolleri, ürün özeti, kimlik, izinler ve notlar gösterilir. “Ajan görünümü” (agent view), hangi dosyaların doldurulduğunu ve hangilerinin hâlâ boş olduğunu listeler; bir oturum erken bittiğinde bir sonrakinin neyi soracağını bilmek istiyorsan işe yarar. Burada gösterilen durum terimleri takip aracınınkilerle aynıdır; her durumun ne anlama geldiğini listeleme durumu sözlük maddesi açıklıyor.

Bir çalıştırmayı planla ve devam ettir

10 yeni onaylı gönderim hedefi ve en fazla 2 worker ile başla. Çalıştırma planlayıcısı, bir paralel çalışma sınırı önermek için yerel donanım bilgilerini kullanır. Anlık yükü de gözden geçir: kapasite bilinmiyorsa ya da makine meşgulse tek worker seç. İki worker ayrıca ayrı ayrı kontrol edilen tarayıcı çalışma alanları ve farklı platform atamaları gerektirir; donanım önerisi tek başına bunu sağlamaz.

Çalıştırmayı kaydet, ardından promptunu ajanına kopyala. Ajan uygulaman destekliyorsa /goal kullan; desteklemiyorsa aynı metni normal bir mesaj olarak yapıştır. Panel planı saklar ve kalan işi gösterir, ancak ajan worker’larını başlatmaz ve tarayıcı işlemi yapmaz. Bir hedef, sağlayıcı limitlerini ya da insan müdahalesi gerektiren engelleri aşamaz.

Yalnızca onaylı yeni gönderimler sayılır: incelemeyi bekleyen, sıraya alınmış, planlanmış ya da yayında olanlar, platform başına bir kez. Taslaklar ve mevcut listelemeler sayılmaz. Önceki ilerlemeyi unutan yeni bir çalıştırma başlatmak yerine kaydedilmiş çalıştırmaya devam et. Tamamlanmayı, devirleri ve pencerelerin kapatılmasını çalıştırma rehberi açıklıyor.

Sonuç kaydı, katalog ve promptlar

Record outcome formu scripts/record.py üzerinden yazar ve komut satırındaki kuralların aynısını uygular: tanımlı durumlardan biri olmalı, notlarda bağlantı ya da sır bulunmamalı, live için herkese açık bir URL ve senin beyanın, scheduled için alt sınırda ya da sonrasında bir lansman tarihi gerekir, bir satır zaten varsa da açıkça değiştirmen gerekir. Bu kuralların her birini ve neden var olduklarını sonuçları kaydetme rehberi tek tek anlatıyor.

New product, templates/project şablonundan boş bir klasör oluşturur ve sana ya ajanın için onboarding promptunu ya da kendin dolduracağın formları verir. Catalog, tüm platformlarda arama ve filtreleme yapmanı, herhangi bir playbook’u okumanı, bir ürünün durumunu listenin üzerinde görmeni ve doğrudan listeden kayıt yapmanı sağlar. Agent prompts and docs, ajan promptlarını kopyalama düğmeleriyle gösterir ve araç seti belgelerini yerinde görüntüler; böylece markdown dosyalarını elle açman nadiren gerekir.

Asla yapmayacakları

Bu sınırlar bilinçlidir ve panele güvenmeden önce bilmeye değer:

• Yalnızca 127.0.0.1 adresine bağlanır ve siteler arası istekleri reddeder.
• Yalnızca ajanın da düzenlediği ürün JSON ve markdown dosyalarını düzenler. credentials.json platform, yöntem ve durum olarak gösterilir; içindeki değerler asla tarayıcıya gönderilmez.
• Hiçbir şey göndermez, tarayıcı kontrol etmez ve listeleme doğrulamaz. Bir durumu kaydetmek kanıt değil, bir operatör beyanıdır; panel bu beyanı vermeyi kolaylaştırır ve yanlış vermeyi zorlaştırır, o kadar.

Panelin ürün, ajan ve dizinler arasındaki yeri nasıl çalışır sayfasında çizilmiş. Kendi çalışma alanın olmadan denemek istersen --demo tam bunun için.