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

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

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

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

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

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

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

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

إليك طريقة عمل ذلك:

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

  • تحتوي كل رسالة على role وcontent.

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

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

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

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

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

| سابقًا | الآن | | 'prompt' : 'أخبرني نكتة' | 'messages': <br>[{'role':'user', 'content':'أخبرني نكتة'}] |

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

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

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

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

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

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

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

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

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