بقلم: ليلى | محررة أدوات المطورين · صوت تحريري بإشراف بشري
طرحت OpenAI الإصدار 2.34.0 من مكتبة Python الرسمية مع تركيز واضح على معمارية Admin API الجديدة والتعامل مع تعقيدات المصادقة متعددة المستويات. التحديث يحمل 6 ميزات جديدة و11 إصلاحاً مباشراً لمشاكل كانت تعطل سير العمل في البيئات المؤسسية.
- Admin API Keys دعم شامل لكل endpoint – نظام مفاتيح إدارية منفصل يسمح بالتحكم الدقيق في الصلاحيات حسب نقطة الاتصال، بدلاً من المفاتيح العامة التقليدية
- external_key_id للمشاريع – إضافة معرف خارجي للمشاريع يسهل الربط مع أنظمة إدارة المشاريع الخارجية وقواعد البيانات المؤسسية
- email و metadata للمستخدمين – توسيع نموذج بيانات المستخدمين ليشمل البريد الإلكتروني والبيانات الوصفية المخصصة
- تكوين Headers عبر البيئة – إمكانية تعيين HTTP headers مباشرة من متغيرات النظام دون تعديل الكود المصدري
- إصلاح Azure explicit auth headers – معالجة مشكلة رفض منصة Azure لـ auth headers المحددة صراحة، والتي كانت تؤدي لفشل المصادقة
- تصحيح prompt_cache_retention enum – تغيير القيمة من “in-memory” إلى “in_memory” لتتوافق مع معايير API الجديدة
التحديث يركز بشكل خاص على حل مشاكل المصادقة المتراكمة التي واجهها المطورون في الأشهر الأخيرة. إصلاحات timestamp types تحل مشكلة عدم اتساق أنواع البيانات بين created_at و completed_at، بينما تحسينات multipart file structure تقلل استهلاك الذاكرة بشكل ملحوظ عند رفع الملفات الكبيرة.
الميزة الأبرز تكمن في دعم Admin API Keys المتدرج – فبدلاً من مفتاح واحد يتحكم في كل شيء، يمكن للفرق الآن إنشاء مفاتيح متخصصة لكل وظيفة. مطور يعمل على fine-tuning يحصل على مفاتيح محددة، بينما فريق التحليلات يحصل على مفاتيح مقيدة بـ embeddings فقط.
التحديث متاح فوراً عبر GitHub releases مع changelog مفصل لكل تغيير. الترقية مباشرة عبر pip upgrade، لكن احذر من تغييرات timestamp types إذا كان كودك يعتمد على النوع الصحيح للتوقيتات.
