تخيّل إصلاحًا لخلل يغيّر 12 سطرًا. يقرأ الوكيل المشروع، ويضع خطة، ويبدأ مهمة فرعية، ويشغّل الاختبارات، ويقرأ حالات الإخفاق، ثم يحاول مرة أخرى قبل أن ينتج هذا التعديل.
تشمل الفاتورة كل طلب أوصله إلى تلك النتيجة.
وهذا يجعل من السهل على نحو مفاجئ أن تدفع أكثر من اللازم مقابل مهمة قصيرة. فالمحادثة الطويلة قد تحمل ملفات قديمة إلى الطلبات اللاحقة. وقد تعيد أداة صفحات من البيانات بينما لا يتطلب القرار التالي سوى سجل واحد. وقد يكرر عدة وكلاء التحقيق نفسه.
يمكنك العثور على هذه التكاليف في سجل التنفيذ. ابدأ بمهمة واحدة، وتتبّع كل ما تستهلكه، وتحقق مما إذا كانت النتيجة تجتاز الاختبار فعلًا. ثم غيّر الجزء الذي يؤدي عملًا غير ضروري.
1. حدّد سعرًا للمهمة المنجزة
اختر مهمة تكررها: إصلاح خلل مُبلّغ عنه، أو إعداد موجز بحثي، أو التحقق من دفعة من سجلات العملاء. حدّد شروط اعتبار المهمة منجزة قبل تشغيلها.
في إصلاح خلل، قد يتطلب القبول اختبارًا يعيد إنتاج الإخفاق الأصلي، ونتيجة ناجحة بعد التغيير، وعدم وجود إخفاق في اختبارات التكامل المتأثرة. لا تكفي رسالة تقول إن الخلل أُصلح لاستيفاء هذه الشروط.
امنح المهمة معرّفًا. احتفظ بالمعرّف نفسه عبر إعادة المحاولات ووكلاء المساعدة والتحقق والنتيجة النهائية. سجّل معرّف طلب منفصلًا لكل استدعاء للنموذج كي تتمكن من اكتشاف الطلبات المكررة في سجلاتك.
الحساب الأساسي هو:
التكلفة لكل مهمة مقبولة = إجمالي الإنفاق المسجل / عدد المهام المقبولة
أدرج المحاولات التي أخفقت. إذا كلفت 10 مهام 8 دولارات إجمالًا ولم تنجح سوى 4، فالتكلفة 2 دولار لكل مهمة مقبولة. وأظهر معدل القبول البالغ 40% بجانب ذلك الرقم. إذا لم تُقبل أي مهمة، فأبلغ عن الإنفاق وعدد المهام المقبولة وهو صفر؛ إذ لا تكون النسبة معرّفة.
تتبّع وقت الإصلاح البشري بشكل منفصل. فسير العمل الذي يوفر دولارًا واحدًا من رسوم واجهة API ويتطلب 20 دقيقة من التنظيف يتضمن مفاضلة تستحق أن تكون واضحة.
في العمل على واجهة API، احفظ استجابة الاستخدام الصادرة عن الجهة الموفرة، ومعرّف النموذج، وتاريخ التسعير، ورسوم الأدوات، ونتيجة المهمة، والطوابع الزمنية. إذا كانت بيانات الاستخدام مفقودة بعد انتهاء المهلة، فضع علامة على أن التكلفة غير معروفة وطابقها مع سجلات الجهة الموفرة. عدم وجود استجابة لا يثبت أن الطلب كان مجانيًا. وإذا ظل أي طلب بلا سعر، فضع علامة على أن إجمالي الدفعة غير مكتمل.
يمكن لمستخدمي Claude Code البدء بـ /usage و/context. يساعد الأول على فحص الاستخدام، بينما يعرض الثاني ما يشغل مساحة في المحادثة. وفي الاشتراك، لا يُعد التقدير المحلي بالدولار فاتورة منفصلة، كما أن نافذة السياق حد مختلف عن حصة خطتك.
2. اعثر على السياق الذي يتكرر ظهوره
رسالتك الأخيرة ليست سوى جزء من طلب النموذج. ففي Claude Code، قد تتضمن الطلبات أيضًا تعليمات المشروع وأوصاف الأدوات وسجل المحادثة ومحتويات الملفات ونتائج الأدوات السابقة.
لنفترض أن مستندًا من 12,000 رمز، لم يتغير، يظهر في 8 طلبات. يسهم المستند عبر هذه الاستدعاءات بـ 96,000 رمز إدخال. وقد تُحاسب قراءات الذاكرة المؤقتة المؤهلة بسعر أقل. ومع ذلك، قد يظل المستند غير ذي صلة ببعض تلك القرارات.
افحص تسلسل مهمة واحدة. ما الملفات التي قُرئت؟ وما المخرجات التي بقيت في المحادثة؟ وأي طلب تسبب في أكبر زيادة؟ وهل ظل الوكيل يستخدم تلك التفاصيل حتى النهاية؟
في حالة خلل في إجمالي فاتورة، ابدأ بالمدخل الذي أدى إلى الإخفاق، والعملية الحسابية، والجهات التي تستدعيها، والاختبارات التي تغطيها. ودع الوكيل يتتبع المراجع عند الحاجة إلى مزيد من المعلومات. قد يؤدي تحميل مستودع كامل مسبقًا إلى جعل كل جولة لاحقة تحمل مواد لم تسهم قط في الإصلاح.
احتفظ بالأدلة الكاملة على القرص. وأعِد نتيجة موجزة تتضمن مسار الملف وتفاصيل كافية لفحص الأصل. وفي تشغيل الاختبار، يعني ذلك الأمر ورمز الخروج وأسماء الاختبارات الفاشلة والخطأ ذي الصلة وموقع السجل.
إن ملخصًا يحذف الدليل الوحيد سيؤدي إلى مزيد من العمل. احتفظ برسالة الخطأ الدقيقة والمعرّف المتأثر والأدلة اللازمة للإجراء التالي.
3. تحقّق مما إذا كانت ذاكرة التخزين المؤقت تؤدي عملًا مفيدًا
تعيد الذاكرة المؤقتة للمطالبات استخدام بداية مطابقة ومؤهلة من الطلب. ضع التعليمات الثابتة أولًا، ثم بيانات المهمة المتغيرة بعدها.
في سير عمل مخصص باستخدام Claude API، قد يؤدي وضع طابع زمني قبل حد التخزين المؤقت إلى إنشاء إدخال مختلف في كل استدعاء. ضع الحد بعد المحتوى المتكرر. وراجع وثائق التخزين المؤقت الحالية لطرازك وبنية طلبك.
قارن قراءات الذاكرة المؤقتة وكتابتها عبر الطلبات. إذا تكررت الكتابة وقلّت القراءات، فتحقّق من تغييرات البادئة والحد الأدنى للطول المؤهل ومدة الصلاحية والتوقيت.
قراءة ذاكرة التخزين المؤقت تظل مكلفة. قد تعني كثرة القراءات أن التخزين المؤقت يعمل؛ تحقّق أيضًا مما إذا كان هذا السياق يساعد على إنجاز المهمة.
في Claude Code، للوكلاء الفرعيين العاديين سياقهم الخاص وسلوكهم الخاص في التخزين المؤقت. أما التفريع فيعمل بطريقة مختلفة. ويستخدم ضغط السياق أيضًا طلبًا إلى نموذج، ثم يعيد بناء سياق المحادثة. تجنّب جدولة ضغط يدوي كل بضع دقائق من دون قياس النتيجة.
4. قلّص ما تعيده الأدوات
قد تصبح استجابة الأداة مدخلًا لطلبات لاحقة إلى النموذج. لذلك قد تؤثر الاستجابة الكبيرة في أكثر من الطلب الذي جلبها أصلًا.
لنتناول تقرير الطلبات اليومي. تجلب أداة جميع الطلبات، ويقرأ النموذج كل صف، ثم يطلب منه طلب آخر حساب الإجماليات. يمكن لبرنامج نصي تصفية السجلات وحساب الإجماليات وإرجاع الحالات الاستثنائية التي تتطلب حكمًا بشريًا.
هذا يغيّر ما يصل إلى النموذج. كما ينشئ عملية حسابية يمكنك اختبارها بشكل مستقل.
استخدم النهج نفسه مع السجلات وجداول البيانات ونتائج البحث. صفِّ البيانات حسب العميل أو التاريخ أو الخطأ أو نوع السجل ذي الصلة قبل إرجاعها. أدرج عامل التصفية المستخدم، وعدد السجلات التي عولجت، وأي اقتطاع، ومسارًا أو معرّفًا للأدلة الأصلية.
تحقّق من ترقيم الصفحات. معالجة الصفحة الأولى وتقديمها على أنها مجموعة البيانات كاملة تمنحك إجابة خاطئة بتكلفة أقل.
يمكن أن تبقى النتائج الوسيطة في بيئة التنفيذ، بينما تصل البيانات المحددة فقط إلى النموذج. يمكنك تطبيق هذا المبدأ في برنامج نصي محلي صغير من دون بناء نظام وكلاء معقد.
تشغل تعريفات الأدوات مساحة من السياق أيضًا عند تحميلها. تؤجل بعض العملاء بالفعل تحميل التعريفات الكاملة إلى حين الحاجة إليها. افحص إعدادك الفعلي قبل إزالة التكاملات: فعدد الاتصالات وحده لا يبيّن حجم الرموز التي تستهلكها.
5. احفظ الإجراء بعد أن تتوصل إليه
انتبه إلى المهام التي يعيد فيها الوكيل اكتشاف الأوامر نفسها، أو إعادة كتابة الخطة نفسها، أو تحديد الاختبارات التي سيجريها من الصفر.
ما إن تفهم الإجراء، احفظه. ضع التعليمات الخاصة بالمشروع في دليل قصير قابل لإعادة الاستخدام. وضع العمليات الحسابية الثابتة وتحويلات الملفات وتسلسلات الأوامر في برنامج نصي مختبر.
في حالة خلل الفاتورة، يمكن لبرنامج نصي إعداد بيانات اختبار، وتنفيذ العملية الحسابية، ومقارنة القيمة المتوقعة، والإبلاغ عن النتيجة. يظل على الوكيل تشخيص أي اختلاف غير متوقع واختيار إصلاح صحيح. لكنه لا يحتاج إلى ابتكار أمر الاختبار في كل مرة.
اربط الإجراء بالافتراضات التي يستند إليها. سجّل التبعيات المطلوبة والمدخلات المتوقعة والظروف التي تستوجب إيقافه. عندما تتغير البيئة، يكون تشخيص إخفاق ظاهر أسهل من تشخيص رسالة نجاح تبدو معقولة.
تستحق عمليات التحقق المتكررة من الحالة المعاملة نفسها. إذا كانت الخدمة توفر معرّف مهمة، فاستخدم حدث اكتمالها أو دالة استطلاع محدودة. أعد النتيجة إلى النموذج عند اكتمال المهمة أو إخفاقها أو تجاوزها الموعد النهائي.
تتطلب إعادة المحاولة عناية إضافية في الإجراءات التي تنشئ شيئًا أو ترسله. تحقّق مما إذا كانت المحاولة الأولى قد نجحت قبل تكرارها. ويمكن لإعادة استخدام مفتاح عدم التكرار، حيثما كان مدعومًا، أن تمنع تحوّل استجابة غير مؤكدة إلى طلبين أو رسالتين.
6. أسند إلى كل وكيل مهمة مختلفة
يمكن للوكلاء المتوازيين تقليل الوقت المستغرق. لكن استدعاءاتهم وسياقاتهم والتنسيق بينهم تسهم أيضًا في إجمالي التكلفة.
قسّم العمل عندما تكون المهام مستقلة ويسهل جمع مخرجاتها. يمكن لوكيل إعادة إنتاج الخلل المُبلّغ عنه، بينما يتحقق آخر من عقد الواجهة المتأثرة. امنح كل وكيل سؤالًا واضحًا ونتيجة محددة.
تجنّب تكليف عدة مساعدين بالتعليمات العامة نفسها لفحص كل شيء. فقد يؤدي ذلك إلى تكرار التحقيق نفسه عدة مرات، ثم الحاجة إلى جولة أخرى للتوفيق بين ملخصاتهم.
يحدّد التسليم المفيد المهمة والملفات ذات الصلة والتغييرات المسموح بها والمخرجات المتوقعة وشرط التوقف. اطلب مسارات الأدلة والنتائج اللازمة للخطوة التالية. واترك العمل الوسيط المطوّل متاحًا في ملفات المساعد.
وزّع مهام التحقق عن قصد. أجرِ فحوصًا مركزة أثناء التنفيذ، ثم أجرِ الفحوص الأوسع المطلوبة على النتيجة المجمّعة. أعد الفحص إذا تغيّر الرمز البرمجي أو أخفق تشغيل سابق أو ظهرت أدلة جديدة تستدعي ذلك. سجّل سبب كل تشغيل.
قِس تغييرات النموذج بمعزل عن تغييرات سير العمل. استخدم مجموعة المهام نفسها واختبارات القبول نفسها عند تجربة نموذج أو إعداد استدلال مختلف. ضمّن إعادة المحاولات ووقت الإصلاح في المقارنة. لا يفيد انخفاض سعر كل استدعاء إلا إذا ظل العمل بأكمله مجديًا.
7. اقرأ حقول الاستخدام قراءة صحيحة
تعرض الجهات الموفرة المختلفة المدخلات المخزنة مؤقتًا بطرق مختلفة. وقد يؤدي نسخ معادلة جهة موفرة إلى سجلات جهة أخرى إلى فاتورة تبدو مقنعة لكنها خاطئة.
في استجابة Claude Messages القياسية، تُعد input_tokens وcache_creation_input_tokens وcache_read_input_tokens فئات إدخال منفصلة. وقد يُقسّم إنشاء ذاكرة التخزين المؤقت أيضًا حسب مدة الصلاحية. طابق كل فئة مع سعرها.
في المخطط الحالي لـ OpenAI Responses، يقع الإدخال المخزن مؤقتًا وأعداد الكتابة إلى الذاكرة المؤقتة المنطبقة ضمن إجمالي الإدخال. ينبغي طرحها بالطريقة الموثقة قبل تسعير الإدخال العادي. استخدم طريقة الحساب الخاصة بالجهة الموفرة للطراز وواجهة API اللذين تستخدمهما فعليًا.
احتفظ باستجابة الاستخدام الأصلية إلى جانب السجل الموحّد. يتيح لك ذلك تصحيح الحساب عند تغيير الجهة الموفرة أو النموذج أو الأسعار.
تنشئ بعض الميزات أيضًا عملًا إضافيًا مفوترًا. عند ضغط السياق باستخدام Claude API، تستثني أعداد الإدخال والإخراج على المستوى الأعلى دورة الضغط. سعّر الإدخالات في usage.iterations مرة واحدة، باستخدام حقول الاستخدام في كل إدخال. لا تضف الأعداد على المستوى الأعلى مرة أخرى.
قد تُفرض رسوم منفصلة على تنفيذ الأدوات والبحث والاستضافة والتخزين. إذا لم تشمل هذه الرسوم، فسمِّ الرقم تكلفة النموذج. وبالنسبة إلى الطلبات المتدفقة، استخدم إجماليات الاستخدام عند اكتمالها متى توفرت، وتجنّب احتساب التحديثات التراكمية أكثر من مرة.
8. نفّذ دفعة واحدة
إليك حسابًا توضيحيًا يمكنك إعادة تنفيذه. أعداد الطلبات وأحجام الرموز ورسوم الأدوات والنتائج أدناه افتراضية. لم يُشغّل أي وكيل لإنتاجها.
تستخرج مهمة المثال ثلاث قيم ومقاطع داعمة لها من كل واحد من أربعة مستندات. ولا تُقبل النتيجة إلا إذا كان JSON والقيم وأدلة المصادر صحيحة.
يفترض كلا السيناريوهين قبول ثلاث نتائج، ورفض محاولة واحدة تتطلب إعادة المحاولة، وإخفاق مهمة واحدة في نهاية المطاف. أي خمس محاولات عبر أربع مهام. تسهم كل محاولة في الفاتورة.
يتضمن السيناريو الأول 15 طلبًا إلى النموذج: 375,000 رمز إدخال غير مخزّن مؤقتًا و15,000 رمز إخراج. وفق أسعار Claude Haiku 4.5 القياسية التي جرى التحقق منها في 7 سبتمبر 2026، تبلغ تكلفة مليون رمز إدخال دولارًا واحدًا، وتكلفة مليون رمز إخراج 5 دولارات. وتبلغ رسوم النموذج 0.45 دولار. أضف 0.06 دولار من رسوم الأدوات الخارجية الافتراضية، ليصبح الإجمالي 0.51 دولار.
اقسم 0.51 دولار على النتائج الثلاث المقبولة: 0.17 دولار لكل نتيجة مقبولة.
يفترض السيناريو الثاني 10 طلبات تتضمن مدخلات جديدة أقل وبعض المدخلات المخزنة مؤقتًا. وتتوزع رسوم النموذج فيه كما يلي:
• 55,000 رمز إدخال غير مخزّن مؤقتًا بسعر دولار واحد لكل مليون: 0.055 دولار.
• 25,000 رمز كتابة إلى الذاكرة المؤقتة لمدة خمس دقائق بسعر 1.25 دولار لكل مليون: 0.03125 دولار.
• 25,000 رمز كتابة إلى الذاكرة المؤقتة لمدة ساعة بسعر دولارين لكل مليون: 0.05 دولار.
• 50,000 رمز قراءة من الذاكرة المؤقتة بسعر 0.10 دولار لكل مليون: 0.005 دولار.
• 7,500 رمز إخراج بسعر 5 دولارات لكل مليون: 0.0375 دولار.
يبلغ إجمالي رسوم النموذج 0.17875 دولار. أضف 0.05 دولار من رسوم الأدوات الخارجية الافتراضية: يصبح المجموع 0.22875 دولار لجميع المحاولات، أو 0.07625 دولار لكل نتيجة مقبولة. توضح مدد التخزين المؤقت المختلفة فئات المحاسبة، ولا تمثل إعدادًا موصى به.
توضح هذه الأرقام تكلفة الاستخدام المذكور. لكنها لا تثبت أن تصفية السياق أو تغيير حد التخزين المؤقت سيؤدي إلى هذه الأعداد أو يحافظ على الجودة. تتطلب المقارنة الحقيقية تسجيل الطلبات والتحقق المستقل من النتائج. وتظل المهام التي أخفقت ضمن الإجمالي.
9. طبّق ذلك على سير عملك
اختر مجموعة صغيرة من المهام الممثلة، وأبقِ مدخلاتها كما هي. أدرج حالة نجاح عادية، وحالة صعبة، ومهمة سبق أن أخفقت. اكتب فحوص القبول قبل إجراء التغييرات.
شغّل سير العمل الحالي واحفظ سجلات طلباته. حدّد النقطة التي دخلت فيها مواد غير ضرورية إلى المحادثة، أو أُعيد فيها بناء إجراء، أو أُجري فيها فحص مكرر، أو أدى فيها خطأ لم يتغير إلى محاولة أخرى.
غيّر آلية واحدة. صفِّ نتيجة كبيرة من أداة. احفظ تسلسل أوامر متكررًا. أصلح حد التخزين المؤقت. ضيّق نطاق تكليف مساعد واحد. أبقِ النموذج ومعايير القبول كما هما في تلك المقارنة.
أعد تشغيل المدخلات نفسها في بيئة اختبار نظيفة. ميّز بين عمليات التشغيل الأولية وتلك التي دُفئت فيها ذاكرة التخزين المؤقت. كرر عددًا كافيًا من المرات لمعرفة ما إذا كانت النتيجة متسقة، وأبقِ المحاولات الفاشلة ضمن الإجماليات.
استخدم هذا الطلب مع وكيل برمجة يمكنه الوصول إلى تطبيقك وسجلاتك:
افحص سير العمل هذا وسجلات التنفيذ المتاحة له.
حدّد نطاق المهمة وفحوص القبول. تتبّع استدعاءات العملية الأم، واستدعاءات المساعدين، وإعادات المحاولة، والتحقق، والنتيجة النهائية.
أنشئ تقريرًا محليًا يعرض تكلفة النموذج المسجلة، ورسوم الأدوات المنفصلة، وبيانات الاستخدام المفقودة، والمهام المقبولة، والمهام الفاشلة، والوقت المنقضي، والتدخلات البشرية. استخدم حقول الاستخدام الخاصة بالجهة الموفرة الحالية وبطاقة أسعار مؤرخة. احتفظ باستجابات الاستخدام الخام. أزل تكرار معرّفات الطلبات.
حدّد أكبر تكلفة يمكن تجنبها وتدعمها السجلات. أشر إلى الاستدعاءات المحددة واشرح سبب عدم الحاجة إلى العمل. وافصل التقديرات عن المبالغ المسجلة.
اقترح تغييرًا واحدًا ومقارنة تستخدم المدخلات والنموذج وفحوص القبول نفسها. افصل بين عمليات التشغيل الأولية وتلك التي دُفئت فيها ذاكرة التخزين المؤقت. توقّف إذا كانت الأدلة المطلوبة غير متاحة، وحدّد المطلوب بالضبط.
لا تُجرِ طلبات مدفوعة إلى واجهة API ولا تغيّر سير العمل المباشر أثناء هذا الفحص. احفظ التقرير والتعديل المقترح لمراجعتهما.
فحوص القبول هي ما يجعل المقارنة نزيهة. إذا أخفت تصفية سجل الإخفاق، أو احتاج نموذج أصغر إلى إصلاحات متكررة، فسجّل هذه النتيجة وراجع التغيير.
أكتب هنا عن مسارات عمل عملية للذكاء الاصطناعي. تابعني للاطلاع على المقالة التالية.