Ana içeriğe geç

Bütçeler ve sınırlar

Ajan çalıştırmalarını iki tür üst sınır denetim altında tutar:

  • Bütçeler: ajanların bildirdiğine göre çalıştırmaların ne kadar paraya mal olabileceği.
  • Sınırlar: bir çalıştırmanın bilgisayardan ne kadar alabileceği: işlemci, bellek, disk, GPU ve süre.

İkisi de üç kapsamda ayarlanabilir.

Üç kapsam​

KapsamBütçeSınırlar
Her görevTüm görevlerin herhangi bir 24 saatte birlikte ne kadara mal olabileceği.Bir grubun ve bir görevin hiçbir şey belirlemediği yerde geçerlidir.
Bir grupGrubun görevlerinin, tüm çalıştırmaları boyunca ve/veya herhangi bir 24 saatte birlikte ne kadara mal olabileceği.Görevin hiçbir şey belirlemediği yerde, alan alan grubun her görevine uygulanır.
Tek görevBu görevin çalıştırmalarının birlikte ne kadara mal olabileceği.Görevin kendi değerleri, alan alan.

Sınırlarda bir görevin kendi değeri grubunkinin, bir grubunki de her görev için olanın önüne geçer. Bütçelerde ise bir çalıştırmanın üzerindeki her bütçe geçerlidir ve en sıkı olanı belirler.

Uygulamada Settings → Budget ve Settings → Limits her seferinde tek bir kapsamı gösterir; kapsam Applies to altında seçilir (Every task, One group, One task). Kart kapsamı büyük harflerle adlandırır (EVERY TASK, GROUP, THIS TASK ONLY), böylece bir değişiklik asla istemediğiniz yere düşmez. Bir görevin ya da grubun ⋮ menüsü doğru kapsamı açar.

Bütçeler​

kule budget TASK 5           # bu görevin çalıştırmaları birlikte 5 USD'ye mal olabilir
kule budget TASK 4.50 EUR    # başka bir para birimi (ISO 4217)
kule budget TASK off         # bu görev için bütçe yok
kule budget TASK             # bir sonraki çalıştırmasının üzerindeki her bütçeyi listele

kule group budget ID 20          # bir grup: görevlerinin tüm çalıştırmaları boyunca
kule group budget ID 10 --daily  # bir grup: herhangi bir 24 saatte

kule daily-budget 20         # tüm görevler birlikte, herhangi bir 24 saatte

Bir bütçe nasıl uygulanır:

  • Üzerindeki bir bütçe harcandığında hiçbir çalıştırma başlamaz.
  • Bir çalıştırma, kalanların en sıkısıyla sınırlanır. Maliyetini çalışırken bildiren bir ajanın çalıştırması, oraya vardığında iptal edilir.
  • Bir ret, harcanan bütçenin adını verir.
  • Bir çalıştırma, görevinin çalıştığı sırada bulunduğu grup için sayılır; böylece bir görevi gruptan çıkarmak, harcadığını grubun hesabında bırakır.
Bir bütçe yalnızca ajanların bildirdiğini sınırlar
  • Claude Code maliyeti her turun sonunda bildirir; bu yüzden bir tur bütçeyi aşabilir ve reddedilen bir sonraki çalıştırma olur.
  • ChatGPT ile oturum açmış Codex token'ları bildirir ama maliyeti bildirmez.
  • Gemini ikisini de bildirmez.

Abonelikle oturum açmış bir ajan hiç maliyet bildirmeyebilir; bir bütçe bildirilmeyeni sınırlayamaz.

Her çalıştırmanın ne kullandığı (token'lar, bağlam penceresi ve ajan söylediğinde maliyet) görevin usage.jsonl dosyasında tutulur. kule status ve uygulamanın görev başlığı bunları toplar.

Pencere başka yerdeyken uygulama, bir bütçenin %80'i harcandığında ve tamamı harcandığında size haber verir.

Sınırlar​

kule limits                                # her görevin sınırları ve her birinin nereden geldiği
kule limits memory=4 cpu=2                 # bunları her görev için ayarla
kule limits --group ID memory=8 gpu=off    # bir gruptaki her görev için
kule limits --task TASK run=30 idle=5      # tek bir görev için
kule limits --task TASK memory=inherit     # grubunkini / her görevinkini yeniden al
kule limits cpu=none                       # işlemci sınırı yok
AlanBirimAşılınca
cpuçekirdek (1.5 = bir buçuk)Çalıştırma durdurulmaz, yavaşlatılır: Kule süreçlerini sırayla duraklatıp sürdürür (SIGSTOP/SIGCONT, her seferinde saniyenin onda biri kadar).
memoryGB, çalıştırmanın tüm süreçleri birlikteSüreçler hemen öldürülür; çalıştırma durur.
diskGörev açıldığından beri kopyanın, geçici dosyalarının ve ev değişikliklerinin büyüyebileceği GBÇalıştırma durur. Hiçbir dosya bunun ötesine yazılamaz.
gpuon / offKapalıyken: macOS'ta Metal'e (ve OpenCL'e) hiçbir aygıt verilmez; Linux'ta /dev/dri ve NVIDIA'nın aygıtları salt okunur kalır.
rundakika, tek çalıştırmaÇalıştırma durur.
tasksaat, bir görevin tüm çalıştırmaları birlikteÇalıştırma durur ve siz yükseltene kadar hiçbiri başlamaz.
idlehiçbir şey yapmadan geçen dakikaÇalıştırma durur.

Nasıl sayıldıklarına dair notlar:

  • Bellek, macOS'ta süreçlerin ayak izi (footprint), Linux'ta orantılı paylarıdır.
  • Disk yalnızca görevin eklediğini sayar ve bir tarama elverdiği kadar sık (en fazla saniyede bir) ölçülür. Büyük bir klasör kendi sınırını tüketmez; görevin başladığı paket önbellekleri de tüketmez.
  • Hiçbir şey yapmamak; ajandan mesaj, araç çağrısı ya da çıktı gelmemesi, işlemci kullanılmaması ve yeni süreç açılmaması demektir. Uzun ve sessiz bir derleme hiçbir şey yapmamak değildir. Sizi bekleyen bir soru da sayılmaz.
  • Tek çalıştırma, yanıtlarınızı beklemek dahil çalıştırmanın tüm süresini sayar.
  • Hiçbir sistem GPU'nun bir payının ayarlanmasına izin vermez; bu yüzden gpu yalnızca açık ya da kapalıdır.
  • Bir çalıştırma başladığı sınırları korur; bir değişiklik bir sonraki çalıştırmadan itibaren geçerlidir.
  • Terminalden kule run da aynı sınırlara tabidir.

Bir sınır bir çalıştırmayı durdurduğunda Live hangisi olduğunu ve neyi ölçtüğünü söyler:

Stopped: the run's processes held 4.2 GB, over its memory limit of 4 GB

Bir çalıştırma sürerken istemin altındaki çubuk, sınırlarına göre ne aldığını gösterir (CPU 140% / 200% · 1.2 GB / 4 GB · disk +350 MB · 7 processes) ve işlemci sınırı onu geri tuttuğu sürece slowed (yavaşlatıldı) ekler.

Stop​

Uygulamadaki Stop (Mod+Shift+K), çalışmakta olan çalıştırmayı istediğiniz an durdurur: turu iptal edilir ve ajan turu on saniye içinde bitirmezse öldürülür. O ana kadar değiştirdikleri, incelemeniz için kopyada kalır.

İlgili sayfalar​