تعيين حد ميزانية بالدولار لتشغيل الوكيل

استخدم max_budget_usd لتحديد تكلفة التشغيل واكتشاف حالة تجاوز الميزانية النهائية.

الهدف

ضع حاجز تكلفة لوكيل يستطيع استدعاء الأدوات وتنفيذ أدوار متعددة.

عيّن حداً معتمداً بالدولار باستخدام ClaudeAgentOptions(max_budget_usd=0.10). [budget]
كرر تدفق النتائج واقرأ ResultMessage.total_cost_usd وsubtype. [budget]
اعتبر subtype == "error_max_budget_usd" توقفاً بسبب الميزانية واعرض الناتج الجزئي والتكلفة الفعلية. [budget]

يتعرف اختبار الميزانية المنخفضة على الحالة ويسجل التكلفة النهائية بدلاً من اعتبارها نجاحاً عادياً.

إذا تجاوزت التكلفة النهائية الحد قليلاً، يوضح README أن الفحص يحدث بعد كل استدعاء API وقد يتجاوز بمقدار استدعاء واحد؛ اترك هامشاً.

يحدد المستدعي سياسة الميزانية؛ ولا تضع مفاتيح المستخدم أو تفاصيل الفواتير في مطالبات الوكيل.

حد الميزانية ليس إيقافاً صارماً لكل token، ولا يعيد توقف الميزانية آثار الأدوات الجانبية تلقائياً.

تعكس هذه القيم المستودع الأصلي كله، ولا تمثل إعجابات أو شعبية مهارة أو دليل منفرد.

لا تتوفر لقطة مقاييس بعد.

الترخيص: MIT