بودجه های اقدام، محدودیت های تکراری و دولت هزینه
max_tokens، توکن و بودجه دلاری در هر کار، محدودیت های روزانه / ماه، محدودیت های تکرار، مسیر مدل های طبقه بندی شده، ذخیره سازی سریع، پنجره های زمینه، نقاط بازرسی HITL در اقدامات گران قیمت، سوئیچ های کشتن در نقض بودجه. SDK کلوید کد عامل Anthropic با نام های مختلف همان ابتدایی را ارسال می کند. محدودیت های سرعت مالی به عنوان مثال دسترسی را به > 50 دلار در 10 دقیقه کاهش می دهد حلقه های سریع تر از محدودیت های ماهانه را ضبط می کند.Type: Learn
Languages: Python (stdlib, layered cost-governor simulator)
Prerequisites: Phase 15 · 10 (Permission modes), Phase 15 · 12 (Durable execution)
Time: ~60 minutes
مشکل
در هر مرحله ای، عوامل مستقل پول واقعی را خرج می کنند. نتیجه بد یک چتبات یک پاسخ بد است؛ حلقه بد یک عامل یک لایحه است. اصطلاح مستند صنعت برای حالت شکست "حرمان کیف پول" است.
یک سقف خوب طراحی شده یک حلقه فرار در عرض چند دقیقه، یک لیک آهسته در عرض چند ساعت و یک انتشار بد در عرض یک روز را در اختیار می گیرد. همان سقف بودجه را در زمانی که عامل افق طولانی و مستقل است حفظ می کند.
این یک درس مهندسی است: ریاضیات معمولی است، رشته جایی است که تیم ها شکست می خورند. لیست محدودیت های زیر همه نامگذاری شده اند یا در ابزار مدیریت عامل مایکروسافت یا اسناد SDK عامل کد Anthropic Claude.
مفهوم
سکه دولت
max_tokensper request.ساده، از هر تماسي که از يک تماس خارج شده، جلوگیری ميکنه- Per-task token budget.در تمام زمان، از نمره N عبور نکنید.
- Per-task dollar budget.مثل توکن ها اما در ارز
max_budget_usdدر کلوید کد - Per-tool call cap.نه بیشتر از N
WebFetchتماس هاshell_execتماس ها و غیره - Iteration cap (
max_turns).تکرار کامل حلقه عامل؛ از حلقه های استدلال بی نهایت جلوگیری می کند. - Per-minute / per-hour / per-day / per-month cap.پنجره هاي چرخنده، در مقیاس زماني مختلف دزدي ميکنه
- Financial velocity limit.مثلاً "اگر هزینه بیش از 50 دلار در 10 دقیقه باشد، دسترسی را قطع کنید".
- Tiered model routing.پیش فرض به یک مدل کوچکتر؛ افزایش به یک مدل بزرگتر تنها زمانی که یک طبقه بندی کننده وظیفه را توجیه می کند.
- Prompt caching.سیستم سریع و پایدار زمینه ذخیره شده در کش ارائه دهنده؛ هزینه توکن ارسال مجدد نزدیک به صفر است.
- Context windowing.کمپیکنگی / خلاصه کردن برای حفظ زمینه فعال زیر یک حد؛ کاهش مستقیم هزینه توکن.
- HITL checkpoints on expensive actions.قبل از اینکه یک عمل شناخته شده به عنوان گران است (مطالعه ابزار طولانی، دانلود بزرگ، ارتقاء مدل گران قیمت) نیاز به یک ضربه انسانی.
- Kill switch on budget breach.جلسه وقتی هر کلاهی روشن می شود متوقف می شود. کلاهی ثبت می شود؛ یک مسیر جداگانه را نیاز دارد که دوباره فعال شود.
چرا يه دسته، نه يه کلاه
یک کیپ ماهانه تنها پس از از اینکه کیف پول از بین رفته است، یک عامل فرار را می گیرد. یک کیپ در هر درخواست هیچ چیز را در سطح جلسه نمی گیرد. حالت های شکست مختلف زمان های مختلف را نیاز دارند:
- Runaway loop(عميل در 5 ثانیه دوباره امتحان کرد): با سرعت محدود شده
- Slow leak(عملی که حدود 2 برابر کاری که در هر وظیفه انجام می شود انجام می دهد): با حد روزانه دستگیر شده است.
- Bad release(برنامه جدید از توکن های 5x استفاده می کند): با حد هفتگی / ماهانه ضبط شده است.
- Legitimate surge(تطلب واقعی، نه یک خطا): با ساعت / روز با روز روشن گیر کرده است.
سطح بودجه آستین
SDK کلوید کد عامل (دستگاه های عمومی) نشان می دهد:
max_turnsکلاه تکرارmax_budget_usdدلاری؛ سقط جنین در جلسه در مورد نقض.allowed_tools-disallowed_toolsآلات و مواد- نقاط قوس قبل از استفاده از ابزار برای حسابداری هزینه های سفارشی.
با پله اجازه (درسه 10) ترکیب کنید.autoModeجلسه بدونmax_budget_usdآنترپک به طور صریح حالت اتوماتیک را به عنوان نیاز به کنترل بودجه تعریف می کند؛ طبقه بندی کننده با هزینه orthogonal است.
قانون هوش مصنوعی اتحادیه اروپا، سازمان OWASP Top 10
ابزار مدیریت عوامل مایکروسافت، ۱۰ مورد اصلی آژانس OWASP و متطلبات ماده ۱۴ قانون هوش مصنوعی اتحادیه اروپا ( نظارت انسانی) را پوشش می دهد. برای تولید در اتحادیه اروپا، قطع چوب و اجرای محدودیت های اضافی اختیاری نیست.
مشاهده شده$1,200 → $4800 مورد
مورد واقعی در اسناد مایکروسافت: یک آژانس تجارت الکترونیکی که هزینه ماهانه اش پس از اضافه شدن یک ابزار جدید سه برابر شد. اين ابزار به مامور اجازه داد تا در هر جلسه حالت سفارشات رو بررسی کنه هیچ تشخیص حلقه ای نیست هیچ کلاهی برای هر ابزار نیست هيچ هشداري در مورد رشد هفته به هفته وجود نداره درستش يه حد براي هر ابزار و يه هشدار روزانه رشد بود این یک قالب است: هر سطح ابزار جدید یک حلقه بالقوه جدید است؛ هر ابزار جدید نیاز به پوشش و هشدار خاص خود دارد.
ازش استفاده کن
code/main.pyیک عامل شبیه سازی شده با و بدون یک استیک پرتدار دولت هزینه اجرا می شود. عامل شبیه سازی شده پس از برخی از دورها به حلقه رای گیری می رود؛ استیک پرتدار آن را در پنجره سرعت می گیرد در حالی که یک کیپ ماهانه تا چند روز بعد نمی شود.
-باده
outputs/skill-agent-budget-audit.mdبررسی هزینه های یک مأمور پیشنهاد شده را انجام می دهد و لایه های گمشده را نشان می دهد.
تمرینات
- فرار کن
code/main.py.حد سرعت قبل از کپی تکرار در یک مسیر بازرسی را تایید کنید. حالا محدودیت سرعت را غیرفعال کنید و اندازه گیری کنید که قبل از کپی تکرار چقدر مصرف می کند.
- طراحی یک مجموعه کلاه هر ابزار برای یک عامل مرورگر (درس 11) کدام ابزار به سخت ترین کلاه نیاز دارد؟ کدام ابزار می تواند بدون خطر بدون محدودیت اجرا شود؟
- اسناد ابزار مدیریت مامور Microsoft را بخوانید. هر کاپ را با نام ابزارک تایپ کنید. هر یک را به یکی از حالت های شکست (لوپ فرار، لیک آهسته، انتشار بد، افزایش) نقشه بزنید.
- قیمت یک روز بدون نظارت برای یک کار واقع بینانه (به عنوان مثال "تراژ 50 مسئله در یک ریپو")
max_budget_usdدر 2x تخمین امتیاز شما. 2x را توجیه کنید.
- کلوید کوید
max_budget_usdبا این حال، در حال حاضر، این برنامه ها به طور کامل به سرعت در حال انجام شدن هستند.
اصطلاحات کلیدی
| 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 |
خواندن بیشتر
- Anthropic Claude Code Agent SDK — agent loop and budgets
max_turns،max_budget_usd،آرهنگان ابزار - Microsoft Agent Framework — human-in-the-loop and governance پستهای کنترل هزینه های دولت
- Anthropic — Claude Managed Agents overview کنترل هزینه های طرف ارائه دهنده.
- Anthropic — Prompt caching (Claude API docs) مکانیک های ذخیره سازی
- Anthropic — Measuring agent autonomy in practice مشخصات هزینه برای عوامل بلندمایه
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.