Bu sayfa İngilizce belgenin çevirisidir. Komutlar, tanımlayıcılar ve örnekler aynıdır. Çalışma zamanı 7.24.4 · SDK 2.6.7. İngilizce kaynak

Yürütme Modları (Yerel, Bulut, Hibrit, Konsey, Arena)

Durum: Etkin
Kapsam: güncel durum
Son inceleme: 2026-09-12
Sahip: ax-code runtime

AX Code, işi yerel çıkarıma, barındırılan veya CLI sağlayıcılarına ya da her ikisine (hibrit) yerleştirebilir ve yüksek riskli işi bağlı birden çok sağlayıcıya yayabilir (konsey incelemesi ve arena en iyi N). Bu sayfa bu modlar için yayımlanmış davranışı belgeler.

Doğruluk kaynağı

Davranış değiştiğinde şunlara karşı doğrulayın:

• packages/ax-code/src/mode/ — saf ilke, hibrit, konsey toplama, arena sıralama, tartışma, bütçe, bellek, worktree ilkesi, implement-arena puanlama
• packages/ax-code/src/tool/council.ts — çok sağlayıcılı konsey aracı
• packages/ax-code/src/tool/arena.ts ve arena-implement.ts — plan ve implement arena
• packages/ax-code/src/session/prompt/prompt-routing.ts — modes.default değeri hybrid olduğunda hibrit yerleştirme
• packages/ax-code/src/config/schema-impl.ts — modes yapılandırma şeması
• packages/ax-code/src/command/template/{council,arena}.txt — /council ve /arena varsayılan eğik çizgi menüsündedir

İş modu seçici (Ajan | Konsey | Arena)

TUI ve Desktop, çok modelli yönlendirme için bir iş modu denetimi sunar. Varsayılan Ajandır.

• TUI varsayılan çerçevesi: alt bilgi bir Ajan çipi göstermez. Çalıştırma modu ve Sandbox kalır. /work-mode (palet İş modunu seç) açık bir seçici açar: Ajan, Konsey ve Arena; her satırda maliyet ve anlambilim vardır. Kullanılamayan ensemble satırları gerekçesiyle devre dışı bırakılır.
• Kurulu ensemble çerçevesi: Konsey veya Arena seçtikten sonra bir çip görünür (Council · 2 ya da daha sonra kullanılamaz olursa içi boş Arena (off)). Ajana dönmek için çipe tıklayın. Yeni sohbetler Ajana sıfırlanır.
• Kullanılabilirlik: bir mod, yapılandırmada etkinse, en az iki bağlı sağlayıcının seçilebilir bir modeli varsa ve yapılandırılmış üye tavanı 1 değilse kullanılabilir. Çipler ve seçici satırları, sağlayıcılar bağlandıkça veya bağlantıları kesildikçe canlı güncellenir.
• Gönderim öncesi ipucu (TUI): konsey veya arena engellendiğinde ya da hâlâ denetlenirken ve kullanılabilir bir modun ilk kullanımında (örneğin Council mode · up to 2 reviewers · advisory · approval on first use) istemin üzerinde tek satırlık bir ipucu görünür. O modda başarılı bir gönderimden sonra çip durum olarak kalır ve ipucu gizlenir. Seçili mod kullanılamazken göndermek gerekçeyle engellenir — taslak saklanır ve istem asla sessizce tek modelli bir çalıştırmaya indirgenmez.
• Desktop: düzenleyici araç çubuğu çipi (Manual/Autonomous yanında).
• Açık /council ve /arena asla yeniden yazılmaz ve tek seferlik giriş noktaları olarak kalır.
• Uzman ajanlar (architect, security, …) ayrı ajan seçicisinde kalır.

Bir bakışta yerleştirme modları

Anahtar sözcük uzman yönlendirmesi ve karmaşıklık katmanlaması (Otomatik yönlendirme bölümüne bakın) hibrit yerleştirmeye ve ensemble modlarına diktir.

Model eforu / düşünme düzeyi (Fast, Balanced, Deep, Max) da diktir — bu bir iş modu değil, model başına akıl yürütme bütçesidir. Bkz. Model eforu.

Yapılandırma

ax-code.json içinde:

