OpenAI
هذه الصفحة مترجمة باستخدام الترجمة الآلية. تفضل بالاطّلاع على المقال الأصلي بالإنجليزية.

الانتقال من Completions إلى Chat Completions في واجهة OpenAI API

كيفية الانتقال من واجهة OpenAI Completions API القديمة إلى Chat Completions

تم التحديث: 28 days ago

تُعد Chat Completions واجهة برمجة التطبيقات القياسية للاستخدام مع أحدث نماذج OpenAI. يمكنك معرفة كيفية بدء استخدامها عبر دليل المطور لتوليد النصوص.

اعتبارًا من 11 مارس 2025، أصدرنا اللبنات الأساسية لمنصتنا الجديدة للوكلاء. للاطلاع على التفاصيل، راجع وثائق API الخاصة بنا لـ واجهة Responses API، والأدوات التي تشمل البحث على الويب، والبحث في الملفات، واستخدام الحاسوب، وحزمة Agents SDK الخاصة بنا مع التتبع.

من المطالبات إلى الرسائل

لإجراء محادثة أكثر تفاعلية وديناميكية مع نماذجنا، يمكنك استخدام الرسائل بتنسيق الدردشة بدلًا من أسلوب المطالبة القديم المستخدم مع الإكمالات.

إليك آلية عمل ذلك:

  • بدلًا من إرسال مطالبة نصية واحدة، ترسل قائمة من كائنات الرسائل كمدخلات.

  • لكل رسالة دور، وعادةً ما يكون لها محتوى.

  • تشمل الأدوار الشائعة system وuser وassistant وdeveloper وtool. تُستخدم رسائل الأدوات لنتائج الأدوات أو الدوال، ويجب أن تقابل استدعاءات الأدوات الصادرة عن المساعد. للتوافق مع الإصدارات السابقة، قد تظل رسائل الدوال مقبولة وتُحوَّل إلى رسائل أدوات أثناء معالجتها على الخادم. قد يُعاد تعيين رسائل المطور وفقًا لمدى دعم النموذج لها.

  • يتضمن المحتوى نص الرسالة الواردة من صاحب الدور.

  • يمكن لتعليمة النظام أن تقدم توجيهات عامة للمحادثة

  • تُعالَج الرسائل حسب ترتيب ظهورها في القائمة، ويستجيب المساعد بناءً على ذلك.

يمكن تنفيذ حتى طلبات الإكمالات الأساسية من خلال إكمالات الدردشة، كما ترى أدناه:

سابقًاالآن
'prompt' : 'tell me a joke''messages': [{'role':'user', 'content':'tell me a joke'}]

أصبح الآن إجراء حوار متبادل مع النموذج أسهل من أي وقت مضى، وذلك بإضافة المزيد من الرسائل إلى قائمة رسائل المحادثة.

'messages': [{'role':'user', 'content':'أخبرني نكتة'}, 
{'role':'assistant', 'content':'لماذا عبرت الدجاجة الطريق'}, 
{'role':'user', 'content':'لا أعرف، لماذا عبرت الدجاجة الطريق'}]

تعليمات النظام

يمكنك أيضًا استخدام تعليمة على مستوى النظام لتوجيه سلوك النموذج طوال المحادثة. على سبيل المثال، استخدام تعليمة نظام ورسالة كهذه

'messages': [{'role':'system', 'content':'أنت مساعد يتحدث بأسلوب شكسبير.'}, 
{'role':'user', 'content':'أخبرني نكتة'},

سينتج عن ذلك شيء مثل

{...
'message': {'role':'assistant',
              'content':'لماذا عبرت الدجاجة الطريق؟ لتصل إلى الجانب الآخر، ولكن حقًا، كان الجانب الآخر مليئًا بالمخاطر والأخطار، فعادت مسرعة من حيث أتت، وحقًا أقول!'}
...}

إذا أردت استكشاف خيارات لا تتطلب منك إدارة سجل محادثة الرسائل بنفسك، فراجع واجهة Assistants API.

هل كانت هذه المقالة مفيدة؟