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

Otonom kip

Durum: Etkin Kapsam: güncel durum Son inceleme: 2026-08-25 Sahip: ax-code çalışma zamanı

Otonom kip, ax-code’un her düşük riskli adımda insan onayı beklemeden görevleri tamamlamasını sağlar. Açıkken izin istemleri açıkça engellenmedikçe otomatik onaylanır ve soru diyalogları, riskli veya aşırı mühendislik seçeneklerinden kaçınırken önerilen, varsayılan, yaygın, basit ve asgari seçimleri yeğleyen bir iyi uygulama sezgisiyle otomatik yanıtlanır.

Varsayılan olarak otonom kip açıktır. Daha önce kapattıysanız bu tercih kaydedilir ve sonraki açılışta geri yüklenir.

Hızlı başlangıç

TUI’den değiştirin:

• İsteme /autonomous yazın veya
• Ctrl+P tuşuna basın ve “autonomous” arayın veya
• Durum çubuğundaki otonom açık/kapalı göstergesine tıklayın

Durum çubuğu güncel durumu gösterir:

• otonom açık (sarı zemin, koyu kırmızı metin) — ajan duraklamadan çalışır
• otonom kapalı (yeşil metin) — ajan izin/soru istemleri için duraklar

Ayar oturumlar arasında ax-code.json içinde kalır.

Neler değişir

Nasıl çalışır

Otonom kip üç katmanda işler:

Doğruluk kaynağı

Bu sayfa kullanıcıya dönük davranışı özetler. Davranış değişince belgeleri şunlara karşı doğrulayın:

• İzin otomatik onayı, döngü davranışı, ret işleme ve otonom tavanlar için packages/ax-code/src/session/processor.ts.
• Otonom iş akışı yönergeleri için packages/ax-code/src/session/system.ts ve packages/ax-code/src/session/prompt/ altındaki sağlayıcı istem dosyaları.
• Soru otomatik yanıt sezgileri ve yükseltme davranışı için packages/ax-code/src/question/ ve packages/ax-code/test/question/question.test.ts.
• Otonom adım/dosya değişikliği tavanları için packages/ax-code/src/session/blast-radius.ts.
• İstem ve karar defteri davranışı için packages/ax-code/test/session/system.test.ts, packages/ax-code/test/session/prompt.test.ts ve ilgili oturum sınamaları.

Buradaki güvenlik garantilerini sandbox belgesiyle hizalı tutun; otonom kip onay davranışını değiştirir, yalıtım zorlamasını değil.

1. İzin otomatik onayı (sunucu tarafı)

Otonom kip karma, önce ret ilkesi kullanır (ADR-004 / PRD v4.2.0). Bir araç izin için ctx.ask() çağırdığında İzin modülü izni sınıflandırır:

• GÜVENLİ izinler (read, glob, grep, list, lsp, code_intelligence, skill, todoread) engelleyici bir istem oluşturmadan otomatik onaylanır.
• RİSK izinleri (edit, bash, external_directory, task, webfetch, websearch, codesearch, …) kural kümesine düşer — ajanın yapılandırılmış izin/ret kuralları yine uygulanır ve kullanıcı tanımlı ret kuralları her zaman zorlanır. full-access sandbox kipinde RİSK izinleri ret kuralları değerlendirildikten sonra otomatik onaylanır.
• Bilinmeyen izinler varsayılan olarak sorar (experimental.autonomous_strict_permission: false eski izin verme davranışını korur).

Anında kural tabanlı onay yerine her çağrıda bir karara ulaşan izinler: isolation_escalation (sandbox geçersiz kılma istekleri), INTERACTIVE_ONLY izinleri ve NEVER_AUTONOMOUS_AUTOAPPROVE kümesi. Bir daraltma (ADR-098): full-access sandbox kipinde yalnızca etkileşimli işaretli external_directory istekleri — yolları bir glob, değişken veya küme ayracı genişlemesi kullandığı için statik doğrulanamayan bash komutları — da otomatik onaylanır; çünkü tam erişimli bir sandbox’ın koruyacak dosya sistemi sınırı kalmamıştır. Açık ret kuralları yine uygulanır ve sandbox açık kipler (workspace-write, read-only) çağrı başına istemi korur.

