Plan modunu kullanma

Bu kılavuz, bir ajan daha hiç kod yazmadan ondan yapılandırılmış bir plan almayı gösterir.

Plan modunda ajan salt okunur biçimde araştırır ve tek teslimatı tipli bir plandır: onayladığınız adımlardan oluşan bir bağımlılık grafiği; Control Center bunu daha sonra gerçek işe derler. Bir değişikliğin kapsamını görmek, adımların bölünmesini sağlamak ya da herhangi bir şeye dokunulmadan önce risklerin ve bağımlılıkların adlandırılmasını istediğinizde bunu kullanın.

Bir alanı plan moduna geçirme

Aşağıdakilerden herhangi biri alanın modunu değiştirir ve değişiklik kalıcı olarak saklanır:

İleti alanı araç çubuğunun en solundaki mod açılır menüsünden Plan’ı seçin
Shift+Tab tuşlarına basın
/plan gönderin. Tek başına /plan yalnızca modu hazırlar; /plan <request> modu hazırlar ve geri kalanını iletiniz olarak gönderir

/plan hiçbir zaman metin olarak iletilmez — saklanan modu ayarlar; araç yüzeyinin, koruyucu ön ayarının ve istemin hepsinin temel aldığı yetkili kaynak budur. Böylece mod bu tur ve siz onu geri değiştirene kadar sonraki her tur için geçerli kalır.

Mod alanda saklanır; dolayısıyla aynı ajan burada plan modunda, başka bir yerde ise ajan modunda olabilir.

Ajanın ne ürettiği

Salt okunur biçimde araştırır — bellek, kod dizini, dosyalar
submit_plan’ı bir kez çağırır; bir goal ile birlikte, her biri kararlı bir key, bir title, bir description ve dependsOn ile bağlandığı düğüm anahtarlarını taşıyan nodes gönderir (bağımsız işlerin paralel çalışmasını sağlayan şey budur)
Durur

Araç grafiği doğrular — yinelenen anahtarlar, sarkan bağımlılıklar, döngüler — ve bozuk bir planı kabul etmek yerine düzeltmesi için ajana ihlalleri döndürür.

Plan, konuşmanın içinde hedefi, durumunu ve adım sayısını gösteren kompakt bir satır olarak görünür. Plan Studio — bağımlılık grafiği, düğüm başına denetçi ve maliyet tahmini — konuşmanın yanında bir sekme olarak açılır: satırdaki Aç düğmesine basın ya da yalnızca bekleyin; çünkü siz konuşmayı izlerken 30 saniye içinde gelen bir plan sekmesini kendisi açar.

İstek belirsiz olduğunda bir plan ajanı duraklayıp ask_user aracıyla size en fazla üç engelleyici soru sorabilir. Konuşmada bir form oluşturur — seçenekler ya da serbest metin — ve çalıştırma siz yanıtlayana kadar engellenir. Araç okuma kademesindedir; dolayısıyla plan modunun salt okunur yüzeyinde ayakta kalır ve onay sarmalayıcısından muaftır (bir istemin önüne konan bir istem, bağlı bir onaylayıcı olmadığında kapalı olarak başarısız olur ve ajanı sorma eyleminden yoksun bırakır).

İçine çizilecek bir alana ihtiyaç duyar; dolayısıyla konuşması olmayan tek seferlik bir gönderim bunu elde edemez. Kapsamı, hedef depoyu ve kabul ölçütlerini ilk iletinizde önden vermek yine de gidiş dönüşten daha hızlıdır.

Burada düzyazı bir teslimat değildir. submit_plan çağırmadan sona eren bir çalıştırma, konuşmada görünür bir “Ended without submitting a plan (no submit_plan call).” satırı yayımlar ve çalıştırmayı teslimatını kaçırmış olarak işaretler. Çalıştırmanın durumu bilinçli olarak completed kalır — bu, pipeline ve bilet durum makinelerini dokunulmamış tutar — dolayısıyla durum rozetini değil, o satırı okuyun.

Planı onaylama

Konuşmadaki plan satırından Onayla ve çalıştır’a basın. Plan Studio’nun onay çubuğundan Planı onayla’ya (ya da yanındaki Reddet’e; grafikte bir doğrulama hatası varken onay devre dışıdır) basın.

Sonra:

Control Center planı bir orkestrasyona derler ve somutlaştırır — biletler ve çalıştırma. Bu adımda hiçbir model yer almaz; süreç deterministiktir
Plan, onu yazan ajan olarak yürütülür. Başka birini işe katıp katmamak o ajanın çalışma zamanındaki kararıdır — bir adımı, çalışma alanının devretme derinliği üst sınırı içinde daha uygun bir ekip arkadaşına delegate_task ile devredebilir
Planın hedefi konuşmanın hedefi olur ve iş aynı konuşmada yürür: her adım ajanın ne yapmasının istendiğini yayımlar ve turunu geri akıtır; böylece onu zaten bulunduğunuz yerden izlersiniz (ve bir turu durdurabilirsiniz)
Konuşmanın Genel yan panelindeki (Yapılacaklar’ın altında) hedef satırı, çalıştırmanın ilerlemesini settled/total biçiminde ve durdurma düğmesini taşır; Plan Studio grafikte düğüm başına durumu gösterir ve iptali orada da yapar

Onaylamadan çalışmaya devam etme

Planı onaylamak yerine bu konuşmada kalmayı tercih ediyorsanız ajan exit_plan_mode çağırabilir. İzin verilen tek çıkış budur: konuşmaya bağlı kalıcı bir onay isteği açar ve pending döndürür — alan plan modunda kalır ve ajan eylemde bulunmamalıdır. İstek onaylandığında ajanın bir sonraki exit_plan_mode çağrısı alanı plan modundan ajan moduna çevirir ve değişiklik yapan araçlarının kilidini açar. Bir ret, revize edilmiş bir plan için yeni bir istek açmasına izin verir.

Plan modundan çıkmak için ileti alanındaki açılır menüyü (veya Shift+Tab) değiştirin ya da gönderilen planı onaylayın. exit_plan_mode, kararı decide_approval MCP aracıyla verilen kalıcı bir onay açar. Engellenen araç çağrıları için koruma katmanı farklı, bellekte tutulan bir kuyruktur ve plan çıkış isteklerini taşımaz.

Bir pipeline adımında plan modu

Bir messaging.createSpace pipeline düğümü, konuşma modunu düğüm yapılandırmasının mode extra alanından okur — extras['mode']: 'plan'. Anahtar tam eşleşmelidir: conversationMode veya dispatchMode dahil başka herhangi bir yazım sessizce yok sayılır ve oda gövdenin varsayılanına düşer; bu, sohbet değil inceleme modudur. Bir promptAgent adımı, kendi oluşturmadığı bir odaya katılır ve odaya yeniden izin vermez. Düğüm yapılandırması düzenleyicisindeki Gönderim kipi seçimi (allParallel / manager) ekip gönderim düğümleri içindir. Konuşma modunu, alanı açan bir şablonda extras['mode'] ile ya da API üzerinden o düğümün yapılandırmasında ayarlayın.