يقوم PandaNpc بتخزين اتصالات المزود وإدخالات النموذج التي تقوم بتهيئتها. ابدأ بمفتاح API وعنوان URL الأساسي والبروتوكول ومعرف النموذج المقدم من خدمتك. إضافة إدخال لا يؤدي إلى إنشاء حساب upstream أو منح وصول إلى النموذج.
للتمييز بين المزود والنموذج، اقرأ إدارة قائمة النماذج المخصصة.
قبل البدء
قم بتأكيد ما يلي مع مزودك أو خدمتك المستضافة ذاتيًا:
- عنوان API الأساسي، وليس عنوان موقع المزود الإلكتروني.
- طريقة المصادقة وأي بيانات اعتماد مطلوبة.
- بروتوكول API المدعوم من الميزة أو المحرك الذي تنوي استخدامه.
- معرف النموذج الدقيق الذي يمكن لحسابك استدعاءه.
- حدود السياق والإخراج إذا كنت تخطط لإدخالها يدويًا.
احتفظ ببيانات الاعتماد في نموذج المزود، وليس في المطالبات أو لقطات الشاشة أو الملاحظات المشتركة. الخدمة المعلن عنها كمتوافقة مع OpenAI قد تظل تختلف في البث أو استدعاءات الأدوات أو دعم الصور.
1. إضافة أو تكوين مزود
افتح تكوين النموذج. أضف مزودًا، أو قم بتكوين إعداد مسبق موجود، أو انسخ إعدادًا مسبقًا عندما تحتاج إلى اتصال قابل للتحرير بشكل مستقل.
| الحقل | ما يجب إدخاله |
|---|---|
| اسم العرض | اسم يمكن التعرف عليه لهذا الاتصال |
| معرف المزود | معرف لتكوين المزود |
| مفتاح API | بيانات الاعتماد المطلوبة من خدمتك |
| عنوان URL الأساسي | عنوان API الأساسي المتوقع من التكامل المختار |
| البروتوكول | التنسيق الذي ينفذه API العلوي بالفعل |
| السر، المؤسسة، المشروع | القيم المطلوبة صراحةً من خدمتك فقط |
| دعم مصفوفة المحتوى | ما إذا كانت الخدمة تقبل محتوى الرسائل المنظم |
يعتمد شكل عنوان URL الأساسي على البروتوكول والميزة التي ترسل الطلبات. لا تقم بإلحاق مسار تشغيل كامل إذا كان التكامل يلحقه بالفعل. على سبيل المثال، التكامل الذي يضيف /chat/completions يحتاج إلى العنوان الأساسي المقابل، وليس عنوانًا ينتهي بالفعل بهذا المسار. لا تطبق هذا المثال على كل بروتوكول.
عند تحرير بيانات الاعتماد المخزنة، يضمن ترك مفتاح API أو السر فارغًا الحفاظ على القيمة المكونة. القيمة المقنعة المعروضة في القائمة ليست المفتاح الأصلي ولا يجب لصقها كبديل.
2. إضافة النموذج
احفظ المزود، وحدده، واختر إضافة نموذج.
| الحقل | المعنى |
|---|---|
| اسم العرض | التسمية الخاصة بك في قائمة النماذج |
| قيمة النموذج | معرف النموذج العلوي الدقيق |
| نوع النموذج | الفئة المناسبة في نموذج التكوين |
| المزود | الاتصال الذي يستخدمه هذا الإدخال |
| نافذة السياق | سعة السياق الموثقة، عند تحديدها |
| الحد الأقصى للرموز | حد الإخراج، عند تحديده |
استخدم معرفًا من وثائق الخدمة أو قائمة النماذج. الاسم التسويقي ليس بالضرورة معرّف API. اترك الحدود الاختيارية غير محددة إذا لم تستطع التحقق منها؛ عدم التعيين لا يعني أنه تم اكتشاف الحدود الحقيقية. قد تطبق الميزة المستهلكة قيمها الافتراضية الخاصة.
3. التحقق من التكوين
في الميزة أو المحرك الذي يستخدم هذه الإعدادات:
- حدد الإدخال الجديد وابدأ محادثة اختبار.
- أرسل طلبًا قصيرًا مثل
رد بـ: متصل. - أكد استجابة عادية، وإذا كان ذلك متاحًا، طلبًا مطابقًا في سجلات استخدام المزود.
- أرسل رسالة متابعة للتحقق من استمرارية المحادثة.
- اختبر الصور أو استدعاءات الأدوات بشكل منفصل إذا كان عملك يتطلب ذلك.
حفظ السجل ليس اختبار اتصال. الاستجابة النصية لا تثبت التوافق مع كل إمكانية. تغيير إدخال نموذج لا يعيد تكوين عملية Claude Code أو Codex الحالية تلقائيًا؛ انظر PandaPaw.
استكشاف الأخطاء وإصلاحها
فشل المصادقة
تحقق مما إذا كان المفتاح نشطًا، وما إذا كان الحساب يمكنه الوصول إلى النموذج، وما إذا كانت الخدمة تتطلب حقول مصادقة إضافية. استبدل بيانات الاعتماد منتهية الصلاحية عبر نموذج المزود.
نقطة النهاية أو النموذج غير موجود
تحقق من عنوان URL الأساسي وقيمة النموذج معًا. ابحث عن مسارات تشغيل مكررة، أو بادئة API مفقودة، أو معرف نموذج غير متاح لحسابك. نفس الخطأ يمكن أن يكون له أسباب مختلفة عبر المزودين.
ظهور خطأ شبكة أو متصفح
تحقق من الاتصال من الجهاز الذي يرسل الطلب فعليًا. الطلبات القادمة من المتصفح تخضع لقيود CORS وHTTPS؛ الطلب الناجح من كمبيوتر آخر لا يثبت أن مسار المتصفح يعمل.
لا يمكن الوصول إلى خادم نموذج محلي
localhost يشير إلى الجهاز الذي يرسل الطلب. لا يشير تلقائيًا إلى كمبيوتر PandaPaw البعيد الخاص بك. أكد مكان تشغيل الميزة المستهلكة قبل اختيار عنوان الخادم المحلي الخاص بك.
النص يعمل ولكن الصور أو الأدوات أو الجلسات الطويلة تفشل
تحقق من المجموعة الدقيقة للمحرك وبروتوكول API وقدرات النموذج. استخدم الحدود المدعومة من المزود وتحقق من كل نوع إدخال مطلوب. زيادة نافذة السياق أو تغيير نوع النموذج لا يضيف قدرات علوية.
للتمييز بين عضوية المنصة واستخدام المزود، انظر الحسابات وتكاليف النماذج.