Boşta “bir kez izin ver” (varsayılan açık): Otomatik açık artı Sandbox kapalı (full-access) asgari etkileşim demektir: bekleyen her izin, requireInteractive, kanca ve sandbox yükseltme istemleri dahil 15 saniye sonra bir kez otomatik yanıtlanabilir. Otomatik kapalı veya Sandbox açık, bekleyen istemlere insan yanıtı ister. WebMCP ayrıca karşılık gelen köprünün bağlı olmasını ister; başka bir bağlı köprü yetmez. Açık ret kuralları yine uygulanır. experimental.permission_idle_once.enabled: false geri sayımları kapatır ve permissions kapsamlarını kısıtlayabilir. Eski timeout_ms ayarı uyumluluk için kabul edilir ancak sabit 15 saniyelik süreyi artık değiştirmez.

Geri sayım sunucuya aittir. Her oturumun en eski isteği bir son tarih alır; kuyruktaki istekler öne gelince taze 15 saniye alır. İnsan yanıtları zamanlayıcıyı iptal eder. Otomatiği kapatmak, Sandbox’ı açmak veya ilgili WebMCP köprüsünün bağlantısını kesmek bekleyen geri sayımları iptal eder. Uygunluğu geri yüklemek taze bir geri sayım başlatır. Geçici yapılandırma yeniden yükleme boşlukları geri sayımı askıya alır. Otomatik yanıtlar güncel kipi, köprüyü ve ret kurallarını yeniden denetler ve kalıcı onay kaydetmez. AX_CODE_PERMISSION_IDLE_ONCE_MS iç hata ayıklama/sınama geçersiz kılması kullanılabilir kalır ve Node zamanlayıcı azamisiyle sınırlıdır.

Kipler etkin dizine kapsamlanır. İç içe bir ax-code.json depo kökü ayarlarını geçersiz kılabilir; etkin kipi değiştirmek için etkin oturumun Sandbox anahtarını kullanın.

