acme/legal-assistant. لا يستطيع رؤيتها أو استدعاءها سوى مساحة عملك، وتعمل في أي مكان يعمل فيه معرّف نموذج عام.
النماذج الخاصة في المرحلة التجريبية. يضيفها مالكو مساحة العمل ومسؤولوها ويديرونها.
قبل أن تبدأ
يجب أن توفّر عملية النشر:- عنوان URL أساسيًا عامًا عبر HTTPS؛
- نقطة نهاية
/chat/completionsمتوافقة مع OpenAI؛ - مصادقة برمز Bearer؛
- معرّف نموذج أو عملية نشر لدى المزوّد تقبله نقطة النهاية تلك.
/responses اختياري. أبقِه معطّلًا ما لم تنفّذ عملية النشر نقطة النهاية هذه صراحةً.
اربط عملية نشر
1
افتح النماذج الخاصة
افتح لوحة التحكم ← الإعدادات ← مساحة العمل ← النماذج الخاصة، ثم اختر إضافة نموذج. يجب أن تكون مالكًا لمساحة العمل أو مسؤولًا فيها. للأتمتة، استدعِ
POST /v1/private-models بالحقول نفسها ومفتاح إدارة.2
سمِّ النموذج
اختر نموذجًا موجودًا في الكتالوج لإضافة عملية النشر هذه إلى قائمة مزوّديه، أو أدخل معرّفًا نصيًا قصيرًا للنموذج مثل لا يمكنك اختيار نطاق أسماء مساحة العمل أو استبداله. تُرفق معرّفات الكتالوج المطابقة تمامًا بذلك النموذج دون تغيير هويته العامة.
legal-assistant. إذا لم يكن لأي نموذج في الكتالوج هذا المعرّف النصي الفريد، يدمجه Phaseo مع نطاق الأسماء الموثوق لمساحة العمل:3
اضبط نقطة النهاية
أدخل عنوان URL الأساسي الذي يسبق مسار الاستدلال. على سبيل المثال، استخدم:لا تُدرج
/chat/completions أو /responses. أدخل معرّف النموذج أو عملية النشر لدى المزوّد بدقة في حقل منفصل، ويستبدله Phaseo عند تمرير الطلبات.4
خزّن بيانات الاعتماد
أدخل مفتاح API لعملية النشر. يشفّر Phaseo بيانات الاعتماد ولا يعيدها أبدًا بعد الحفظ. يمكنك استبدالها لاحقًا من صفحة إعدادات النموذج.
5
استدعِ النموذج
استخدم معرّف النموذج المولَّد مع نقطة نهاية Chat Completions المعتادة:يجب أن ينتمي مفتاح API المستدعي إلى مساحة العمل نفسها التي ينتمي إليها النموذج الخاص.
cURL
كيف يعمل التوجيه
يُوجَّه نموذج مساحة العمل المستقل إلى نقطة النهاية المضبوطة له فقط. أما نقطة النهاية المرفقة بنموذج في الكتالوج فتنضم إلى قائمة مزوّدي ذلك النموذج وفق سياسة التوجيه الخاصة بها:
يرسل Phaseo بيانات الاعتماد المخزّنة كرمز Bearer ويستبدل معرّف النموذج لدى المزوّد المضبوط.
لا يصبح النموذج الخاص أبدًا مسار مزوّد عامًا، ولا يظهر لمساحات العمل الأخرى. تُضمَّن النماذج الخاصة المفعّلة في كتالوج النماذج للمستخدم الموثَّق وتظهر تحت عامل التصفية خاص.
بعد إضافة عملية نشر خاصة أو تغييرها أو تفعيلها، انتظر حتى دقيقة واحدة قبل اختبار توجيهها. حتى ذلك الحين، قد تظل بعض الطلبات تستخدم الإعدادات السابقة، مثل المزوّدين العامين للنموذج. لا يُعاد توجيه الطلبات الجارية بالفعل.
أمثلة على المزوّدين
قد تتغير منتجات المزوّدين وصيغ عناوين URL. تحقّق من عنوان URL الأساسي ومعرّف النموذج وطريقة المصادقة ونقاط النهاية المدعومة في وثائق النشر الحالية لدى المزوّد.
أدِر النماذج الخاصة عبر API
يمكن للإدارة من جهة الخادم استخدام Private Models 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أصليًا. - النموذج غير موجود في الكتالوج: تأكد من أن النموذج مفعّل وأن المستدعي موثَّق في مساحة العمل نفسها.