{
  "modes": {
    "default": "hybrid",
    "hybrid": {
      "preferLocalWhenAvailable": true,
      "escalateOnHighComplexity": true,
      "localProviderID": "ax-engine"
    },
    "council": {
      "enabled": true,
      "maxMembers": 3,
      "timeoutMs": 180000,
      "debateRounds": 0
    },
    "arena": {
      "enabled": true,
      "maxContestants": 3,
      "strategy": "verify_first"
    },
    "budget": {
      "maxEstimatedUsd": 0.5,
      "estimatedUsdPerMember": 0.05
    }
  }
}

Hibrit yerleştirme

modes.default hybrid olduğunda ve kullanıcı veya ajan bir model sabitlemediğinde:

1. Yerel sağlayıcının (varsayılan ax-engine) seçilebilir bir modeli varsa → düşük ve orta karmaşıklık için yerel tercih edilir.
2. Karmaşıklık yüksek ve escalateOnHighComplexity doğru ise → bulut.
3. Gizlilik yereli gerektiriyorsa ve yerel kullanılabiliyorsa → yerel.
4. Yerel kullanılamıyorsa → bulut.

Karmaşıklık, otomatik yönlendirme karmaşıklık yönlendirmesi etkinken low iletileri için mevcut küçük ve hızlı model yolunu kullanmaya devam eder (Otomatik yönlendirme). Hibrit, anahtar sözcük uzman yönlendirmesinin yerini almaz.

Yerel modeller ve bellek rehberi: AX Engine model seçimi. Sağlayıcı listesi: Desteklenen sağlayıcılar.

Konsey (uzlaşı modu)

Araç: council
Eğik çizgi: /council <question>

1. Bağlı çeşitli sağlayıcıları seçer (aile çeşitliliği — tanınmayan bir çok modelli ağ geçidinde aile, model kimliğine düşer; sonuç belleğinden yumuşak bir eğilim).
2. Yapılandırılmış bir inceleme veya tasarım istemini paralel olarak yayar.
3. Sorunları uzlaşı (yeter sayıdaki başarılı üyeler arasında oybirliği — en az max(2, ⌈2/3 × attempted⌉) başarı), katı çoğunluk (denenen üyelerin yarısından fazlası), azınlık (en az iki) ve tekil katmanlarına toplar. Bulgular, denenen üyelere karşı desteği açıklar (2/6) ve düşük kapsama raporları, uzlaşı etiketlerinin yeter sayı gerektirdiğini belirtir.
4. İsteğe bağlı tartışma turları: turlar arasında paylaşılan anonim (Chatham House) sentez; marka atfı yoktur. Tartışma üç turla sınırlıdır ve yakınsamada erken durur.
5. Danışma amaçlı bir markdown raporu döndürür. Dosyaları düzenlemez.

Çalışmak için en az iki çözümlenmiş üyeye ihtiyaç duyar — daha azı, herhangi bir onay isteminden veya model çağrısından önce «yetersiz üye» ön denetimiyle kısa devre yapar (aynı ağ geçidindeki açık model çiftleri iki sayılır). Anlamlı uzlaşı katmanları hâlâ en az iki başarılı üye ister; aksi halde rapor eksik olarak işaretlenir.

Kanıt kabulü. Üyeler yalnızca sağlanan soruyu ve bağlamı alır. Çağıran oturumu devralmazlar ve özetteki yollardan dosya okumazlar. Belirtilen inceleme kapsamı için gereken gereksinimleri, ilgili farkı, gerekli özgün parçaları ve doğrulama kanıtını ekleyin.

İsteğe bağlı context, 24,000 UTF-16 kod birimine kadar olduğu gibi kabul edilir. Daha büyük bağlam, üye çıkarımından önce context_rejected döndürür; AX Code bunu asla sessizce kısaltmaz. İncelemeyi açıkça kapsamı belirlenmiş isteklere bölün veya gerekli kanıtı koruyarak isteğe bağlı arka planı kaldırın.

Her turdan önce AX Code, tüm istemi 128,000 baytlık yerel bir tavana ve çözümlenmiş her üyenin bilinen girdi ve bağlam sınırlarına karşı denetler; istenen çıktı ile yedek yönerge için ve şema ile çerçeveleme için 2,048 belirteç ayırır. Girdi boyutu kasıtlı olarak tutucu bir UTF-8 bayt tahmini kullanır. Sığacak istemleri reddedebilir; ne tam bir belirteç sayacıdır ne de sağlayıcı serileştirmesi hakkında bir güvencedir. Bilinmeyen model sınırları açıklanır ve yerel tavanlara tabi kalır. Bir tartışma turu sığmazsa sonuç eksiktir ve son tamamlanan turun raporunu korur.

