Hareket bütçeleri, İterasyon Kapıları ve Maliyet yöneticileri
max_tokens, görev başına token ve dolar bütçeleri, günlük / aylık limitler, iterasyon limitleri, katılımlı model yönlendirme, hızlı önbelleğe girme, bağlam pencereleri, pahalı eylemler için HITL kontrol noktaları, bütçe ihlalinde anahtarları öldürme. Anthropic'in Claude Code Agent SDK farklı isimlerle aynı primitifleri gönderir. Finansal hız limitleri örneğin, erişimi 10 dakikada > $ 50'e kesin aylık limitlerden daha hızlı yakalamak döngüler.Type: Learn
Languages: Python (stdlib, layered cost-governor simulator)
Prerequisites: Phase 15 · 10 (Permission modes), Phase 15 · 12 (Durable execution)
Time: ~60 minutes
Sorun
Özerk ajanlar her dönüşte gerçek para harcıyor. Bir chatbot'un kötü çıkışı kötü bir cevap; bir ajanın kötü döngüsü bir fatura. Başarısızlık modunun endüstri belgelenmiş terimi "Cüzdanı reddetmek" ajan mantık yapmayı sürdürür, araç çağrısını sürdürür, faturalama yapmayı sürdürür ve hiçbir şey onu durdurmaz çünkü hiçbir şey tasarlanmamıştır.
Bu, bir sayı değil, farklı zaman ölçeklerinde ve ayrıntılılıklarda bir dizi sınırdır: talep başına, görev başına, saat başına, gün başına, ay başına. İyi tasarlanmış bir yığın, birkaç dakika içinde kaçan bir döngü, saatler içinde yavaş bir sızıntı ve bir gün içinde kötü bir serbest bırakmayı yakalar. Aynı yığın, ajan uzun uzayda ve özerk olduğunda bütçeyi tutar.
Bu bir mühendislik dersi: matematik önemsiz, disiplin takımların başarısız olduğu yerdir. Aşağıdaki sınırların listesi Microsoft Ajan Yönetim Araç Kütübesinde veya Anthropic Claude Code Agent SDK dosyalarında isimlendirilmiştir.
Anlaşım
Ücret yöneticisi yığın
max_tokensper request.Basit.Bir çağrı sınırsız bir bitirme yayınlamasını engeller.- Per-task token budget.Tüm koşuda N simgesini aşmayın.
- Per-task dollar budget.Tokenler gibi ama para biriminde.
max_budget_usdClaude Code'da. - Per-tool call cap.N' dan fazla değil
WebFetchÇağrılar, Nshell_execTelefonlar vb. - Iteration cap (
max_turns).Toplam ajan döngü iterasyonları; sonsuz akıl döngüslerini önler. - Per-minute / per-hour / per-day / per-month cap.Çevrimiş pencereler, farklı zaman ölçeklerinde sızıntılar algılar.
- Financial velocity limit.Örneğin, "Eğer 10 dakika içinde 50 dolardan fazla harcadıyorsanız, erişiminizi kesin".
- Tiered model routing.Küçük bir model için varsayılan; sınıflandırıcı görevi gerekli gördüğünde daha büyük bir model için yükselir.
- Prompt caching.Sistemi hızlı ve sabit bağlamı, sağlayıcı önbelleğinde depolanır; yeniden gönderme için token maliyeti sıfıra yakın.
- Context windowing.Etkin bağlamı bir eşiğin altında tutmak için kompaktleştirme / özetleme; doğrudan token maliyetleri azaltma.
- HITL checkpoints on expensive actions.Pahalı olduğu bilinen bir eylemden önce (uzun araç çağrısı, büyük bir indirme, pahalı bir model yükseltmesi) insan dokunuşunu gerektirir.
- Kill switch on budget breach.Sessiyon herhangi bir kapalı ateşlerken sona erer. Kapalı kaydedilir; ayrı bir yeniden etkinleştirilmiş yol gerektirir.
Neden bir damla değil, bir damla?
Tek bir aylık kap, kaçan ajanı sadece cüzdanın kaybolmasından sonra yakalar. Tek bir istek kap, oturum düzeyinde hiçbir şey yakalamaz. Farklı başarısızlık modları farklı zaman ölçeklerini gerektirir:
- Runaway loop(Agent 5 saniyelik bir tekrar deneme sırasında sıkıştı): Hız sınırı tarafından yakalanmış.
- Slow leak(öğütçi görev başına beklenen işi 2 katına çıkarır): günlük sınırlama ile yakalanır.
- Bad release(yeni versiyon 5x token kullanıyor): haftalık / aylık sınırlama ile yakalanmış.
- Legitimate surge(gerçek talep, bir hata değil): açık bir kayıt ile saat / gün kapalı tarafından yakalanmış.
Harness bütçe yüzeyi
Claude Code Agent SDK (ağcı belgeleri) açıklıyor:
max_turnsİterasyon kapısı.max_budget_usdDolarlık sınırlama; aşıklıkta kürtaj.allowed_tools- Ne ?disallowed_toolsalet aletleri ve deniller.- Özel maliyet hesaplama için araç kullanmadan önce kaçağı noktaları.
İzin modu merdivenine (Deneyim 10) birleştirin.autoModeOturma olmadanmax_budget_usdAntropic açıkça otomatik modun bütçe kontrollerini gerektiren çerçevesini oluşturur; sınıflandırıcı maliyetle ortogonaldır.
AB AI Yasası, OWASP Ajansı Top 10
Microsoft'un Ajan Yönetimi Araç Kütleği, OWASP Ajan Top 10 ve AB AI Yasası'nın 14 (insan denetimi) maddesindeki gereksinimleri kapsar.
Görülmüştür .$1,200 → $4.800 dava
Microsoft dosyalarında gerçek durum: yeni bir araç eklendiğinde aylık maliyetleri üç katına çıkmış bir e-ticaret ajansı. Araç, ajanın her oturumda sipariş durumunu sorgulamasına izin verdi. Çubuk algılama yok. Bir alet için şapka yok. Haftalar arası büyüme konusunda uyarı yok. Düzenleme, her aletin kapalılık ve günlük büyüme uyarısıydı. Bu bir şablon: her yeni araç yüzeyi yeni bir potansiyel döngüdür; her yeni araç kendi kapalı ve kendi uyarısı gerekir.
Kullan
code/main.pysimülasyonlu ajan birkaç dönüşten sonra bir oylama döngüsüne sürüklenir; katlı yığın, hız penceresinde yakalarken tek bir aylık kaplama birkaç gün sonra ateş etmez.
Gönder
outputs/skill-agent-budget-audit.mdÖdemelenen ajanların görevlendirilmesi için maliyet yöneticisi yığınını denetlemektedir ve eksik katmanları işaretler.
Egzersizler
- Çık .
code/main.pySeçim döngüsü trajektöründe iterasyon kapağından önce hız sınırı ateşlerini onaylayın. Şimdi hız sınırı etkisizleştirin ve iterasyon kapağı onu yakalamadan önce ajanın ne kadar "harcadığını" ölçün.
- Bir tarayıcı ajansı için her araç için bir kap seti tasarlayın (Deneyim 11). Hangi araç en sıkı kap ihtiyacı vardır? Hangi araç risk olmadan sınırsız çalışabilir?
- Microsoft Ajan Yönetim Araç Kütü Dokümanlarını okuyun. Her kapak türü araç kit isimlerini listelenin. Her birini başarısızlık modlarından birine (kaynak döngüsü, yavaş sızıntı, kötü yayın, yükseliş) haritasına yerleştirin.
- Gerçekçi bir görev için bir gece boyunca gözden geçirilmemiş bir çalışmanın fiyatı (örneğin "repoda 50 işlem ele alın").
max_budget_usd2x'i haklı çıkarın.
- Claude Code's'ın
max_budget_usdBu nedenle, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre sonra, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre sonra, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir süre, bir
Anahtar Terimler
| Term | What people say | What it actually means |
|---|---|---|
| Denial of Wallet | "Runaway bill" | Agent loop generating spend with no cap to stop it |
| max_tokens | "Per-request cap" | Ceiling on a single completion's size |
| max_turns | "Iteration cap" | Ceiling on agent loop iterations in a session |
| max_budget_usd | "Dollar kill switch" | Session cost cap; aborts on breach |
| Velocity limit | "Rate cap" | Limit on spend per short window (e.g., $50 / 10 min) |
| Tiered routing | "Small model first" | Cheap model default; escalate only when classifier warrants |
| Prompt caching | "Cached system prompt" | Provider-side cache reduces re-send token cost to near zero |
| HITL checkpoint | "Human approval gate" | Human tap required before expensive action |
Daha Fazla Okumak
- Anthropic Claude Code Agent SDK — agent loop and budgets
max_turns- Evet .max_budget_usd, araçları kullananlar. - Microsoft Agent Framework — human-in-the-loop and governance maliyet yöneticisi kontrol noktaları.
- Anthropic — Claude Managed Agents overview tedarikçi tarafından maliyet kontrolü.
- Anthropic — Prompt caching (Claude API docs)- Önbelleğe alma mekanizması.
- Anthropic — Measuring agent autonomy in practice Uzun üfüre sahip ajanlar için maliyet profili.
This free lesson is part of the AI Engineering from Scratch curriculum. Read the full explanation, run the lesson code, and verify the result in the interactive reader or from the repository source.
Browse the complete course catalog or open this lesson on GitHub.