Skill · Claude Blog - Message Batches API
عالج 10 آلاف مهمة بنصف التكلفة باستخدام واجهة Claude Batch API
الصورة: Antonio Vivace على Unsplash
توقف عن دفع السعر الكامل لأعباء عمل الذكاء الاصطناعي غير العاجلة. تعالج واجهة Batch API من Claude ما يصل إلى 100,000 طلب بشكل غير متزامن بنصف التكلفة المعتادة، وتكتمل خلال 24 ساعة. مثالية لتصنيف المستندات وإثراء البيانات بالجملة والتحليل الواسع النطاق ضمن ميزانية يمكن التنبؤ بها.
صُمّمت واجهة Claude Message Batches API لأعباء العمل الاحترافية التي لا تتطلب استجابات فورية، مثل تصنيف المستندات أو تحليل المحتوى أو استخراج البيانات أو تجميع الأبحاث بالجملة. فبدلاً من إرسال طلبات فردية بسعر الواجهة القياسي، تجمع ما يصل إلى 100,000 استعلام في تقديم دفعة واحدة، ويعالجها Claude بشكل غير متزامن بتكلفة تبلغ 50% بالضبط من تكلفة الرمز الواحد.
إليك كيفية تنفيذ ذلك: استخدم Anthropic Python SDK لإنشاء دفعة تتضمن قائمة من طلبات الرسائل، كل منها موسوم بمعرّف مخصص custom_id. ويتبع كل طلب التنسيق القياسي لواجهة Messages API، أي الطراز وmax_tokens وموجّه النظام والرسائل. وبمجرد التقديم عبر client.beta.messages.batches.create()، تُسنِد الواجهة معرّف دفعة وتبدأ المعالجة. وتكون النتائج متاحة عادةً خلال ساعة (وإن كانت المنصة تضمن الاكتمال خلال 24 ساعة)، ويمكنك تتبّع الحالة عبر client.beta.messages.batches.retrieve(batch_id). وتبقى النتائج محفوظة لمدة 29 يوماً.
مثال عملي: يحتاج فريق الامتثال إلى تصنيف 5,000 عقد مورّد حسب فئة المخاطر. وستكلّف استدعاءات الواجهة القياسية 500 دولار؛ أما الدفعة نفسها فتكلف 250 دولاراً. جهّز الطلبات بتعليمات مثل «صنّف هذا العقد على أنه عالي أو متوسط أو منخفض المخاطر بناءً على شروط الدفع وبنود المسؤولية وشروط الإنهاء»، وأرفق كل عقد بمعرّف custom_id، وقدّم الدفعة، واسترجع النتائج خلال الليل. لا انتظار فوري ولا استهلاك مفرط للرموز.
القيد الأساسي: البث والوضع السريع غير مدعومين في الدفعات، لذا يناسب هذا النهج أفضل المهام التي لديك فيها بالفعل مجموعة من المدخلات ويمكنك تحمّل المعالجة غير المتزامنة. واجمع بين معالجة الدفعات والتخزين المؤقت لموجّهات Claude لتحقيق وفورات أعمق على السياق المتكرر؛ إذ تفيد المؤسسات بأن الجمع بين التقنيتين يحقق خفضاً في التكلفة بنسبة 75% في العمليات الواسعة النطاق.
المصادر والاعتمادات
المصدر الأصلي: Claude Blog - Message Batches API