contextAdmission yerel bağlam uzunluğu kapısını, sağlanan boyutu ve bir içerik özetini kaydeder; promptBudget tam isteği ayrı denetler. İkisinin de çıkarımdan önce geçmesi gerekir. Bu alanlar successfulMembers değerinden bağımsızdır ve anlamsal bütünlük, kaynak tazeliği veya garantili inceleme kalitesi oluşturmaz.

Zaman aşımları. Her üye modes.council.timeoutMs altında çalışır (varsayılan 180000 ms); akıl yürütme yeteneği bildiren modeller bu bütçenin modes.council.reasoningTimeoutScale katını alır (varsayılan 3, yani 540000 ms). Bilinen yavaş bir üyeye, diğer herkesin beklemesini şişirmeden daha fazla süre vermek için mutlak bir modes.council.memberTimeoutMs geçersiz kılması ayarlayın; anahtar "providerID" veya "providerID/modelID" olur — tam model anahtarı sağlayıcı genelindeki anahtara üstün gelir ve her ikisi de taban ile ölçek hesabına üstün gelir:

{
  "modes": {
    "council": {
      "memberTimeoutMs": { "deepseek/deepseek-v4-pro": 900000 }
    }
  }
}

ax-code.json korumalı bir yapılandırma dosyasıdır — ajanlar bunu değiştirmek için kullanıcıdan istemelidir.

İsteğe bağlı şeritler (varsayılan kapalı). modes.council.chairman: true, toplamadan ve varsa tartışma turlarından sonra bir körleştirilmiş başkan sentez çağrısı ekler: başkan yalnızca anonimleştirilmiş bulguları alır (katmanlar ve destek sayıları, asla üye kimlikleri) ve bir hüküm, önerilen eylemler ile muhalefet notları döndürür. Belirleyici katmanlama birincil çıktı olarak kalır; başkan başarısızlığı açıklanır ve ölümcül değildir. modes.council.adaptive: true yaymayı iki üyeyle başlatır ve 1. tur kapsaması yeter sayının altındayken veya muhalefet önemliyken maxMembers değerine kadar birer birer genişler; genişleme tetikleri koşum tarafından ayarlanabilir sabitlerdir.

Ne zaman kullanılır

• Mimari, güvenlik ve tasarım ödünleri
• Çok modelli uzlaşının güveni artırdığı yüksek riskli kod incelemesi
• Kullanıcı çok modelli veya «ikinci görüş» incelemesi istediğinde

Ajan iş akışı (önemli)

council aracını, ilgili kanıt hazır olur olmaz erken çağırın ve açıkça kapsamı belirlenmiş bir context özeti verin. Bu incelemeyle ilgisiz geniş çoklu keşif kazılarına kaçının; üyelerden kod bulgusu istemeden önce gereken özgün kanıtı toplayın. Kullanıcı konsey veya arena istediyse, ensemble aracı amaçlanan birincil eylem olana kadar task_parallel reddedilir.

Ne zaman kullanılmaz

• Önemsiz sorular (gecikme ve maliyet)
• Yerel çıkarımdan çıkmaması gereken, gizlilik açısından hassas kod
• Yalnızca bir sağlayıcı bağlıyken

Arena (en iyi N)

Araç: arena
Eğik çizgi: /arena <task>
Gerektirir: modes.arena.enabled: true ve bağlı sağlayıcılarda (paylaşılan bir ağ geçidi dahil) en az 2 ayrı seçilebilir model

Kanıt kabulü (konsey ile ortak). İsteğe bağlı context, 24,000 UTF-16 kod birimine kadar olduğu gibi kabul edilir. Daha büyük bağlam, herhangi bir onay isteminden, worktree oluşturmadan veya model çağrısından önce context_rejected döndürür — AX Code bunu asla sessizce kısaltmaz. Görevi açıkça kapsamı belirlenmiş isteklere bölün veya gerekli kanıtı koruyarak isteğe bağlı arka planı azaltın. Onay isteminin kendisi, her etkisiz ön denetim geçtikten sonra ateşlenir (devre dışı, bağlam kabulü, implement git ön denetimi, bütçe, üye çözümlemesi).

