إدارة التكاليف
يبيّن هذا الدليل كيف ترى ما تكلّفه تشغيلات الوكيل، وكيف تضع سقفًا لتشغيل مستقل.
كيف تُسجَّل التكاليف
قسم بعنوان “كيف تُسجَّل التكاليف”كل تشغيل لوكيل يكتب سجل تشغيل يحمل رموز الإدخال، ورموز الإخراج، ورموز الاستدلال، ورموز القراءة من الذاكرة المؤقتة، ورموز الكتابة إليها، وتكلفة تقديرية بالسنت، وتكلفة الوكلاء الفرعيين الذين أنشأهم.
تأتي الأسعار من فهرس models.dev، ولا يُستخدم إلا لإثراء قائمة النماذج بالسعر ونافذة السياق — ولا يُتَّخذ مصدرًا لمعرّفات النماذج. النموذج الذي يعجز الفهرس عن تسعيره تُسجَّل تكلفته $0، وتُستبعد التشغيلات ذات التكلفة الصفرية من ملخص الاستخدام والتكلفة. لذلك لا يظهر لنموذج Ollama المحلي أي إنفاق، مع أن أعداد رموزه تبقى مسجَّلة. وكذلك شأن خطة السعر المقطوع (kimi-code، أو اشتراك Claude)، ولكن فقط حين لا يملك الفهرس سعرًا للنموذج الذي خدم الطلب؛ فإن وُجد سعر، يُقدَّر التشغيل به على أي حال. وفي سلسلة الرجوع الاحتياطي يُسعَّر التشغيل مقابل النموذج الذي خدمه فعلًا، لا مقابل النموذج الذي طُلب.
اطّلع على ما تنفقه
قسم بعنوان “اطّلع على ما تنفقه”قابلية الملاحظة ← الرؤى
قسم بعنوان “قابلية الملاحظة ← الرؤى”تصل إليه من تذييل الشريط الجانبي ← قابلية الملاحظة. تفتح علامة تبويب الاستخدام أولًا (مجاميع الرموز التراكمية)؛ بدّل إلى الرؤى — العلامة الثانية — لسطح التكلفة الرئيسي:
- منتقي للنطاق الزمني: آخر 24 ساعة، وآخر 7 أيام، وآخر 30 يومًا، أو كل الوقت
- مرشّحات متعددة الأوجه على الوكيل والنموذج والحالة والدور، على هيئة شرائح يمكن إغلاقها
- شريط مؤشرات: إجمالي التشغيلات، وإجمالي التكلفة، ومعدل الأخطاء، ومعدل الذاكرة المؤقتة، ورمز / ثانية، ومتوسط زمن الاستجابة، والوقت حتى أول رمز، ولكل منها تغيّر مقارنة بالفترة السابقة (يختفي عند «كل الوقت»)
- مخطط النشاط ومخطط التكلفة عبر الزمن، مع تفصيل التكلفة حسب الدور الذي يقسم الإنفاق بين الرئيسي والوكلاء الفرعيين والمستشار
- جدول كل وكيل مرتَّب حسب التكلفة، أعلى عشرة مع مفتاح لعرض جميع الوكلاء. الضغط على صف يرشّح كل السطوح الأخرى إلى ذلك الوكيل
- سجل التشغيلات التفصيلي، ويرسو معه درج نص المحادثة للتشغيل الذي تختاره
الإعدادات ← الخادم ← مزوّدو النماذج
قسم بعنوان “الإعدادات ← الخادم ← مزوّدو النماذج”تعرض بطاقة الاستخدام والتكلفة في هذه الصفحة إنفاق الأيام السبعة الماضية المرصود رقمًا واحدًا بالدولار، مع تفصيل لكل مزوّد، والوقت حتى يُعاد تعيين نافذة الحصة التالية حين ينشر المزوّد موعدًا.
تشغيلات وكيل واحد
قسم بعنوان “تشغيلات وكيل واحد”الإعدادات ← مساحة العمل ← الوكلاء ← اختر الوكيل ← السجلات يسرد تشغيلاته مع الحالة، والمدة، ووقتَي البدء والاكتمال، وPID، والمحوّل. علامة التبويب هذه لا تعرض التكلفة — للإنفاق استخدم جدول كل وكيل في قابلية الملاحظة ← الرؤى.
ضع سقفًا لتشغيل مستقل
قسم بعنوان “ضع سقفًا لتشغيل مستقل”أمران من أوامر الشرطة المائلة، تكتبهما في حقل كتابة المساحة، هما التشغيلان الوحيدان اللذان لهما سقف إنفاق:
/goal ship the auth refactor --budget 20/loop keep the flaky tests green- يتوقف كل مقطع من تشغيل
/goalأو/loopحين يبلغ إنفاقه المسعَّر 500 سنت ($5.00). عند 80% من ذلك توجّه الحلقة النموذج أولًا ليختم العمل ويترك تسليمًا نظيفًا، فلا يموت في منتصف المهمة. - سقف الهدف الدائم كله 5000 سنت ($50.00)، ما لم تمرّر
--budget <dollars>. يمرّر المشرف ميزانية الهدف المتبقية إلى كل مقطع، فلا يجاوز مقطع كامل ميزانية صريحة. - يضيف
--days Nأجلًا بوقت الحائط، و--max Nسقفًا لعدد التشغيلات. لا يسري أي منهما إلا بطلب صريح؛ ومن دونهما لا يحدّ الهدف إلا التكلفة. - الهدف الذي يبلغ سقف ميزانيته يتوقف عند
budgetExhausted، ولا يُستأنف إلا برفع الميزانية.
لأن السقف مسعَّر، فالنموذج الذي يعجز الفهرس عن تسعيره لا يبلغه. ويحدّ مثل هذا التشغيل حارس تكرار الحلقة المفرغة، وكفّ المشرف عن المتابعة بعد ثلاثة إخفاقات متتالية، وأنت.
رسالة في مساحة، أو إشارة بـ @، أو خطوة خط أنابيب، بلا سقف إنفاق. ينتهي التشغيل حين يتوقف النموذج، أو حين توقفه أنت، أو حين يوجّهه حارس الحلقة المفرغة.
خفّض استهلاك الرموز
قسم بعنوان “خفّض استهلاك الرموز”اضغط محادثة طويلة
قسم بعنوان “اضغط محادثة طويلة”اكتب /compact في حقل كتابة المساحة. يعترضه العميل ولا يبلغ نص المحادثة؛ ويطوي الخادم السجل الأقدم في ملخص مثبَّت، وتتابع المحادثة على السياق المضغوط.
يُرفض الضغط ما دام الوكيل في منتصف جولة، وحين لا يوجد سجل قديم بما يكفي للطي. ويضغط الإطار المضمّن من تلقاء نفسه حين يقترب السجل من نافذة سياق النموذج.
اختر مستوى الجهد عن قصد
قسم بعنوان “اختر مستوى الجهد عن قصد”يعرض جهد الاستدلال للوكيل (الإعدادات ← مساحة العمل ← الوكلاء) المستويات التي ينشرها النموذج المختار. المستويات الأعلى تنفق رموز استدلال أكثر. أبقِ المستويات العليا للعمل الذي يحتاجها.
اختر النموذج لكل وكيل
قسم بعنوان “اختر النموذج لكل وكيل”النموذج حقل لكل وكيل، فيعمل وكيل الصياغة أو الفرز على نموذج رخيص، ويعمل الوكيل المعماري على نموذج غالٍ. رشّح جدول كل وكيل في قابلية الملاحظة ← الرؤى حسب النموذج، لترى أي اقتران بين النموذج والوكيل يكلّفك فعلًا.
ابحث عن تشغيلات بعدد رموز خارج المألوف
قسم بعنوان “ابحث عن تشغيلات بعدد رموز خارج المألوف”افتح سجل التشغيلات في الرؤى (أحدث 50 تشغيلًا بعد الترشيح) ودرج نص المحادثة لأي شيء غير معتاد. الأسباب الشائعة مطالبة نظام أو شخصية أطول مما ينبغي، وسياق كان ينبغي ضغطه، ومهمة كان ينبغي أن تكون عدة مهام أصغر.
ماذا يحدث إذا ضُبطت ميزانية خارج المسار
قسم بعنوان “ماذا يحدث إذا ضُبطت ميزانية خارج المسار”للاكتمال، إذا كُتب monthlyBudgetCents أو سياسة ميزانية مباشرة في صف الوكيل:
- تُقيَّم الميزانيات بعد اكتمال التشغيل، لا قبل الإرسال. يقارن مستمع اكتمال التشغيل إنفاق الوكيل منذ مطلع الشهر بسقفه.
- تجاوز العتبة اللينة (80% افتراضيًا) يسجّل حادثة تحذير، وينشر حدث
BudgetThresholdCrossedتستطيع أن تربط به مشغّل خط أنابيب. - استنفاد الميزانية يسجّل حادثة صارمة، وينشر الحدث نفسه، ويقلب حالة دورة حياة الوكيل إلى
paused. - حاجز ما قبل الإرسال موجود، ولا يرجع إليه إلا حاصد التشغيلات اليتيمة وموفّق التذاكر العالقة عند جدولة الاستعادة — والإرسال العادي لا يبلغه، ولا شيء في مسار الإرسال يفحص حالة
paused. الإشارة الظاهرة الوحيدة هي شارة دورة الحياة في الهيكل التنظيمي.