FreeScout verbinden met een aangepaste OpenAI-compatibele server
Kies op ReplyRabbit Pro of Team Aangepast OpenAI-compatibel om conceptteksten naar een API-server of gateway te sturen die je beheert. Voer de basis-URL, een optioneel bearer-token en de exacte chat-model-ID in. ReplyRabbit test de mogelijkheden die je configureert voordat je erop vertrouwt.
Wat je server moet ondersteunen
Voor concepten en previews moet de server dit accepteren POST /chat/completions met model, messages, max_tokens, en temperature, en retourneer dan bruikbare tekst in choices[0].message.content. ReplyRabbit voegt dit pad toe aan de basis-URL die je invoert.
Embeddings vereisen een apart embedding-model dat POST /embeddings met model en input, en retourneert dan een vector voor elke invoer. Vision vereist een model dat OpenAI-achtige afbeeldingsinhoud in een chat completion accepteert. De server kan chat ondersteunen zonder een van die mogelijkheden te ondersteunen.
ReplyRabbit gebruikt bij deze provider geen Responses API, streaming, tool calls, reranking, aangepaste headers of automatische modeldetectie. Compatibiliteit hangt af van de API-vorm en het model dat je aanbiedt.
De mailbox configureren
Kies de provider
Open de ReplyRabbit-instellingen voor je FreeScout-mailbox. Onder AI-provider, kies Aangepast OpenAI-compatibel. Deze optie vereist Pro of Team.Voer de basis-URL in
Voer de API-basis in, zoalshttps://llm.example.com/v1ofhttp://10.0.0.25:8000/v1. Voer alleen de basis in; ReplyRabbit voegt/chat/completionsof/embeddings. Het PHP-proces van FreeScout moet dit adres kunnen bereiken. Openbare adressen vereisen HTTPS. HTTP is alleen toegestaan voor een privé- of loopbackadres op een vertrouwd netwerk.Voer het token en chatmodel in
Als je server bearer-authenticatie vereist, voer dan het token in bij Optioneel bearer-token. Laat het anders leeg. Voer de exacte chatmodel-ID in die door je server wordt gerapporteerd. ReplyRabbit slaat het token versleuteld op en toont na opslaan een gemaskeerd voorbeeld.Andere mogelijkheden configureren
Selecteer voor semantische retrieval deze provider voor embeddings en voer een embedding-model-ID in. Selecteer of erf voor mailboxpreviews of attachment vision de provider en voer indien nodig een geschikt model in. Attachment vision vereist Team. Een chatmodel wordt niet automatisch gebruikt voor embeddings.Testen en opslaan
Klik Verbinding testen. De test stuurt korte voorbeeldtekst en rapporteert chat, embeddings en vision afzonderlijk voor de modellen die je hebt ingevoerd. Het formulier wordt niet opgeslagen. Bekijk de resultaten en sla dan de mailboxinstellingen op.
Het wijzigen van de URL naar een andere server wist het opgeslagen token, tenzij je een vervanging invoert. ReplyRabbit stuurt nooit een opgeslagen sleutel van een andere provider naar het aangepaste endpoint.
Gedeelde en aparte servers
Als één gateway zowel chat als embeddings bedient, voer dan dezelfde /v1 basis-URL in ReplyRabbit en in de standalone Semantic Search-instellingen. Voer het juiste chatmodel in bij ReplyRabbit en een embedding-model bij Semantic Search. De producten houden aparte instellingen en tokens aan.
Als chat en embeddings op verschillende hosts of poorten draaien, voer dan voor elke server de eigen /v1 basis-URL in de productinstellingen ervan. ReplyRabbit laat je ook een andere bestaande embedding-provider kiezen voor zijn eigen semantische ophalen.
Probleemoplossing
| Symptoom | Wat te controleren |
|---|---|
| Chattest mislukt | Bevestig dat de basis-URL bereikbaar is vanaf FreeScout, de chat-model-ID exact is en de server ondersteunt /chat/completions. |
Elke test faalt na een PHP-upgrade, maar curl werkt | Controleer de FreeScout-log op deprecated since 8.5 berichten. Zie Los "deprecated since 8.5"-fouten op in FreeScout. |
| Embeddings zijn niet beschikbaar | Voer een embedding-model-ID in en bevestig dat de server dit ondersteunt /embeddings. Trefwoordretrieval blijft beschikbaar wanneer embeddings niet kunnen worden uitgevoerd. |
| Vision-test mislukt | Bevestig dat het gekozen model afbeeldingsinhoud accepteert. Tekstconcepten kunnen nog steeds werken zonder vision. |
| Token verdwijnt na het wijzigen van servers | Voer een token in voor de nieuwe server. ReplyRabbit wist het token van de oude server om die te beschermen. |
| Openbare HTTP-URL wordt geweigerd | Gebruik HTTPS met een geldig certificaat. Houd HTTP-endpoints op een vertrouwd privénetwerk. |
Privacy
De gekozen server ontvangt de supportinhoud die nodig is voor ingeschakelde AI-taken. Een extern endpoint kan die inhoud wegsturen van de FreeScout-host. Gebruik een vertrouwde server, bescherm het token en controleer het bewaarbeleid. Verbindingstests gebruiken voorbeeldtekst in plaats van klantgesprekken.