mode: "plan" (varsayılan)

• Her yarışmacı bir yaklaşım, adımlar, riskler ve kalibre edilmiş, öz değerlendirmeli bir risk puanı önerir (çalışma alanı yazması yoktur).
• En az 2 başarılı öneriyle, bir körleştirilmiş rubrik yargıcı çağrısı (ilk çözümlenmiş üye; kimlikler çıkarılmış, sıra rastgele) her öneriyi gereksinim kapsaması, uygulanabilirlik, doğrulama planı ve risk kanıtı üzerinden puanlar (her biri 0–10, beraberlik serbest). Rubrik toplamı (0–40) birincil sıralama sinyalidir; öz değerlendirmeli risk yalnızca gösterim içindir. Yargıç başarısızlığı veya modes.arena.judge: false, bir açıklama notuyla öz değerlendirmeli puanlamaya düşer.
• Önce doğrulama katmanı, sonra yargıç veya risk puanı, sonra yama parmak izi çeşitliliği ile sıralanır (asla salt popülerlik). Plan sıralamaları danışma amaçlıdır ve yürütme doğrulaması değildir.
• Yalnızca danışma.

mode: "implement"

• En az bir commit içeren ve işlenmemiş değişikliği olmayan birincil bir git worktree gerektirir, tam taban commit değerini kaydeder ve o commit değerinden yarışmacı başına bir git worktree oluşturur.
• Her worktree içinde bir implement ajanı çalıştırır.
• Her yarışmacının izlenen ve izlenmeyen değişikliklerini, ajanın kendisinin oluşturduğu commit değerleri dahil, kalıcı bir dal commit değerine anlık görüntüler.
• Algılanan proje doğrulama komutlarını (typecheck / test / lint) yalnızca boş olmayan bir yama yakalandıktan sonra çalıştırır.
• Varsayılan olarak önce doğrula ile sıralar: yalnızca tamamlanmış, boş olmayan ve doğrulamayı geçen yamalar kazanabilir; geçenler arasında daha düşük risk ve çeşitli yamalar tercih edilir.
• Otomatik birleştirmez. Rapor, incelemeniz, birleştirmeniz veya seçerek almanız için worktree yollarını, dalları ve commit aralıklarını içerir.

Implement arenası bir git projesi gerektirir.

Sıralama kuralı (araştırmayla uyumlu)

Kod adayları için: önce doğrulama, ikinci çeşitlilik, popülerlik asla tek başına.
Benzer yanlış yamalar üzerinde saf çoğunluk oyu bir karşı örüntüdür (popülerlik tuzağı).

Eğik çizgi komutları

Güvenlik ve maliyet

• Sandbox / otonom tek ajan işine hâlâ uygulanır (Sandbox, Otonom).
• Konsey ve plan arenası dosya yazmaz.
• Implement arena yazıcıları worktree içinde yalıtılır; kirli birincil worktree reddedilir, böylece işlenmemiş girdi sessizce atlanamaz.
• Ensemble yayması sağlayıcı dışarı çıkışını ve maliyeti katlar; modes.budget kullanın ve maxMembers / maxContestants değerlerini küçük tutun. Bütçe tahminleri en kötü durumu fiyatlar: konsey üye başına 2 × (debateRounds + 1) çağrı (şema yedeği ve yeniden deneme), plan arenası yarışmacı başına 2 artı bir düz yargıç çağrısı, implement arenası belgelenmiş yörünge başına 12 çağrı tahmini.
• Yalnızca yerel bir ensemble çağrı defteri (genel durum dizininde ensemble-calls.jsonl, 2 MB tavan) üretim başına sonuçları SHA-256 istem özetleriyle kaydeder — asla istem gövdeleri, asla kimlik bilgileri, dışarı çıkış yok. modes.ensembleLedger: false ile kapatın.
• Çok modelli uzlaşı bulgudur, ispat değildir — yayınlamadan önce testleri çalıştırın.

İlgili

• Otomatik yönlendirme — uzman anahtar sözcükler ve karmaşıklık katmanı
• Desteklenen sağlayıcılar — bulut, CLI, AX Engine
• AX Engine model seçimi — yerel model seçimi