Plan Studio’da çalışma

Bu kılavuz, Plan Studio’da planlarla nasıl çalışacağınızı gösterir. Orkestrasyonların ve plan belgelerinin ne olduğunu öğrenmek için Orkestrasyon ve Plan modunu kullanma sayfalarına bakın.

Bir plan açma

Bir plan, onu üreten konuşmaya aittir; dolayısıyla ona normalde oradan ulaşırsınız: konuşmadaki plan satırında bir Aç eylemi bulunur ve Plan Studio, konuşmanın yanında bir düzenleyici sekmesi olarak açılır.

Merkez üç bölüm listeler:

Aktif planlar — önce önerilenler olmak üzere orkestrasyonlar; durumları, adım sayıları ve revizyon numaralarıyla birlikte.
Plan belgeleri — tek bir ajanın plan modunda submit_plan ile gönderdiği ve hâlâ önerilmiş ya da onaylanmış durumda olan planlar.
Playbook’lar — kaydedilmiş, parametreli plan şablonları.

Bir kartı Plan Studio’da açmak için tıklayın. Rota /workspaces/<workspace-id>/plans/<kind>/<plan-id> biçimindedir; burada kind ya orchestration ya da document olur, böylece tek bir plana da derin bağlantı verebilirsiniz.

Bir orkestrasyon açtıysanız düzenlenebilir tuvali, sürüm zaman çizelgesini ve onay çubuğunu görürsünüz. Bir plan belgesi açtıysanız aynı grafik salt okunur olarak görüntülenir — plan belgelerini ajanlar yazar; siz onları inceler, tahmin eder ve onaylar ya da reddedersiniz; onaylanmış bir belge ise derlendiği orkestrasyondaki düğüm başına canlı çalıştırma durumunu gösterir.

DAG’ı düzenleme

Bir orkestrasyon, proposed durumundayken düzenlenebilir. Tuvaldeki tüm düzenlemeler klavyeyle yapılır:

Tuvale tıklayın, ardından seçimi ok tuşlarıyla hareket ettirin.
Bir adım eklemek için n tuşuna basın. “Yeni adım” olarak seçili görünür; sağdaki denetçide adını değiştirin.
Önce çalışması gereken adımda e tuşuna basın, ardından bağımlı adıma tıklayın (veya onu seçip Enter’a basın) ve böylece bir bağımlılık bağlayın. Bekleyen bir bağlantıdan vazgeçmek için Esc tuşuna basın.
Seçili adımın en yeni bağımlılığını kesmek için x tuşuna basın ya da denetçideki bağımlılık düzenleyicisinden tam bağımlılıkları açıp kapatın.
Seçili adımı kaldırmak için Delete tuşuna basın; ona yapılan başvurular kalan adımların bağımlılıklarından çıkarılır.

Denetçide ayrıca adımın açıklamasını, rolünü ve çıktı şemasını düzenleyebilirsiniz. Düzenlemeler kısa bir duraklamanın ardından otomatik olarak yeni bir revizyon hâlinde kaydedilir; bir doğrulama hatası (onay çubuğunda gösterilir) siz düzeltene kadar kaydetmeyi engeller.

Yalnızca iş adımları düzenlenebilir. Yapısal düğümler — araştırma, tartışma ve sentez — salt okunurdur; işi hâlihazırda çalışmış olan her adım da öyledir (“zaten çalıştırıldı” olarak işaretlenir, çünkü onu düzenlemek planı çatallar).

Kaydetme, başladığınız revizyon üzerinde iyimser eşzamanlılıkla yapılır. Orkestratör sizin altınızdan planı yeniden planlarsa, kaydınız birleştirilmek veya sessizce ezilmek yerine “the plan moved on” mesajıyla reddedilir; güncel revizyonu yeniden okuyun ve düzenlemenizi baştan yapın. Ajan tarafından başlatılan yeniden planlamalar da iki dakikada bir olacak şekilde sınırlandırılmıştır, bu yüzden bu durum ender kalır.

Maliyet, süre ve risk tahminlerini okuma

Onay çubuğunda Tahmin et’e basın.

Tuvaldeki her adım, bir maliyet aralığı ve bunun arkasındaki örneklem boyutunu gösteren bir rozet alır; adımın rolü hiç çalışmadıysa bunun yerine “Henüz geçmiş yok” görünür. Ayrıntıların tamamı için denetçiden bir adım seçin: örneklem boyutuyla birlikte maliyet aralığı, bir süre aralığı ve adımın kaynağından türetilen bir etki alanı (dosyalar ve semboller) — adımda kaynak bilgisi yoksa “bilinmiyor”.
Onay çubuğu plan toplamını gösterir: genel bir maliyet aralığı, kritik yol için bir süre aralığı (paralel dallar çakışır, dolayısıyla bu toplam değildir) ve plan bir üst sınır belirlediyse bütçe üst sınırı.
Yalnızca bazı adımların geçmişi varsa toplam kısmi olarak işaretlenir ve yalnızca tahmin edilebilir adımları kapsar. Tahminin üst ucu bütçe üst sınırını aşarsa toplam kırmızıya döner ve bütçe aşımı uyarısı gösterilir.

