قبل البدء
يجب أن يوفر النشر:- عنوان URL أساسي عام عبر HTTPS؛
- نقطة نهاية
/chat/completionsمتوافقة مع OpenAI؛ - مصادقة برمز Bearer؛ و
- معرّف نموذج أو نشر لدى المزود تقبله تلك النقطة.
/responses اختياري. أبقه معطّلًا ما لم ينفّذ النشر هذه النقطة صراحةً.
ربط عملية نشر
1
فتح النماذج الخاصة
افتح لوحة التحكم ← الإعدادات ← مساحة العمل ← النماذج الخاصة، ثم اختر إضافة نموذج. يجب أن تكون مالك مساحة العمل أو مسؤولًا فيها.
2
تسمية النموذج
اختر نموذجًا موجودًا في الكتالوج لإضافة هذا النشر إلى قائمة مزوديه، أو أدخل اسمًا مختصرًا مثل لا يمكنك اختيار نطاق أسماء مساحة العمل أو استبداله. ترتبط معرّفات الكتالوج الدقيقة بذلك النموذج دون تغيير هويته العامة.
legal-assistant. إذا لم يوجد نموذج بهذا الاسم الفريد في الكتالوج، يجمعه Phaseo مع نطاق الأسماء الموثوق لمساحة العمل:3
تهيئة نقطة النهاية
أدخل عنوان URL الأساسي دون مسار الاستدلال. مثلًا:لا تضمّن
/chat/completions أو /responses. أدخل معرّف النموذج أو النشر الدقيق لدى المزود بشكل منفصل؛ ويستبدله Phaseo عند تمرير الطلبات.4
حفظ بيانات الاعتماد
أدخل مفتاح API الخاص بالنشر. يشفّر Phaseo بيانات الاعتماد ولا يعرضها مجددًا بعد الحفظ. يمكنك استبدالها لاحقًا من صفحة إعدادات النموذج.
5
استدعاء النموذج
استخدم معرّف النموذج الذي تم إنشاؤه مع نقطة نهاية Chat Completions المعتادة:يجب أن ينتمي مفتاح API المستخدم للاستدعاء إلى مساحة العمل نفسها التي ينتمي إليها النموذج الخاص.
cURL
كيفية عمل التوجيه
تستخدم النماذج الخاصة واجهة طلبات Phaseo نفسها التي تستخدمها نماذج الكتالوج. يُوجّه النموذج المستقل لمساحة العمل إلى نقطة نهايته المهيأة فقط. تنضم النقطة المرتبطة بنموذج كتالوج إلى قائمة مزوديه وفق سياسة مفضّل أو المجموعة العادية أو احتياطي فقط. يرسل Phaseo بيانات الاعتماد المحفوظة كرمز Bearer ويستبدل معرّف النموذج المهيأ لدى المزود. لا يصبح النموذج الخاص مسار مزود عامًا ولا يظهر لمساحات العمل الأخرى. تُدرج النماذج الخاصة المفعّلة في كتالوج النماذج المصادق عليه وتظهر تحت مرشح خاص.بعد إضافة نشر خاص أو تفعيله على نموذج كتالوج موجود، انتظر 5–10 ثوانٍ لانتشار التغيير عبر طبقة API قبل اختبار التوجيه. خلال هذه الفترة قد تستمر الطلبات باستخدام المزودين العامين الحاليين للنموذج. لا تُعاد توجيه الطلبات الجارية بالفعل.
أمثلة المزودين
قد تتغير منتجات المزودين وصيغ عناوين URL. تحقّق من عنوان URL الأساسي ومعرّف النموذج وطريقة المصادقة والنقاط المدعومة في وثائق النشر الحالية لدى المزود.
إدارة النماذج الخاصة عبر API
يمكن للإدارة من جهة الخادم استخدام واجهة النماذج الخاصة بمفتاح إدارة يحملprivate_models:read أو private_models:write أو private_models:delete حسب الحاجة.
تقبل طلبات الإنشاء والتحديث model_reference كمعرّف نموذج كتالوج دقيق أو اسم مختصر. يستنتج Phaseo قيمة model_id ولا يمكن للعملاء إرسالها مباشرةً. استخدم host_provider_id لمزود موجود في Phaseo، أو custom_provider_name وcustom_provider_url الاختياري لمشغّل آخر.
استكشاف الأخطاء وإصلاحها
- خطأ 404 من المزود: تأكد من أن عنوان URL الأساسي ينتهي قبل مسار الاستدلال.
- نموذج غير معروف: انسخ معرّف نشر المزود إلى معرّف النموذج لدى المزود. لا تستخدم معرّف نموذج مساحة عمل Phaseo هناك.
- طلب غير مصرح به لدى المزود: استبدل بيانات الاعتماد المحفوظة وتأكد من قبول المزود لمصادقة Bearer.
- Chat يعمل لكن Responses يفشل: عطّل Responses API ما لم ينفّذ المزود
/responsesبشكل أصلي. - النموذج غير ظاهر في الكتالوج: تأكد من تفعيل النموذج ومصادقة المستدعي في مساحة العمل نفسها.