Подключить FreeScout к собственному серверу, совместимому с OpenAI
На ReplyRabbit Pro или Team выберите Пользовательский, совместимый с OpenAI чтобы отправлять черновики на сервер API или шлюз, который вы контролируете. Введите его базовый URL, необязательный bearer-токен и точный ID модели чата. ReplyRabbit проверяет возможности, которые вы настраиваете, прежде чем вы на них полагаетесь.
Что должен поддерживать ваш сервер
Для черновиков и превью сервер должен принимать POST /chat/completions с model, messages, max_tokens, и temperature, затем верните пригодный для использования текст в choices[0].message.content. ReplyRabbit добавляет этот путь к базовому URL, который вы вводите.
Для эмбеддингов нужна отдельная модель эмбеддингов, которая принимает POST /embeddings с model и input, затем возвращает вектор для каждого входа. Vision требует модель, которая принимает изображения в стиле OpenAI в чат-завершении. Сервер может поддерживать чат без поддержки любой из этих возможностей.
ReplyRabbit не использует Responses API, потоковую передачу, вызовы инструментов, переранжирование, пользовательские заголовки или автоматическое обнаружение моделей с этим провайдером. Совместимость зависит от формы API и модели, которую вы обслуживаете.
Настройте почтовый ящик
Выберите провайдера
Откройте настройки ReplyRabbit для вашего почтового ящика FreeScout. В разделе AI Provider, выберите Пользовательский, совместимый с OpenAI. Эта опция требует Pro или Team.Введите базовый URL
Введите базовый URL API, напримерhttps://llm.example.com/v1илиhttp://10.0.0.25:8000/v1. Введите только базовый адрес; ReplyRabbit добавляет/chat/completionsили/embeddings. PHP-процесс FreeScout должен иметь возможность достичь этого адреса. Публичные адреса требуют HTTPS. HTTP разрешён только для частного или loopback-адреса в доверенной сети.Введите токен и модель чата
Если ваш сервер требует bearer-аутентификацию, введите его токен в Необязательный токен доступа. В противном случае оставьте поле пустым. Введите точный ID модели чата, сообщаемый вашим сервером. ReplyRabbit хранит токен в зашифрованном виде и показывает замаскированный предварительный просмотр после сохранения.Настроить другие возможности
Для семантического поиска выберите этого провайдера для эмбеддингов и введите ID модели эмбеддингов. Для превью почтового ящика или vision вложений выберите или наследуйте провайдера и при необходимости введите подходящую модель. Vision вложений требует Team. Модель чата не используется автоматически для эмбеддингов.Проверить и сохранить
Нажмите Проверить подключение. Тест отправляет короткий образец текста и сообщает отдельно о чате, эмбеддингах и vision для введённых вами моделей. Он не сохраняет форму. Просмотрите результаты, затем сохраните настройки почтового ящика.
Изменение URL на другой сервер очищает сохранённый токен, если вы не введёте замену. ReplyRabbit никогда не отправляет сохранённый ключ другого провайдера на пользовательскую конечную точку.
Общие и отдельные серверы
Если один шлюз обслуживает и чат, и эмбеддинги, введите один и тот же /v1 base URL в ReplyRabbit и в отдельном Настройки Semantic Search. Введите соответствующую модель чата в ReplyRabbit и модель эмбеддингов в Semantic Search. Продукты хранят отдельные настройки и токены.
Если чат и эмбеддинги работают на разных хостах или портах, введите для каждого сервера свой /v1 base URL в его настройках продукта. ReplyRabbit также позволяет выбрать другого существующего провайдера эмбеддингов для собственного семантического поиска.
Устранение неполадок
| Симптом | Что проверить |
|---|---|
| Тест чата не проходит | Убедитесь, что базовый URL доступен из FreeScout, ID модели чата указан точно и сервер поддерживает /chat/completions. |
Каждый тест падает после обновления PHP, но curl работает | Проверьте журнал FreeScout на наличие deprecated since 8.5 сообщения. Смотрите Исправление ошибок "deprecated since 8.5" во FreeScout. |
| Эмбеддинги недоступны | Введите ID модели эмбеддингов и подтвердите, что сервер поддерживает /embeddings. Поиск по ключевым словам остаётся доступным, когда эмбеддинги не могут выполняться. |
| Проверка зрения не пройдена | Убедитесь, что выбранная модель принимает изображения. Создание текстовых черновиков может работать и без зрения. |
| Токен исчезает после смены серверов | Введите токен для нового сервера. ReplyRabbit очищает токен старого сервера для его защиты. |
| Публичный HTTP URL отклонён | Используйте HTTPS с действительным сертификатом. Держите HTTP-эндпоинты в доверенной частной сети. |
Конфиденциальность
Выбранный сервер получает содержимое поддержки, необходимое для включённых AI-задач. Удалённая конечная точка может передавать это содержимое за пределы хоста FreeScout. Используйте доверенный сервер, защищайте его токен и проверяйте его политику хранения. Тесты подключения используют образец текста вместо переписок с клиентами.