واجهة برمجة تطبيقات OpenAI التي نسخها الجميع ليست هي التي يوصون بها
تستخدم معظم أدوات النماذج المحلية مثل Ollama وvLLM وLM Studio شارة "متوافق مع OpenAI".
ولكن هناك مشكلة. يعتقد معظم الناس أن هذا يعني شيئاً واحداً محدداً. في الواقع، هناك تنسيقان مختلفان؛ أحدهما هو المعيار الصناعي، والآخر هو ما تريد OpenAI منك استخدامه بالفعل.
إليك التفاصيل.
المعيار القديم: Chat Completions API
هذا هو التنسيق الذي نسخه الجميع. وهو يستخدم قائمة من الرسائل بأدوار مثل developer وuser وassistant.
لديه مشكلتان رئيسيتان:
- أنه عديم الحالة (stateless). يجب عليك إعادة إرسال سجل المحادثة بالكامل في كل مرة.
- أنه ثقيل. بالنسبة للوكلاء (agents) المعقدين، يصبح إرسال نصوص المحادثات الضخمة بطيئاً ومكلفاً.
المعيار الجديد: Responses API
قدمت OpenAI هذا المعيار في مارس 2025. وهو مصمم للوكلاء (agents)، وليس فقط لبرامج الدردشة الآلية البسيطة.
لماذا هو أفضل:
- أنه ذو حالة (stateful). يتذكر الخادم المحادثة، لذا لا تحتاج إلى إعادة إرسال كل شيء.
- يتعامل مع الاستنتاج بشكل أفضل، حيث يحتفظ بـ "سلسلة الأفكار" (chain of thought) الخاصة بالنموذج على الخادم.
- يستخدم بنية أكثر وضوحاً، حيث يفصل التعليمات عن مدخلات المستخدم الفعلية.
الارتباك
عندما تقول أداة ما إنها "متوافقة مع OpenAI"، فإن ذلك يعني في الغالب أنها تدعم تنسيق Chat Completions القديم.
لقد بنى القطاع التقني نظاماً بيئياً ضخماً حول هذا التنسيق القديم. ولأنه كان موجوداً في كل مكان، أصبح هو الخيار الافتراضي. وقد خلق هذا مخاطرة تتمثل في قيام الجميع ببناء نسخ مقلدة من واجهة برمجة تطبيقات خاصة بشركة واحدة.
الحل: Open Responses
لإصلاح ذلك، أطلقت OpenAI وشركاء مثل Hugging Face وVercel مواصفات Open Responses.
بدلاً من التخمين حول كيفية عمل واجهة برمجة التطبيقات، أصبح لدى المطورين الآن معيار موثق وقابل للاختبار. يتيح لك ذلك التبديل بين OpenAI والنماذج المحلية بأقل قدر من التغييرات في الكود.
ما يجب عليك فعله:
- إذا كنت تبني مشروعاً جديداً، فاستخدم Responses API.
- إذا كنت تقوم بصيانة تطبيقات قديمة، فسيظل Chat Completions مدعوماً لفترة طويلة.
- تحقق دائماً مما إذا كانت أداتك تدعم التنسيق الجديد ذو الحالة (stateful) لتوفير التكاليف وتقليل زمن الاستجابة (latency).
معرفة الفرق تمنع الأخطاء في حساب الرموز (tokens) وهياكل الرسائل.
المصدر: https://dev.to/rlnorthcutt/the-openai-api-everyone-copied-isnt-the-one-openai-recommends-28o8
مجتمع تعليمي اختياري: https://t.me/GyaanSetuAi