ربط FreeScout بخادم مخصص متوافق مع OpenAI
في ReplyRabbit Pro أو Team، اختر مخصص متوافق مع OpenAI لإرسال المسودات إلى خادم API أو بوابة تتحكم فيها. أدخل عنوان URL الأساسي، ورمز حامل اختياري، ومعرّف نموذج الدردشة الدقيق. يختبر ReplyRabbit القدرات التي تكوّنها قبل أن تعتمد عليها.
ما الذي يحتاج خادمك إلى دعمه
للمسودات والمعاينات، يجب أن يقبل الخادم POST /chat/completions مع model, messages, max_tokens، و temperature، ثم أعد نصاً قابلاً للاستخدام في choices[0].message.content. يضيف ReplyRabbit هذا المسار إلى عنوان URL الأساسي الذي تدخله.
تحتاج التضمينات إلى نموذج تضمين منفصل يقبل POST /embeddings مع model و input، ثم يعيد متجهاً لكل إدخال. تتطلب الرؤية نموذجاً يقبل محتوى صور بنمط OpenAI في إكمال الدردشة. يمكن للخادم دعم الدردشة دون دعم أي من هاتين القدرتين.
لا يستخدم ReplyRabbit واجهة Responses API أو البث أو استدعاءات الأدوات أو إعادة الترتيب أو الرؤوس المخصصة أو الاكتشاف التلقائي للنماذج مع هذا المزود. تعتمد التوافقية على شكل API والنموذج الذي تقدمه.
هيّئ صندوق البريد
اختر المزود
افتح إعدادات ReplyRabbit لصندوق بريد FreeScout الخاص بك. تحت AI Provider، اختر مخصص متوافق مع OpenAI. يتطلب هذا الخيار خطة Pro أو Team.أدخل عنوان URL الأساسي
أدخل أساس API، مثلhttps://llm.example.com/v1أوhttp://10.0.0.25:8000/v1. أدخل الأساس فقط؛ يضيف ReplyRabbit/chat/completionsأو/embeddings. يجب أن تتمكن عملية PHP في FreeScout من الوصول إلى هذا العنوان. تتطلب العناوين العامة HTTPS. يُسمح بـ HTTP فقط لعنوان خاص أو loopback على شبكة موثوقة.أدخل الرمز ونموذج الدردشة
إذا كان خادمك يتطلب مصادقة bearer، أدخل رمزه في رمز حامل اختياري. وإلا فاتركه فارغاً. أدخل معرّف نموذج الدردشة الدقيق الذي يبلغ عنه خادمك. يخزّن ReplyRabbit الرمز مشفّراً ويعرض معاينة مقنّعة بعد الحفظ.هيّئ قدرات أخرى
للاسترجاع الدلالي، اختر هذا الموفّر للتضمينات وأدخل معرّف نموذج تضمين. لمعاينات صندوق البريد أو رؤية المرفقات، اختر الموفّر أو ورّثه وأدخل نموذجًا مناسبًا عند الحاجة. تتطلب رؤية المرفقات خطة Team. لا يُستخدم نموذج الدردشة تلقائيًا للتضمينات.اختبر واحفظ
انقر اختبر الاتصال. يرسل الاختبار نصاً نموذجياً قصيراً ويبلّغ عن الدردشة والتضمينات والرؤية بشكل منفصل للنماذج التي أدخلتها. لا يحفظ النموذج. راجع النتائج، ثم احفظ إعدادات صندوق البريد.
يؤدي تغيير URL إلى خادم مختلف إلى مسح الرمز المميز المحفوظ ما لم تدخل بديلًا. لا يرسل ReplyRabbit أبدًا مفتاحًا محفوظًا من مزود آخر إلى نقطة النهاية المخصصة.
خوادم مشتركة ومنفصلة
إذا كانت بوابة واحدة تخدم الدردشة والتضمينات معاً، أدخل نفس /v1 عنوان URL الأساسي في ReplyRabbit وفي إعدادات Semantic Search. أدخل نموذج الدردشة المناسب في ReplyRabbit ونموذج تضمين في Semantic Search. تحتفظ المنتجات بإعدادات ورموز منفصلة.
إذا كانت الدردشة والتضمينات تعمل على مضيفين أو منافذ مختلفة، أدخل /v1 عنوان URL الأساسي في إعدادات منتجه. يتيح لك ReplyRabbit أيضاً اختيار مزود تضمين موجود آخر للاسترجاع الدلالي الخاص به.
استكشاف الأخطاء وإصلاحها
| العَرَض | ما يجب التحقق منه |
|---|---|
| فشل اختبار الدردشة | تأكد من إمكانية الوصول إلى base URL من FreeScout، ومن دقة معرّف نموذج الدردشة، ومن دعم الخادم لـ /chat/completions. |
كل اختبار يفشل بعد ترقية PHP، لكن curl يعمل | تحقق من سجل FreeScout بحثًا عن deprecated since 8.5 الرسائل. انظر إصلاح أخطاء "deprecated since 8.5" في FreeScout. |
| التضمينات غير متاحة | أدخل معرّف نموذج تضمين وتأكد من أن الخادم يدعم /embeddings. يبقى الاسترجاع بالكلمات المفتاحية متاحاً عندما يتعذر تشغيل التضمينات. |
| فشل اختبار الرؤية | تأكد من أن النموذج المختار يقبل محتوى الصور. يمكن أن تستمر صياغة النصوص دون رؤية. |
| يختفي الرمز بعد تغيير الخوادم | أدخل رمزًا للخادم الجديد. يمسح ReplyRabbit رمز الخادم القديم لحمايته. |
| يُرفض عنوان HTTP العام | استخدم HTTPS مع شهادة صالحة. أبقِ نقاط نهاية HTTP على شبكة خاصة موثوقة. |
الخصوصية
يتلقى الخادم المختار محتوى الدعم اللازم لمهام الذكاء الاصطناعي المفعّلة. يمكن لنقطة نهاية بعيدة إرسال ذلك المحتوى بعيدًا عن مضيف FreeScout. استخدم خادمًا موثوقًا، واحمِ رمزه، وتحقق من سياسة الاحتفاظ به. تستخدم اختبارات الاتصال نصًا تجريبيًا بدلًا من محادثات العملاء.