Geçersiz kılınamayan korumalı yollar: otonom kip ayrıca sabit bir ilke/denetim düzlemi yol kümesine yazmayı reddeder — ax-code.json/ax-code.jsonc, .ax-code/**, .git/config ve .git/refs/** — böylece ajan kendi yapılandırmasını düzenleyemez, kendi otonomi tavanlarını yükseltemez veya git kancaları yerleştiremez. Yapılandırılabilir engelli yol listesinin aksine bunlar proje veya kullanıcı yapılandırmasıyla kaldırılamaz.

2. Soru otomatik yanıtı (sunucu tarafı)

Bir araç kullanıcıya soru sorduğunda Soru modülü hemen bir yanıt seçer. recommended, default, safe, standard, common, conventional, best practice, simple veya minimal olarak işaretli seçenekleri yeğler. experimental, risky, dangerous, destructive, advanced, complex, rewrite veya over-engineered olarak işaretli seçeneklerden kaçınır. Hiçbir seçenekte işaret yoksa ilk seçeneği seçer; çünkü soru aracı ajanlara önerilen seçeneği başa koymalarını söyler.

3. İşlemci döngüsü (oturum düzeyi)

Bir izin bir biçimde reddedilirse (örneğin açık bir ret kuralıyla) işlemci döngüsü durmaz — oturumu durdurmak yerine sonraki adıma geçer.

4. PRD/ADR tarzı karar çerçevesi

Otonom kip sistem istemine hafif bir iş akışı anımsatıcısı ekler. Uygulamadan önce ajan işi sorun, kısıtlar, karar, ödünler, plan ve doğrulamayla çerçevelemelidir. Önemli çok dosyalı, mimari veya üründe görünen değişiklikler için, deponun belge desenine uyuyorsa bir depo belgesi oluşturabilir veya güncelleyebilir. Önemsiz değişikliklerde aşırı mühendislikten kaçınmak için bu çerçeveyi planda hafif tutmalıdır.

Otonom + Sandbox

Otonom kip ve sandbox kipi bağımsızdır. İkisini aynı anda kullanabilirsiniz:

Varsayılan çalışma zamanı duruşu otonom açık artı sandbox kapalıdır: ağ açık full-access. Bu en az sürtünmeli CLI davranışını sağlar ancak yalıtım sınırı yoktur. Güvenilmeyen veya gözetimsiz iş için kısıtları açmak üzere /sandbox, --sandbox workspace-write, AX_CODE_ISOLATION_MODE veya proje yapılandırmasını kullanın.

Yapılandırma

Yapılandırma dosyası

ax-code.json içinde:

{
  "autonomous": true
}

Kapatmak için false ayarlayın:

{
  "autonomous": false
}

Ortam değişkeni

AX_CODE_AUTONOMOUS=true ax-code    # force autonomous on
AX_CODE_AUTONOMOUS=false ax-code   # force autonomous off

Öncelik

Ortam değişkeni > yapılandırma dosyası > varsayılan (açık)

İş yükü bütçeleri (model turları ve araç çağrıları)

Otonom kip sınırsız yürütme demek değildir. Birkaç bağımsız tavan uygulanır. Aşağıdaki varsayılanlar gönderilen sabitlerdir; bir iş yükü daha fazla yer isterse ax-code.json içinde yükseltin veya düşürün.

Bir model turu bir dış döngü model isteğidir. Bir araç çağrısı bir model turu içindeki bir araç çağrısıdır. Bunlar ayrı bütçelerdir: tek bir model turu birkaç araç çağrısı yapabilir. steps içeren eski yapılandırma adları desteklenir ancak iki birimi birbirinin yerine koymaz.

Birinci sınıf autonomy nesnesini yeğleyin. Eski session.* ve experimental.autonomous_caps.* anahtarları takma ad olarak çalışmaya devam eder (daha düşük öncelik).

İkili dosyalar (bir yürütülebilir dosyanın cp değeri, bir zip’in curl -o değeri ve diğer metin dışı yazmalar) yine dosya tavanına sayılır ancak sıfır satır yazar. Satır tavanı metinsel değişikliği ölçer. Kabuk metin yazmaları, az yeni satırlı yoğun bir yükün bütçeden kaçmaması için ceil(size / 80) tahminini korur.

git check-ignore yok sayılmış olarak bildirdiği izlenmeyen yollar da sıfır satır yazar ve yine bir dosya sayılır. Bu, bir doğrulayıcı çıktısını oraya yönlendirdiğinde target/ gibi üretilmiş ağaçları kapsar (cargo clippy > target/review/clippy.log). Muafiyet yalnızca git 0 ile çıktığında uygulanır. Eksik bir depo, bir git hatası ve izlenen bir dosya olağan satır ücretini korur; adı bir yok sayma deseniyle eşleşen izlenen dosya dahil.

Profiller

Birkaç alanı birden tohumlamak için autonomy.profile ayarlayın (açık alanlar yine kazanır):

/limits ile inceleyin

Bir oturumda /limits çalıştırın. Çözülmüş bütçe yığınını, etkin ajan için etkili TUI paydasını, yapılandırma kaynaklarını ve doctor uyarılarını basar (örneğin agent.steps oturum parçasından daha sıkıysa). Anahtar adları için /limits help kullanın.

TUI ne gösterir: otonom bir çalıştırma sırasında üstbilgi turn current/max · total current/max · cont current/max raporlar. turn güncel devam parçasıdır ve etkin ajan için etkili tempo tavanını kullanır — ajan tavanlıysa min(agent.steps, session.max_steps), aksi halde parça başına sınır. total otomatik devamlardan sağ çıkar. Etkin bir hedef veya Super-Long kipi olağan devam tavanını kaldırdığında cont, ∞ gösterir.

Otomatik yönlendirme: anahtar sözcük yönlendirmesi oturumu bir uzman ajana geçirebilir (Debug, Security, DevOps, …). Uzmanlar, agent.<name>.steps ayarlamadıkça Dev ile aynı varsayılan olarak sınırsız ajan model turu ilkesini paylaşır. Yalnızca Dev ajanını istiyorsanız yönlendirmeyi "routing": { "disable": true } ile kapatın.

Uzun çalıştırmalar: çok saatlik iş için /goal veya Super-Long kullanın — olağan devam tavanlarını kaldırır ve daha büyük birikimli tavanı kullanırlar (varsayılan 20,000); doğrulama / duraklatma anlamı Döngü kipi belgesindedir. /goal önce incelenebilir bir sözleşme yazar (kabul ölçütleri + doğrulama planı) ve bu plan üretilemezse kapalı biçimde duraklatılmışa düşer.

Bir sınır çalıştırmayı durdurduğunda

Olağan bir çalıştırma birikimli model turu tavanına ulaşmadan önce AX Code bir sınırlı yakınsama yönergesi enjekte eder (en fazla son 50 tur, küçük özel bütçeler için küçültülür). Modele geniş keşfi durdurmasını, uçuştaki işi bitirmesini veya güvenle park etmesini, hedefli doğrulama çalıştırmasını ve bitmemiş işi dürüstçe raporlamasını söyler. Bütçe eklemez veya herhangi bir tavanı atlamaz.

Bir terminal bütçeye ulaşıldığında session.error isteğe bağlı makinece okunur bir code içerir ve yeniden oynatma session.end olayı aynı değeri stopCode olarak kaydeder. Mevcut kaba bitiş gerekçeleri uyumluluk için değişmeden kalır. Güncel sınır kodları:

• MODEL_TURN_SEGMENT_LIMIT
• MODEL_TURN_TOTAL_LIMIT
• AGENT_MODEL_TURN_LIMIT
• AGGREGATE_TOOL_CALL_LIMIT
• FILE_CHANGE_LIMIT
• LINE_CHANGE_LIMIT

Bir parça tavanında AX Code, yapılandırılmış devam bütçesi kaldığı sürece otomatik devam eder. Bu bütçe tükenince çalıştırma durur ve ileti ne olduğunu söyler. continue gibi yeni bir istem göndermek yeni çalıştırma muhasebesiyle yeni bir kullanıcı yönlendirmeli çalıştırma başlatır; durmuş çalıştırmayı geriye dönük uzatmaz. Amaç tamamlanana, engellenene veya bir hedef/çalışma zamanı bütçe sınırına kadar açık ve sürdürülebilir kalmalıysa /goal kullanın. /goal izin, yalıtım, etki yarıçapı, takılma, token, zaman veya birikimli model turu korumalarını kapatmaz.

Örnek: büyük bir otonom yığın için bütçeleri yükseltin

{
  "autonomous": true,
  "autonomy": {
    "profile": "long",
    "budget": {
      "model_turns": { "per_segment": 500, "total": 20000 },
      "tool_calls": {
        "per_segment": 1000,
        "rate": { "count": 40, "window_seconds": 10 },
        "per_tool": { "bash": 80, "edit": 150 }
      },
      "changes": { "files_total": 100, "lines_total": 10000 }
    },
    "stall": {
      "tool_only_turns": 50,
      "tool_only_nudge": 20,
      "failed_mutation_attempts": 30,
      "max_consecutive_errors": 3
    }
  },
  "agent": {
    "debug": { "steps": 200 }
  }
}

Otonom kipi ne zaman kapatmalı

• ax-code öğrenirken — ajanın her adımda ne yaptığını görün
• Hassas işlemler — her dosya değişikliği uygulanmadan önce inceleyin
• Ajan davranışında hata ayıklama — ajanın neden belirli kararlar verdiğini anlayın
• Güvenilmeyen kod — yabancı depolarla çalışırken araç çağrılarını inceleyin

Otonom kipi ne zaman açık tutmalı

• Rutin görevler — ajana güvendiğiniz yeniden yapılandırma, hata düzeltme, geçiş
• CI/CD hatları — görev ilkeyle zaten kısıtlıyken başsız yürütme
• SDK kullanımı — createAgent() yoluyla programlı ajan yürütmesi
• Büyük görevler — her izinde durmak saatler sürecek çok dosyalı değişiklikler

Başsız / CI kullanımı

Başsız kipte (ax-code run, ax-code serve, SDK) otonom kip zorunludur — istemleri gösterecek bir TUI yoktur. Sunucu tarafı otomatik onay, ajanın yanıtsız istemlerde askıda kalmadan tamamlanmasını sağlar.

# Headless one-shot with autonomous on (default)
ax-code run "Fix all TypeScript errors in src/"

# Explicit override
AX_CODE_AUTONOMOUS=true ax-code run "Migrate API routes"

ax-code run varsayılan olarak kısa araç çıktısı basar: komut çıktısı kuyruğuna indirilir, düzenlemeler bir fark özeti gösterir ve yapılacak yazmaları tek satırlık bir ilerleme sayısı gösterir. Hatalar asla gizlenmez — diğer çıktıyla aynı kuyruk tavanıyla işlenir. Denetim için tam araç çıktısını (tam farklar, kesilmemiş komut çıktısı, tam yapılacak listeleri) geri getirmek için --full geçirin.

Güvenlik garantileri

Otonom kip açıkken bile:

1. Sandbox sınırları yine zorlar — çalışma alanı dışındaki yazmalar otonom kipten bağımsız engellenir
2. Yalıtım yükseltmesi her zaman sorar — ajan sandbox kısıtlarını sessizce geçersiz kılamaz
3. Ret kuralları zorlanır — açık "deny" izin kuralları araç çağrılarını yine engeller
4. Otonom seçimler kaydedilir — soru aracı üst verisi yapılandırılmış bir autonomousDecisions defteri içerir ve araç çıktısı seçilen yanıtları içerir; böylece ajan onları sonra raporlayabilir
5. Aşırı mühendislikten kaçının — otonom devam, ajana en basit yaygın uygulama değişikliğini yeğlemesini ve 3+ somut kullanım durumu olmayan soyutlamalardan kaçınmasını anımsatır
6. Oturum anlık görüntüleri kaydedilir — her araç çağrısı denetim/yeniden oynatma için günlüğe yazılır
7. İptal her zaman çalışır — Esc (kesme) basmak ajanı hemen durdurur