Ana içeriğe geç

kule budget

Bir görevin ajan çalıştırmalarının toplamda ne kadar tutabileceğini gösterir ya da ayarlar.

Kullanım​

kule budget [OPTIONS] <TASK> [AMOUNT] [CURRENCY]

Açıklama​

Bütçe, ajan çalıştırmalarının maliyetine, ajanların kendi bildirdiği şekliyle bir üst sınır koyar. kule budget tek bir görevin bütçesini ayarlar: o görevin ilk çalıştırmadan itibaren tüm çalıştırmalarının toplamı.

  • Bir tutarla çalıştırırsanız görevin bütçesini ayarlar; görevin ne harcadığını ve ne kaldığını yazar.
  • off ile görevin bütçesini kaldırır.
  • Tutar vermezseniz görevin bir sonraki çalıştırmasını sınırlayan her bütçeyi listeler: görevin kendi bütçesi, grubunun bütçeleri (bkz. kule group budget) ve tüm görevler için günlük bütçe (bkz. kule daily-budget). Bir sonraki çalıştırmanın en fazla ne kadar tutabileceğini de söyler: bunların en sıkısı.

Bir bütçe nasıl işler:

  • Üzerindeki bir bütçe tükendiğinde hiçbir çalıştırma başlamaz. Ret mesajı hangi bütçe olduğunu söyler.
  • Maliyetini çalışırken bildiren bir ajanın çalıştırması, kalan tutara ulaştığında durdurulur.
  • Claude Code maliyetini her turun sonunda bildirir; bu yüzden bir tur bütçeyi aşabilir ve reddedilen, bir sonraki çalıştırma olur.
  • Maliyet bildirmeyen bir ajan (örneğin abonelikle oturum açmış bir ajan) bütçeyle sınırlanmaz. Kule kendisine söylenmeyeni tutamaz.
  • Bir bütçe yalnızca kendi para biriminde bildirilen maliyetleri sayar. Ajanlar USD ile bildirir; ajanınızın başka bir para birimi bildirdiğinden emin değilseniz bütçeleri USD olarak tutun.

kule budget yalnızca görevin Kule'nin evindeki kendi ayarını değiştirir. Görevin kopyasına ya da klasörünüze hiç dokunmaz. Kapsamların birbirine nasıl oturduğu için Bütçeler ve sınırlar sayfasına bakın.

Argümanlar​

ArgümanAnlamı
TASKGörevin kule list'in yazdığı kimliği (örneğin 1046fb30). Kimliğin tamamı gerekir.
AMOUNT5 ya da 2.50 gibi pozitif bir tutar, ya da bütçeyi kaldırmak için off. Bütçeleri göstermek için boş bırakın.
CURRENCYBüyük harfle bir ISO 4217 kodu, örneğin USD ya da EUR. Varsayılan: USD.

Seçenekler​

SeçenekDeğerVarsayılanAnlamı
--homeyol~/.kule (ya da KULE_HOME)Kule'nin evi. Bkz. genel seçenekler.
-h, --helpYardımı yazdırır.

Örnekler​

Bir göreve 5 USD bütçe verin:

$ kule budget 1046fb30 5
spent: nothing reported in 0 runs; budget 5.00 USD, 5.00 USD left

Görevin bir sonraki çalıştırmasını sınırlayan her bütçeyi görün:

$ kule budget 1046fb30
budgets over task 1046fb30's next run:
  the task's own                   5.00 USD, 5.00 USD left
the next run may cost at most 5.00 USD

Kendi bütçeleri olan bir gruptaki görev, günlük bütçe de ayarlıyken:

$ kule budget 1046fb30
budgets over task 1046fb30's next run:
  group "clients", all its runs    20.00 USD, 20.00 USD left
  group "clients", any 24 hours    5.00 USD, 5.00 USD left
the next run may cost at most 5.00 USD

Euro cinsinden bir bütçe ayarlayın, sonra kaldırın:

$ kule budget 1046fb30 2.50 EUR
spent: nothing reported in 0 runs; budget 2.50 EUR, 2.50 EUR left
$ kule budget 1046fb30 off

Görevin henüz hiç çalıştırması yoksa off hiçbir şey yazmaz.

Çıktı​

  • spent: … in N runs, ajanların bu görev için bildirdiklerini toplar. Bazı çalıştırmalar token bildirip maliyet bildirmediyse satır bunların kaç tane olduğunu söyler ((2 without a cost)).
  • budgets over task …'s next run her bütçeyi kalan tutarıyla listeler. Tükenmiş bir bütçe 0.00 kaldığını gösterir.
  • the next run may cost at most … kalanların en sıkısıdır.
  • no budget holds task … hiçbir kapsamda bütçe ayarlı olmadığı anlamına gelir.
  • no run starts: … bütçelerden birinin tükendiği anlamına gelir; metin hangisi olduğunu söyler.

Hatalar ve çözümler​

MesajNe yapmalı
kule: abc: an amount like 5 or 2.50, or offBir sayı ya da off yazın.
kule: a budget is a positive amount in a currency like USD, not 0 USD0'dan büyük bir tutar ve büyük harfle üç harfli bir para birimi kullanın (usd değil, USD). Bir bütçeyi kaldırmak için off kullanın.
kule: no task 1046fb3kule list'teki görev kimliğinin tamamını kullanın.
task 1046fb30 has spent its budget; raise it or turn it off to run again (kule run'dan ya da uygulamadan)Bütçeyi artırın (kule budget TASK 10) ya da kaldırın (kule budget TASK off).

Her hata 2 durum koduyla çıkar.

Uygulamada​

Applies to: One task seçiliyken Settings → Budget, ya da görevin ⋮ menüsündeki Budget…. Görev başlığındaki çip, görevin ne harcadığını ve ne kaldığını gösterir. Pencere öndeyken değilse Kule bir bütçenin %80'i harcandığında ve tamamı bittiğinde size haber verir.

Ayrıca bakın​