بقلم: يوسف | محرر أدوات الذكاء الاصطناعي · صوت تحريري بإشراف بشري
أصدر فريق LangChain الإصدار langchain-core 1.5.4 في الحادي عشر من أغسطس 2025، حاملاً 11 إصلاحاً تطال مناطق حساسة في البنية التحتية للمكتبة — من توافق Pydantic إلى إدارة حلقات الأحداث في تتبع البث، مروراً بسلوك الأدوات والحجج المُحقنة.
إن كنت تبني وكلاء أو pipelines معقدة فوق LangChain، فهذا الإصدار يستحق الانتباه — ليس لأنه يُضيف ميزات، بل لأنه يُوقف أخطاء صامتة كانت تُغيّر سلوك كودك دون أن تُخطرك.
- توافق Pydantic 2.14 — (#39328) معالجة تغييرات في واجهة Pydantic الأحدث التي كانت تُسبب أعطالاً في التحقق من المدخلات.
- منع StructuredPrompt من تعديل kwargs المُرسِل — (#39174) كان الـ StructuredPrompt يُحوِّر معاملات الاستدعاء الأصلية، مما يُنتج سلوكاً غير متوقع عند إعادة استخدام نفس الـ kwargs في أماكن متعددة.
- الحفاظ على مخطط حجج الأدوات المسطّحة لـ RootModel Runnables — (#39307) كان الـ schema يُفقد بنيته الصحيحة عند تمريره عبر RootModel، مما يؤثر على توليد الأدوات تلقائياً.
- إغلاق حلقات الأحداث المُنشأة داخلياً في Streaming Tracers — (#39222) ثغرة كانت تتسبب في تسرب الموارد عند استخدام tracers البث في بيئات async.
- الحفاظ على كتل ملفات OpenAI — (#39205) كانت كتل الملفات المُرسَلة لـ OpenAI تُحذف أو تُهمَل أثناء معالجة الرسائل.
- توثيق أسماء الحجج المحجوزة للأدوات — (#39207) إضافة توثيق واضح للأسماء التي لا يجب استخدامها في تعريف الأدوات لتجنب التعارضات الداخلية.
- معالجة الحجج المُحقنة لصفوف تَرِث من BaseTool — (#39202) الصفوف الفرعية لم تكن تستقبل injected args بشكل صحيح، مما يُخفق في سيناريوهات الإدخال الديناميكي.
- احترام include_injected=False مع filter_args — (#39200) كانت الحجج المُحقنة تظهر في المخرجات حتى بعد الطلب الصريح بإخفائها.
- تعتيم خيارات callback البث — (#39179) بيانات حساسة كانت تُسرَّب عبر streaming callbacks دون تشفير أو إخفاء.
- تحسين كتابة text stream projections — (#39170) معالجة أخطاء في استنتاج نوع البيانات أثناء تدفق النصوص.
- إضافة ملفات LICENSE المفقودة — (#39146) ترقية بنية الحزم المنشورة بإضافة ملفات الترخيص الغائبة.
اللافت في هذا الإصدار أن معظم الإصلاحات تعالج حالات حافّة لم تكن ترفع استثناءات واضحة — بل كانت تُغيّر السلوك بصمت. إصلاح StructuredPrompt مثلاً يمسّ كل من يُعيد استخدام kwargs عبر استدعاءات متعددة، وإصلاح filter_args يهم من يبني أدوات تحتوي على بيانات خاصة لا ينبغي تصديرها. المطورون الذين يعملون على بيئات إنتاجية مع streaming tracers سيجدون إصلاح تسرب حلقات الأحداث ذا أثر مباشر على استقرار التطبيق.
التحديث متاح الآن عبر pip install langchain-core==1.5.4، والفارق الكامل عن الإصدار السابق 1.5.3 موثّق في صفحة الإصدار الرسمية على GitHub.
