OpenAI

الوصول إلى نماذج GPT عبر OpenAI Chat Completions API مع استدعاء الدوال الأصلي، ودعم الرؤية، ودعم نماذج الاستدلال.

المتطلبات المسبقة

• مفتاح OpenAI API من platform.openai.com

إعداد سريع

1. الحصول على مفتاح API

1. سجّل في platform.openai.com
2. انتقل إلى API Keys في الشريط الجانبي الأيسر
3. انقر Create new secret key وانسخه (يبدأ بـ sk-)

2. الإعداد

[default]
provider = "openai"
model = "gpt-4o"

[providers.openai]
api_key = "${OPENAI_API_KEY}"

أو اضبط متغير البيئة:

export OPENAI_API_KEY="sk-..."

3. التحقق

prx doctor models

النماذج المتاحة

النموذج	السياق	الرؤية	استخدام الأدوات	ملاحظات
gpt-4o	128K	نعم	نعم	أفضل نموذج للأغراض العامة
gpt-4o-mini	128K	نعم	نعم	أصغر وأسرع وأرخص
gpt-4-turbo	128K	نعم	نعم	النموذج الرائد من الجيل السابق
o3	128K	نعم	نعم	نموذج استدلال
o4-mini	128K	نعم	نعم	نموذج استدلال أصغر
gpt-4	8K	لا	نعم	GPT-4 الأصلي

مرجع الإعدادات

الحقل	النوع	الافتراضي	الوصف
api_key	string	مطلوب	مفتاح OpenAI API ‏(sk-...)
api_url	string	https://api.openai.com/v1	عنوان API أساسي مخصص
model	string	gpt-4o	النموذج الافتراضي للاستخدام

الميزات

الاستدعاء الأصلي للدوال

يرسل PRX الأدوات بصيغة function الأصلية في OpenAI. تتضمن تعريفات الأدوات name وdescription وparameters (JSON Schema). يدعم المزود tool_choice: "auto" للاختيار التلقائي للأدوات.

الرؤية

يمكن للنماذج الداعمة للرؤية (GPT-4o وGPT-4o-mini) تحليل الصور المدرجة في المحادثة. تُرسل الصور inline عبر صيغة الرسائل القياسية.

دعم نماذج الاستدلال

بالنسبة لنماذج الاستدلال (o1 وo3 وo4-mini)، يتعامل PRX تلقائيًا مع الرجوع إلى reasoning_content. عندما يعيد النموذج المخرجات في reasoning_content بدلًا من content، يستخرج PRX نص الاستدلال بشكل شفاف.

المحادثات متعددة الأدوار

يُحفَظ كامل سجل المحادثة ويُرسل إلى API، بما في ذلك مطالبات النظام، ورسائل المستخدم، وردود المساعد، وأزواج استدعاء/نتائج الأدوات بصيغة OpenAI المهيكلة الأصلية.

عنوان أساسي مخصص

لاستخدام وكيل أو Azure OpenAI أو أي نقطة نهاية متوافقة مع OpenAI:

[providers.openai]
api_key = "${OPENAI_API_KEY}"
api_url = "https://my-proxy.example.com/v1"

تدفئة الاتصال

عند بدء التشغيل، يرسل PRX طلب GET /models خفيفًا لإنشاء تجمعات اتصال TLS وHTTP/2، ما يقلل زمن الاستجابة لأول طلب فعلي.

استكشاف الأخطاء وإصلاحها

"OpenAI API key not set"

اضبط متغير البيئة OPENAI_API_KEY أو أضف api_key إلى [providers.openai] في config.toml.

429 Rate Limit

تفرض OpenAI حدودًا للدقائق على عدد الرموز والطلبات. الحلول:

• انتظر وأعد المحاولة (PRX يعالج هذا تلقائيًا باستخدام غلاف المزوّد الموثوق)
• رقِّ خطة OpenAI الخاصة بك لحدود أعلى
• استخدم fallback_providers للرجوع إلى مزوّد آخر أثناء تحديد المعدل

استجابة فارغة من نماذج الاستدلال

إذا كنت تستخدم o1/o3/o4-mini وتحصل على استجابات فارغة، فهذا سلوك متوقع عندما يكون خرج النموذج بالكامل في reasoning_content. يرجع PRX تلقائيًا إلى reasoning_content عندما يكون content فارغًا.