Tahminler ya dürüsttür ya da hiç yoktur: rolü için tamamlanmış çalıştırma geçmişi olmayan bir adım, hiç aralık vermeden sıfır örneklem boyutu bildirir ve tahmin edilmek yerine bilinmiyor olarak gösterilir. “Henüz geçmiş yok”u “kimse bilmiyor” olarak anlayın, “ucuz” olarak değil.

Bütçe üst sınırı, bu tahmine karşı yapılan bir gösterim karşılaştırmasıdır. Plan çalışmaya başladıktan sonra bunu hiçbir şey uygulamaz — harcamayı gerçekten durduran kontroller için Maliyetleri yönetme sayfasına bakın.

Bir revizyonu önceki bir öneriyle karşılaştırma

Her düzenleme ve orkestratörün yaptığı her yeniden planlama, yalnızca ekleme yapılabilen revizyon zaman çizelgesine eklenir; bu çizelge bir orkestrasyon planının solundaki Sürümler panelinde gösterilir.

Bir revizyonu güncel öneriyle karşılaştırmak için tıklayın. Seçim yapılmadığında panel, önceki revizyonu güncel revizyonla karşılaştırır.
Farkı panelin alt yarısından okuyun: iki revizyon arasında eklenen, kaldırılan veya değişen adımlar.
Plan hâlâ proposed durumundaysa, ona geri dönmek için bir revizyonun geri sarma simgesine tıklayın. Geri sarma, o öneriyi yeni bir revizyon olarak kaydeder — hiçbir şey kaybolmaz.

Plan artık proposed olmadığında hem propose_orchestration hem de düzenleyici değişiklikleri reddeder; böylece yürüyen bir çalıştırma, yürütme ortasında yapılan bir yeniden planlamayı almaz.

Bir planı onaylama, reddetme veya genişletme

Uygulamada önerilen bir plan tek bir karardır ve bütün olarak verilir: onay çubuğundaki Planı onayla veya Reddet. Planı onayla her zaman her adımı onaylar — önce bir alt küme seçmenin yolu yoktur. Öneride doğrulama hataları varken onaylama engellenir; bu hatalar düğmelerin yanında gösterilir.

Onaylama yalnızca operatöre açıktır. Bunun için bir MCP aracı yoktur; dolayısıyla bir ajan plan önerebilir ve planı revize edebilir, ancak asla onaylayamaz.

Bir orkestrasyon yürümeye başladığında çubuk değişir:

Bir adım çalıştırma ortasında soru sormak için durduysa, onu seçin ve sürdürmek için Düğümü sürdür’e basın.
Kısmi bir onayı, seçili adım ile onun dolaylı olarak bağımlı olduğu her şeye genişletmek için Seçilenleri onayla’ya basın (bir adım bağımlılıkları olmadan asla onaylanamaz). Bu kontrol, her orkestrasyonda yürütme çubuğunda bulunur; plan bütün olarak onaylandığında hiçbir işlem yapmaz.
Tüm orkestrasyonu durdurmak için Çalıştırmayı iptal et’e basın.

Kısmi olarak onaylanmış kümenin dışındaki adımlar ertelenmiş olarak görüntülenir ve siz kümeyi genişletene kadar çalışmaz.

Parametrelerle bir playbook çalıştırma

Bir playbook, hedefinde, adım başlıklarında, açıklamalarında ve istemlerinde tipli {{param}} yer tutucuları bulunan kaydedilmiş bir plan şablonudur. Değiştirme birebir yapılır — bir ifade dili yoktur; mantığa ihtiyacınız varsa bunun yerine bir pipeline kullanın.

Merkezin Playbook’lar bölümünde playbook’un üzerindeki Çalıştır’a basın (veya ⌘K paletini açıp playbook’u oradan seçin).
Parametreleri doldurun. Numaralandırma parametreleri açılır liste olarak görüntülenir; depo ve ajan parametreleri bir depo veya ajan referansı alır; isteğe bağlı parametreler varsayılan değerlerine döner.
Planın kendisine karşı önerildiği çapa bileti seçin, ardından onaylayın.

Bir playbook çalıştırmak yalnızca bir plan önerir — örneklenen orkestrasyon Plan Studio’da proposed olarak açılır ve siz orada onaylayana kadar hiçbir şey yürümez. Bir playbook’u kaldırmak için kartındaki çöp kutusu simgesine basın.

Ajanlar playbook’ları create_playbook ve run_playbook MCP araçlarıyla oluşturur ve çalıştırır; MCP araçları referansına bakın.

İlgili kılavuzlar

Plan modunu kullanma: bir ajanın submit_plan ile nasıl plan belgesi ürettiği
Bir orkestrasyon çalıştırma: konuşma tarafından tek onaylı yaşam döngüsü
Bir pipeline şablonu oluşturma: bir playbook’un ifade edemediği mantığa ihtiyaç duyduğunuzda
Pipeline çalıştırmalarını izleme: onaylanmış bir planın motor görünümü

İlgili kavramlar

Orkestrasyon