Chat Completions هي واجهة API القياسية للاستخدام مع أحدث نماذج OpenAI. يمكنك التعرف على كيفية البدء باستخدامها من خلال دليل المطورين لتوليد النصوص.
في 11 مارس 2025، أطلقنا المكونات الأساسية لمنصتنا الجديدة للوكلاء. للاطلاع على التفاصيل، راجع وثائق API الخاصة بـResponses API، والأدوات التي تشمل البحث على الويب والبحث في الملفات واستخدام الكمبيوتر، وكذلك حزمة تطوير الوكلاء (Agents SDK) مع ميزة التتبّع.
من المطالبات إلى الرسائل
لإجراء محادثة أكثر تفاعلية وحيوية مع نماذجنا، يمكنك استخدام رسائل بصيغة دردشة بدلًا من صيغة المطالبة القديمة المستخدمة مع Completions.
إليك كيفية عمل ذلك:
بدلًا من إرسال مطالبة واحدة كسلسلة نصية، ترسل قائمة من كائنات الرسائل كمدخلات.
لكل رسالة حقل role يحدد الدور، وعادةً ما تتضمن حقل content للمحتوى.
تشمل الأدوار الشائعة system وuser وassistant وdeveloper وtool. تُستخدم رسائل الأدوات لنتائج الأدوات أو الدوال، ويجب أن تقابل استدعاءات المساعد للأدوات. للحفاظ على التوافق مع الإصدارات السابقة، قد يظل الخادم يقبل رسائل الدوال ويحوّلها إلى رسائل أدوات أثناء المعالجة. قد تُحوَّل رسائل المطوّر إلى دور آخر حسب ما يدعمه النموذج.
يحتوي حقل content على نص الرسالة الصادرة عن الدور المحدد.
يمكن لتعليمة النظام أن تحدد التوجيهات العامة للمحادثة.
تُعالَج الرسائل حسب ترتيب ظهورها في القائمة، ويستجيب المساعد بناءً على ذلك.
حتى طلبات Completions البسيطة يمكن تنفيذها عبر Chat Completions، كما ترى أدناه:
| سابقًا | الآن |
|---|---|
'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.