Conectar FreeScout a um servidor personalizado compatível com OpenAI
No ReplyRabbit Pro ou Team, escolha Personalizado compatível com OpenAI para enviar rascunhos a um servidor de API ou gateway que você controla. Insira a URL base, um bearer token opcional e o ID exato do modelo de chat. O ReplyRabbit testa os recursos que você configura antes que você dependa deles.
O que seu servidor precisa suportar
Para rascunhos e prévias, o servidor deve aceitar POST /chat/completions com model, messages, max_tokens, e temperature, então retorne texto utilizável em choices[0].message.content. O ReplyRabbit acrescenta este caminho à URL base que você inserir.
Embeddings precisam de um modelo de embedding separado que aceite POST /embeddings com model e input, então retorna um vetor para cada entrada. A visão precisa de um modelo que aceite conteúdo de imagem no estilo OpenAI em uma conclusão de chat. O servidor pode oferecer suporte a chat sem oferecer suporte a nenhuma dessas capacidades.
O ReplyRabbit não usa a Responses API, streaming, chamadas de ferramentas, reranking, cabeçalhos personalizados ou descoberta automática de modelos com este provedor. A compatibilidade depende do formato da API e do modelo que você serve.
Configure a caixa de correio
Escolha o provedor
Abra as configurações do ReplyRabbit da sua caixa de correio do FreeScout. Em Provedor de IA, escolha Personalizado compatível com OpenAI. Esta opção exige Pro ou Team.Digite a URL base
Digite a base da API, comohttps://llm.example.com/v1ouhttp://10.0.0.25:8000/v1. Insira apenas a base; o ReplyRabbit adiciona/chat/completionsou/embeddings. O processo PHP do FreeScout deve conseguir acessar este endereço. Endereços públicos exigem HTTPS. HTTP é permitido apenas para um endereço privado ou de loopback em uma rede confiável.Digite o token e o modelo de chat
Se seu servidor exigir autenticação bearer, insira o token dele em Token bearer opcional. Caso contrário, deixe em branco. Insira o ID exato do modelo de chat informado pelo seu servidor. O ReplyRabbit armazena o token criptografado e mostra uma prévia mascarada após salvar.Configurar outros recursos
Para recuperação semântica, selecione este provedor para embeddings e digite um ID de modelo de embedding. Para prévias de caixa de correio ou visão de anexos, selecione ou herde o provedor e digite um modelo adequado quando necessário. A visão de anexos exige Team. Um modelo de chat não é usado automaticamente para embeddings.Testar e salvar
Clique Testar conexão. O teste envia um texto de amostra curto e relata chat, embeddings e visão separadamente para os modelos que você inseriu. Ele não salva o formulário. Revise os resultados e depois salve as configurações da caixa de correio.
Alterar a URL para um servidor diferente limpa o token salvo, a menos que você insira um substituto. O ReplyRabbit nunca envia uma chave salva de outro provedor para o endpoint personalizado.
Servidores compartilhados e separados
Se um gateway atender tanto chat quanto embeddings, insira a mesma /v1 URL base no ReplyRabbit e no standalone Configurações do Semantic Search. Insira o modelo de chat apropriado no ReplyRabbit e um modelo de embedding na Pesquisa Semântica. Os produtos mantêm configurações e tokens separados.
Se o chat e os embeddings rodarem em hosts ou portas diferentes, insira o próprio /v1 URL base nas configurações do produto. O ReplyRabbit também permite escolher outro provedor de embeddings existente para sua própria recuperação semântica.
Solução de problemas
| Sintoma | O que verificar |
|---|---|
| O teste de chat falha | Confirme se a URL base é acessível a partir do FreeScout, se o ID do modelo de chat está exato e se o servidor suporta /chat/completions. |
Todos os testes falham após uma atualização do PHP, mas curl funciona | Verifique o log do FreeScout para deprecated since 8.5 mensagens. Consulte Corrigir erros "deprecated since 8.5" no FreeScout. |
| Embeddings indisponíveis | Digite um ID de modelo de embedding e confirme que o servidor aceita /embeddings. A recuperação por palavras-chave permanece disponível quando os embeddings não podem ser executados. |
| O teste de visão falha | Confirme se o modelo escolhido aceita conteúdo de imagem. A redação de texto ainda pode funcionar sem visão. |
| O token desaparece após trocar de servidor | Digite um token para o novo servidor. O ReplyRabbit limpa o token do servidor antigo para protegê-lo. |
| URL HTTP pública é rejeitada | Use HTTPS com um certificado válido. Mantenha os endpoints HTTP em uma rede privada confiável. |
Privacidade
O servidor escolhido recebe o conteúdo de suporte necessário para as tarefas de IA ativadas. Um endpoint remoto pode enviar esse conteúdo para fora do host do FreeScout. Use um servidor confiável, proteja seu token e verifique sua política de retenção. Os testes de conexão usam texto de exemplo em vez de conversas com clientes.