# كيف تضع حدا صارما للإنفاق على مهمة وكيل برمجي؟ > يجب أن تفرض بوابة تملك ميزانية المهمة حدا صارما قبل كل استدعاء نموذج أو أداة مدفوعة. احجز التكلفة القصوى، وسوِّ الاستخدام الفعلي، وارفض الاستدعاءات التي لا تتسع لها الميزانية، وأنهِ الوكيل بنقطة استئناف مفيدة. # كيف تضع حدا صارما للإنفاق على مهمة وكيل برمجي؟ الميزانية الصارمة مسألة تحكم في القبول. قبل أي استدعاء مدفوع، يجب أن تثبت بوابة موثوقة أن أقصى تكلفة مسموحة تقع ضمن الرصيد المتبقي. لا تستطيع التنبيهات اللاحقة إيقاف تجاوز حدث بالفعل. اشمل الإدخال وأقصى إخراج وإعادة المحاولة والبدائل والوكلاء الفرعيين والتضمينات والبحث وsandboxes وكل أداة مدفوعة. ## افصل الحد الصارم عن الهدف المرن استخدم ثلاث قيم: | الضبط | الغرض | السلوك | |---|---|---| | الهدف | التكلفة المتوقعة | التنبيه أو اختيار خطة أرخص | | الحد المرن | عتبة التصعيد | طلب الموافقة أو خفض الجودة | | الحد الصارم | أقصى إنفاق مصرح | الرفض قبل الاستدعاء التالي | مثال: هدف $0.60، وموافقة عند $0.90، وتوقف عند $1.00. يجب أن يوجد الحد الصارم على الخادم لا في المطالبة فقط. ## مرر كل إجراء مدفوع عبر بوابة واحدة امنح الوكيل بيانات اعتماد قصيرة العمر تستدعي بوابتك فقط. تضيف البوابة `task_id`، وتراجع الميزانية، وتقدّر الإجراء، ثم تحجز أو ترفض. لا تكشف مفتاح مزود يسمح بتجاوز المحاسبة. طبّق القاعدة نفسها على البحث وsandbox وتنفيذ الكود والاسترجاع المدفوع. ## احجز قبل الاستدعاء وسوِّ بعده قدّر الحد الأعلى من tokens الإدخال المعروفة وأقصى إخراج. احجز ذرياً، نفّذ الاستدعاء، ثم استبدل الحجز بالاستخدام الفعلي. ```text remaining = hard_limit - committed_cost - open_reservations worst_case = input_cost + max_output_cost + tool_allowance if worst_case > remaining: reject("task_budget_exceeded") else: reserve(worst_case) call_provider() reconcile(actual_cost) ``` يمنع الحجز الذري وكيلين فرعيين من إنفاق الرصيد نفسه. ## استخدم جدول أسعار ذا إصدار احفظ السعر المستخدم مع كل تقدير. تتغير الأسعار والقواعد، ولا ينبغي أن يعيد تقرير لاحق حساب الماضي بسعر اليوم. إذا أعاد المزود التكلفة النهائية، فاحتفظ بالتقدير والمبلغ. إذا أعاد tokens فقط، فاستخدم نسخة جدول الأسعار المختارة قبل الاستدعاء. أضف هامشا للأدوات المجهولة أو ارفض ما لا يمكن تحديد حده. ## اجعل التدفق آمنا احجز تكلفة الإخراج المسموحة كاملة قبل فتح التدفق. سوِّ الاستخدام المتاح، لكن لا تفترض أن إغلاق العميل يوقف الفوترة فورا. الإلغاء تحسين وليس حد الإنفاذ. ضع حدا للإخراج ومهلة لكل استدعاء. يظل سقف المهمة شاملا لكل التدفقات وإعادة المحاولة والبدائل. ## أدرج إعادة المحاولة والوكلاء الفرعيين تخصم كل محاولة من دفتر المهمة الرئيسي. فتح ميزانية جديدة عند كل إعادة محاولة يبطل الحد. استخدم ميزانيات هرمية: | الدفتر | الحد | القاعدة | |---|---:|---| | المهمة الرئيسية | $1.00 | السقف المطلق | | وكيل التنفيذ الفرعي | $0.55 | لا يتجاوز رصيد المهمة الرئيسية | | وكيل تحليل الاختبار | $0.25 | يعيد الحجز غير المستخدم | | المراجعة النهائية | $0.20 | تعمل فقط عند بقاء رصيد | حدود الأبناء مخصصات وليست أموالا إضافية. ## توقف عند نقطة استئناف مفيدة إذا لم يتسع الإجراء التالي، فأعد خطأ ذا نوع ولا تكرر الاستدعاء المرفوض. أنشئ من السياق الموجود نقطة استئناف تتضمن: * التغييرات المكتملة والاختبارات؛ * العمل المتبقي والإجراء المحظور؛ * حالة المستودع الحالية؛ * تقدير الميزانية الإضافية؛ * رمز الاستئناف أو معرّف المهمة. هكذا يصبح توقف الميزانية تسليما مضبوطا. ## استخدم ضوابط المزود كحماية احتياطية تقلل حدود الحساب الأثر، لكنها نادرا ما تكون دقيقة لكل مهمة. قد تجمع مستودعات عديدة أو تتأخر أو تستبعد تكاليف الأدوات. حتى مع بوابة متعددة النماذج مثل Atlas Cloud، أبقِ الدفتر المرجعي في طبقة التنسيق وسجل معرّفات الاستخدام للتسوية. يبقى الحد قائما عند تغيير النموذج. ## اختبر الحد كضابط مالي اختبر التوازي والتدفقات الطويلة والمهل والاستخدام المفقود وإعادة المحاولة والبدائل وفشل الدفتر. ارفض افتراضيا إذا تعطلت خدمة الميزانية. يجب ألا يتجاوز مجموع التكلفة المؤكدة والحجوزات السقف أبدا. ## الخلاصة يُفرض الحد الحقيقي قبل الإنفاق باستخدام حجوزات ذرية ودفتر واحد لكل إجراء مدفوع. إذا كان النظام ينبه بعد الاستخدام فقط فهو مراقبة لا حد صارم. ## FAQ ### هل max_tokens حد مالي صارم؟ لا. فهو يحد طول استجابة واحدة، لا التكلفة الكلية ولا tokens الإدخال ولا إعادة المحاولة ولا تغيير النموذج ولا الأدوات. يحتاج الحد المالي إلى دفتر يغطي كل إجراء قابل للفوترة. ### أين يجب فرض ميزانية الوكيل؟ في بوابة من جهة الخادم أو طبقة تنسيق تمر عبرها كل استدعاءات النماذج والأدوات المدفوعة. يمكن تجاوز عدادات العميل أو أن تتسابق عند التوازي. ### كيف تُحجز ميزانية الاستجابة المتدفقة؟ احجز أقصى تكلفة إخراج مسموحة قبل فتح التدفق، ثم سوِّها مع الاستخدام المبلغ عنه عند الإغلاق. استخدم الإلغاء عند دعمه، لكن لا تعتمد عليه وحده. ### هل تشترك إعادة المحاولة في ميزانية المهمة الأصلية؟ نعم. يجب أن تخصم إعادة المحاولة والبدائل والوكلاء الفرعيون والتقييمات من الدفتر نفسه ما لم يوافق المستخدم صراحة على ميزانية منفصلة. ### ماذا يحدث عندما لا تكفي الميزانية المتبقية؟ ارفض الاستدعاء المدفوع التالي واطلب نقطة استئناف من السياق الموجود، تتضمن العمل المكتمل والبنود العالقة والميزانية الإضافية المطلوبة. ### هل يمكن أن تحل حدود حساب المزود محل حد المهمة؟ غالبا لا. فهي تحمي الحساب كله وقد تتحدث بشكل غير متزامن. توفر بوابة المهمة عزلا فوريا، ويبقى حد الحساب طبقة احتياطية.