Conectar FreeScout a un servidor personalizado compatible con OpenAI
En ReplyRabbit Pro o Team, elige Personalizado compatible con OpenAI para enviar borradores a un servidor de API o puerta de enlace que controles. Introduce su URL base, un token de portador opcional y el ID exacto del modelo de chat. ReplyRabbit prueba las capacidades que configuras antes de que dependas de ellas.
Qué debe admitir tu servidor
Para borradores y vistas previas, el servidor debe aceptar POST /chat/completions con model, messages, max_tokens, y temperature, luego devuelve texto utilizable en choices[0].message.content. ReplyRabbit añade esta ruta a la URL base que introduces.
Los embeddings necesitan un modelo de embeddings independiente que acepte POST /embeddings con model y input, luego devuelve un vector para cada entrada. La visión necesita un modelo que acepte contenido de imagen al estilo OpenAI en una finalización de chat. El servidor puede admitir chat sin admitir ninguna de esas dos capacidades.
ReplyRabbit no utiliza la API de Responses, streaming, llamadas a herramientas, reranking, encabezados personalizados ni descubrimiento automático de modelos con este proveedor. La compatibilidad depende de la forma de la API y del modelo que sirvas.
Configurar el buzón
Elegir el proveedor
Abre los ajustes de ReplyRabbit de tu buzón de FreeScout. En Proveedor de IA, elige Personalizado compatible con OpenAI. Esta opción requiere Pro o Team.Introduce la URL base
Introduce la base de la API, comohttps://llm.example.com/v1ohttp://10.0.0.25:8000/v1. Introduce solo la base; ReplyRabbit añade/chat/completionso/embeddings. El proceso PHP de FreeScout debe poder alcanzar esta dirección. Las direcciones públicas requieren HTTPS. HTTP solo se permite para una dirección privada o de bucle local en una red de confianza.Introduce el token y el modelo de chat
Si tu servidor requiere autenticación bearer, introduce su token en Token bearer opcional. De lo contrario, déjalo en blanco. Introduce el ID exacto del modelo de chat que indica tu servidor. ReplyRabbit almacena el token cifrado y muestra una vista previa enmascarada tras guardar.Configurar otras capacidades
Para la recuperación semántica, selecciona este proveedor para los embeddings e introduce un ID de modelo de embeddings. Para las vistas previas del buzón o la visión de adjuntos, selecciona o hereda el proveedor e introduce un modelo adecuado cuando sea necesario. La visión de adjuntos requiere Team. Un modelo de chat no se usa automáticamente para los embeddings.Probar y guardar
Hacer clic Probar conexión. La prueba envía un texto de muestra corto e informa por separado de chat, embeddings y visión para los modelos que introdujiste. No guarda el formulario. Revisa los resultados y luego guarda la configuración del buzón.
Cambiar la URL a un servidor diferente borra el token guardado a menos que introduzcas un reemplazo. ReplyRabbit nunca envía una clave guardada de otro proveedor al endpoint personalizado.
Servidores compartidos y separados
Si una sola pasarela sirve tanto el chat como los embeddings, introduce el mismo /v1 URL base en ReplyRabbit y en el Configuración de Semantic Search. Introduce el modelo de chat adecuado en ReplyRabbit y un modelo de embeddings en Búsqueda semántica. Los productos mantienen ajustes y tokens separados.
Si el chat y los embeddings se ejecutan en hosts o puertos diferentes, introduce el /v1 URL base en su configuración de producto. ReplyRabbit también te permite elegir otro proveedor de embeddings existente para su propia recuperación semántica.
Resolución de problemas
| Síntoma | Qué comprobar |
|---|---|
| La prueba de chat falla | Confirmar que la URL base es accesible desde FreeScout, que el ID del modelo de chat es exacto y que el servidor admite /chat/completions. |
Cada prueba falla después de una actualización de PHP, pero curl funciona | Comprobar el registro de FreeScout para deprecated since 8.5 mensajes. Consulta Corregir errores de "deprecated since 8.5" en FreeScout. |
| Los embeddings no están disponibles | Introduce un ID de modelo de embeddings y confirma que el servidor admite /embeddings. La recuperación por palabras clave sigue disponible cuando los embeddings no pueden ejecutarse. |
| La prueba de visión falla | Confirmar que el modelo elegido acepta contenido de imagen. La redacción de texto puede seguir funcionando sin visión. |
| El token desaparece tras cambiar de servidor | Introduce un token para el nuevo servidor. ReplyRabbit borra el token del servidor anterior para protegerlo. |
| Se rechaza la URL HTTP pública | Usa HTTPS con un certificado válido. Mantén los endpoints HTTP en una red privada de confianza. |
Privacidad
El servidor elegido recibe el contenido de soporte necesario para las tareas de IA habilitadas. Un endpoint remoto puede enviar ese contenido fuera del host de FreeScout. Usa un servidor de confianza, protege su token y revisa su política de retención. Las pruebas de conexión usan texto de muestra en lugar de conversaciones de clientes.