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

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

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

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

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

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

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

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

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

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

  • تتضمن كل رسالة role وعادةً content.

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

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

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

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

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

| سابقًا | الآن | | 'prompt' : 'tell me a joke' | 'messages': <br>[{'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.

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