بقلم: سارة | محررة نماذج الذكاء الاصطناعي · صوت تحريري بإشراف بشري
أصدرت OpenAI النسخة 3.0.0 من مكتبة openai-python الرسمية في 12 أغسطس 2026، وهي نسخة تحمل تغييراً جوهرياً واحداً لا هوادة فيه: استبدال HTTPX بـ HTTPX2 بوصفه عميل HTTP الافتراضي، مع وقف التثبيت التلقائي لـ HTTPX القديم نهائياً.
هذا ليس تحديثاً اعتيادياً لرقم الإصدار. أي تطبيق يعتمد على تخصيص عميل HTTPX، أو يستخدم طبقات نقل مخصصة (custom transports)، أو يمرر كائنات إعداد (configuration objects) مبنية على المكتبة القديمة، سيتوقف عن العمل فور الترقية ما لم تُعدَّل الشيفرة. المكتبة تحظى بأكثر من 31.3 ألف نجمة و5.1 ألف تشعب (وفقاً لـ GitHub)، ما يعني أن قاعدة المستخدمين المتأثرين واسعة النطاق.
فريق OpenAI أتاح مسارَين للمطورين الذين لا يستطيعون الترقية الفورية: إما اتباع دليل الهجرة إلى HTTPX2 الذي يُرشد خطوة بخطوة إلى توافق كل عنصر في الكود القديم مع المكتبة الجديدة، وإما استخدام “مخرج الطوارئ” المتاح مؤقتاً في وقت التشغيل (runtime-only legacy HTTPX escape hatch)، مع التنبيه الصريح بأن هذا الخيار مؤقت وليس بديلاً دائماً.
الانتقال إلى HTTPX2 ليس مجرد قرار تقني داخلي؛ فـ HTTPX2 يُمثّل الجيل الثاني من المكتبة التي أعادت تعريف طريقة معالجة HTTP في بايثون، مع دعم أفضل لـ HTTP/2 وأداء أعلى في الاتصالات المتزامنة. الاعتماد عليه افتراضياً يضع openai-python في موضع أكثر استدامة على المدى البعيد، لكنه يُلقي على عاتق كل من يستخدم المكتبة في بيئة إنتاجية معقدة مسؤولية اختبار التوافق قبل النشر.
إن كنت تستخدم المكتبة باستدعاءات بسيطة دون تخصيص عميل HTTP، فالترقية ستمر دون أثر يُذكر. لكن إن كانت بنيتك التحتية تعتمد على interceptors أو proxies أو retry policies مبنية على HTTPX، فالتحقق من طلب السحب رقم 3594 وقراءة دليل الهجرة ليسا خياراً — هما شرط للبقاء في الخدمة.
