Connecter FreeScout à un serveur personnalisé compatible OpenAI
Sur ReplyRabbit Pro ou Team, choisissez Personnalisé compatible OpenAI pour envoyer les brouillons à un serveur API ou une passerelle que vous contrôlez. Saisissez son URL de base, un jeton bearer facultatif et l'ID exact du modèle de chat. ReplyRabbit teste les capacités que vous configurez avant que vous ne vous y fiiez.
Ce que votre serveur doit prendre en charge
Pour les brouillons et les aperçus, le serveur doit accepter POST /chat/completions avec model, messages, max_tokens, et temperature, puis renvoyez un texte exploitable dans choices[0].message.content. ReplyRabbit ajoute ce chemin à l'URL de base que vous saisissez.
Les embeddings nécessitent un modèle d'embedding distinct qui accepte POST /embeddings avec model et input, puis renvoie un vecteur pour chaque entrée. La vision nécessite un modèle qui accepte le contenu d'image au format OpenAI dans un chat completion. Le serveur peut prendre en charge le chat sans prendre en charge l'une ou l'autre de ces capacités.
ReplyRabbit n'utilise pas l'API Responses, le streaming, les appels d'outils, le reranking, les en-têtes personnalisés ni la découverte automatique de modèles avec ce fournisseur. La compatibilité dépend de la forme de l'API et du modèle que vous servez.
Configurer la boîte aux lettres
Choisir le fournisseur
Ouvrez les paramètres ReplyRabbit de votre boîte aux lettres FreeScout. Sous Fournisseur d'IA, choisissez Personnalisé compatible OpenAI. Cette option nécessite Pro ou Team.Saisissez l'URL de base
Saisissez la base de l'API, telle quehttps://llm.example.com/v1ouhttp://10.0.0.25:8000/v1. Saisissez uniquement la base ; ReplyRabbit ajoute/chat/completionsou/embeddings. Le processus PHP de FreeScout doit pouvoir joindre cette adresse. Les adresses publiques nécessitent HTTPS. HTTP n'est autorisé que pour une adresse privée ou de bouclage sur un réseau de confiance.Saisissez le jeton et le modèle de chat
Si votre serveur exige une authentification bearer, saisissez son jeton dans Jeton bearer facultatif. Sinon, laissez vide. Saisissez l'ID exact du modèle de chat indiqué par votre serveur. ReplyRabbit stocke le token chiffré et affiche un aperçu masqué après l'enregistrement.Configurer d'autres capacités
Pour la récupération sémantique, sélectionnez ce fournisseur pour les embeddings et saisissez un ID de modèle d'embedding. Pour les aperçus de boîte aux lettres ou la vision des pièces jointes, sélectionnez ou héritez du fournisseur et saisissez un modèle approprié si nécessaire. La vision des pièces jointes nécessite Team. Un modèle de chat n'est pas automatiquement utilisé pour les embeddings.Tester et enregistrer
Cliquer Tester la connexion. Le test envoie un court texte d'exemple et indique séparément le chat, les embeddings et la vision pour les modèles que vous avez saisis. Il n'enregistre pas le formulaire. Examinez les résultats, puis enregistrez les paramètres de la boîte aux lettres.
La modification de l'URL vers un autre serveur efface le jeton enregistré sauf si vous saisissez un remplacement. ReplyRabbit n'envoie jamais une clé enregistrée d'un autre fournisseur vers le point de terminaison personnalisé.
Serveurs partagés et séparés
Si une seule passerelle sert à la fois le chat et les embeddings, saisissez la même /v1 URL de base dans ReplyRabbit et dans le Paramètres Semantic Search. Saisissez le modèle de chat approprié dans ReplyRabbit et un modèle d'embedding dans Recherche sémantique. Les produits conservent des paramètres et des tokens distincts.
Si le chat et les embeddings s'exécutent sur des hôtes ou des ports différents, saisissez le /v1 URL de base dans ses paramètres de produit. ReplyRabbit vous permet également de choisir un autre fournisseur d'embeddings existant pour sa propre récupération sémantique.
Dépannage
| Symptôme | Ce qu'il faut vérifier |
|---|---|
| Le test de chat échoue | Confirmez que l'URL de base est accessible depuis FreeScout, que l'ID du modèle de chat est exact et que le serveur prend en charge /chat/completions. |
Chaque test échoue après une mise à niveau de PHP, mais curl fonctionne | Consultez le journal FreeScout pour deprecated since 8.5 messages. Voir Corriger les erreurs « deprecated since 8.5 » dans FreeScout. |
| Les embeddings ne sont pas disponibles | Saisissez un ID de modèle d'embedding et confirmez que le serveur prend en charge /embeddings. La recherche par mots-clés reste disponible lorsque les embeddings ne peuvent pas s'exécuter. |
| Le test de vision échoue | Confirmez que le modèle choisi accepte le contenu image. La rédaction de texte peut toujours fonctionner sans vision. |
| Le jeton disparaît après un changement de serveur | Saisissez un jeton pour le nouveau serveur. ReplyRabbit efface le jeton de l'ancien serveur pour le protéger. |
| L'URL HTTP publique est rejetée | Utilisez HTTPS avec un certificat valide. Gardez les points de terminaison HTTP sur un réseau privé de confiance. |
Confidentialité
Le serveur choisi reçoit le contenu de support nécessaire aux tâches IA activées. Un point de terminaison distant peut envoyer ce contenu hors de l'hôte FreeScout. Utilisez un serveur de confiance, protégez son jeton et vérifiez sa politique de conservation. Les tests de connexion utilisent un texte d'exemple au lieu de conversations client.