بقلم: ليلى | محررة أدوات المطورين · صوت تحريري بإشراف بشري
أصدرت Anthropic الإصدار v0.122.0 من مكتبة Python الرسمية لـ Claude API، وهو إصدار يُمثّل تراكماً غير مسبوق من إصلاحات الأخطاء التي كانت تُزعج المطوّرين في سيناريوهات Streaming وتكامل AWS Bedrock وGoogle Vertex.
الميزة الوحيدة الجديدة في هذا الإصدار هي إضافة معامل output_behavior عند إنشاء Dream، ويمنح هذا المعامل المطوّر خيارَين: إما إنشاء مخزن ذاكرة جديد تماماً، أو تحديث المخزن الحالي في مكانه مباشرةً. ميزة بسيطة في ظاهرها، لكنها تمنح تحكماً دقيقاً في كيفية إدارة الحالة عبر جلسات النموذج.
الجانب الأوسع هو حزمة الإصلاحات التي تطال قلب عمل المكتبة. على صعيد Streaming، كان المطوّرون يعانون من ست مشكلات متراكمة دُفعةً واحدة:
- إضافة سياق توضيحي لأخطاء JSON التالفة في مدخلات الأدوات ضمن الـ accumulator غير البيتا، مما يُسهّل تشخيص الأعطال بدلاً من الغموض السابق.
- تطبيق جميع حقول
message_deltaعند تجميع الرسائل المتدفقة، وكان الإصدار السابق يُسقط بعض هذه الحقول بصمت. - إطلاق أحداث
input_jsonلكتل استخدام أدوات الخادم، وهي حالة حافة كانت تُسبّب تصرفاً غير متوقع عند الاعتماد على server tool use. - الإبقاء على الحقول المحذوفة من كتل المحتوى بوصفها غير مُعيَّنة في الرسائل المُجمَّعة، بدلاً من تعيينها بقيم افتراضية خاطئة.
- تشغيل تحويل الطلب مرةً واحدة فقط داخل
messages.stream()بدلاً من تكراره، وهو خطأ كان يُكلّف أداءً ووقتاً. - إسكات تحذيرات Pydantic serializer عند أحداث
message_stop، وهي ضوضاء غير ضرورية كانت تملأ سجلات التطبيقات.
أما تكامل AWS Bedrock، فقد حصل هو الآخر على إصلاحات جوهرية. كان توقيع SigV4 يُنفَّذ داخل event loop في العملاء غير المتزامنين، مما قد يُسبّب اختناقات أداء أو سلوكاً غير محدد. الإصلاح ينقل هذا التوقيع خارج event loop بالكامل. علاوةً على ذلك، أصبح بإمكان مستخدمي Bedrock الوصول إلى beta.messages.parse وstream وtool_runner التي كانت مخفية سابقاً، وهو ما يُساوي حالة Vertex AI التي حصلت بدورها على beta.messages.parse وtool_runner.
على مستوى العميل نفسه، ثلاثة إصلاحات تستحق الانتباه: أولاً، أصبح تبادل التوكن مُرتبطاً بكل عميل حتى عند استخدام copy()، وهو خطأ كان يُسبّب تسرب سياق المصادقة. ثانياً، أصبح قراءة محتوى PathLike المُمرَّر داخل tuple الملف تعمل صحيحاً. ثالثاً، مفاتيح API الفارغة — سواء ANTHROPIC_API_KEY أو ANTHROPIC_AUTH_TOKEN — تُعامَل الآن كأنها غير موجودة بدلاً من قبولها بصمت.
إصلاح أمني واحد يُستحق التأشير عليه: رفض حلقات symlink في مسارات الأدوات، وتخطي الأعضاء الخاصة في أرشيفات skill-archive، وهو ما يسدّ ثغرة محتملة عند تحميل أدوات من مصادر خارجية.
التحديث متاح الآن عبر pip install --upgrade anthropic. إذا كنت تعمل مع Bedrock أو Vertex أو تعتمد على Streaming بشكل مكثف في تطبيقاتك مع وكلاء Claude، فهذا الإصدار يستحق الترقية الفورية.
