Semantic Search til FreeScout
Semantic Search er et selvstændigt FreeScout-modul, der retter søgning med flere ord og, når du tilføjer din egen AI-nøgle, finder samtaler ud fra, hvad de handler om. Det sælges af skaberne af ReplyRabbit, men kræver ikke, at ReplyRabbit er installeret.
Leder du efter oversigten?
Oversigt
FreeScouts indbyggede søgning søger efter hele din forespørgsel som én frase i ét felt. En søgning som frank invoice finder intet, fordi kundenavnet er ét sted, og ordet "faktura" er et andet. Semantic Search erstatter den adfærd i to trin:
- Nøgleordstilstand (ingen nøgle nødvendig): hvert ord i din søgning skal forekomme et sted i samtalen. Emne, kundenavn, e-mailadresse og meddelelsestekst tæller alle med. Dette er slået til, så snart modulet er aktivt.
- Søg efter betydning (din egen AI-nøgle): hver samtale får et kompakt fingeraftryk af, hvad den handler om, gemt i din FreeScout-database. En søgning matches på betydning og på nøgleord, og de to lister blandes, så det bedste svar kommer først. Denne tilstand driver også Lignende samtaler panel i samtalesidebjælken.
Søgesiden viser en lille Semantisk eller Nøgleord etiket ved siden af resultatantallet, så medarbejdere ved, hvilken tilstand der svarede.
Søgesyntaks
Den sædvanlige søgemaskine-forkortelse virker i begge tilstande:
| Du skriver | Hvad den gør |
|---|---|
frank invoice | Begge ord skal forekomme et sted i samtalen. |
"out of stock" | Den præcise sætning skal forekomme. |
-refund eller -"out of stock" | Samtaler, der indeholder ordet eller sætningen, udelades. |
cart OR basket | Et af ordene er nok. OR skal være med store bogstaver. |
admin@example.com eller example.com | En e-mailadresse eller et domæne matches præcist. |
Søg efter betydning tilføjer kun samtaler, der tydeligt handler om det samme som de ord, du skrev. Citerede sætninger, adresser og -exclusions gælder stadig for disse resultater, så en søgning efter en e-mailadresse aldrig fyldes med urelaterede samtaler.
Søgefelt og filtre
På søgeresultatsiden sidder søgefeltet lige ved siden af Samtaler og Kunder faner, så du kan ændre en søgning uden at rulle tilbage til toppen. Sorteringsdropdownen sidder til højre for Kunder fane.

Klik på skyderknappen ved siden af søgefeltet for at åbne Filtre panel. Du behøver ikke huske forkortelsen ovenfor: de fire ordregler skriver den ind i søgefeltet for dig.
| Filter | Hvad den skriver | Hvad den gør |
|---|---|---|
| Alle disse ord | frank invoice | Hvert ord skal forekomme. |
| Denne præcise sætning | "out of stock" | Ordene skal optræde sammen, i denne rækkefølge. |
| Nogle af disse ord | cart OR basket | Et af ordene er nok. |
| Ingen af disse ord | -refund | Samtaler med ordet udelades. |

De standard FreeScout-filtre (postkasse, status, tildelt, kunde, datoer og mere) findes i Avanceret sektion nederst i panelet. Den er foldet sammen for at holde panelet kort og åbner sig selv, når et af disse filtre allerede er i brug. Et lille tal på skyderknappen viser, hvor mange filtre der er aktive. Klik Anvend for at køre søgningen, eller Ryd alle for at starte igen.

Fra 1.1.3, Kunder fanen ser også på hvert ord for sig. Hvis ingen kunde matcher hvert ord, viser den kunder, der matcher et af dem, tætteste match først, så invoice frank finder stadig en kunde ved navn Frank.
Forudsætninger
Før du starter, skal du sikre dig, at du har:
- FreeScout 1.8.101 eller nyere på PHP 8.1 eller senere.
- En fungerende FreeScout-kø-worker og scheduler (
php artisan queue:workogschedule:runcron). Indeksering kører på dem. - En Semantic Search-licens fra din ReplyRabbit-konto. Købs-e-mailen indeholder licensnøglen.
- Valgfrit, til søgning efter betydning: en API-nøgle fra OpenAI eller Google Gemini eller basis-URL og embedding-modelnavn for en kompatibel tjeneste som OpenRouter, Ollama eller LM Studio.
Installer modulet
Download ZIP-filen
Log ind på app.replyrabbit.app med den e-mailadresse, du brugte ved kassen, og åbn Semantic Search kortet på dashboardet. Downloadsemantic-search.zip.Kopiér den ind i Modules-mappen
Udpaksemantic-search.zipog kopierSemanticSearchmappen ind iModulesmappen i din FreeScout-installation, via SFTP eller din hosts filhåndtering, ved siden af de andre moduler. FreeScout har ingen upload i appen til tredjepartsmoduler.Aktiver modulet
Aktiver Semantic Search fra Modullisten. Aktivering kører de databasemigreringer, der opretter de to indekstabeller.Prøv en søgning
Søg efter et kundenavn plus et emne, for eksempel et fornavn og "faktura". Resultaterne matcher nu hvert ord, uanset hvor det optræder i en samtale, og søgesiden viser Nøgleord etiket.
Nøgleordstilstand fungerer på dette tidspunkt uden yderligere opsætning. Trinene nedenfor låser op for søgning efter betydning og panelet med lignende samtaler.
Indtast licensnøglen
Åbn indstillingssiden
I FreeScout skal du gå til Administrer, derefter Indstillinger, derefter Semantic Search.Indsæt licensnøglen
I Licens sektion, indsæt nøglen fra din købs-e-mail og gem. Status viser Licenseret med tidspunktet for den seneste kontrol.
Licensen er knyttet til websteds-URL'en for FreeScout-installationen. Hvis du flytter FreeScout til et nyt domæne, kontakt hey@replyrabbit.app og vi nulstiller den.
Opsæt søgning efter betydning
Vælg en udbyder
I Embedding-udbyder sektion, vælg OpenAI, Google, eller OpenAI-kompatibel. Standardmodellen er udfyldt for OpenAI og Google. For en kompatibel tjeneste skal du indtaste basis-URL'en og det modelnavn, den forventer.Tilføj nøglen og test den
Indsæt API-nøglen, hvis din udbyder kræver en, og klik derefter Test embeddings. Testen sender én kort sætning til embedding-endpointet og tjekker svaret. Nøgler gemmes krypteret, og der vises kun en maskeret forhåndsvisning efter gemning.Vælg de postkasser, der skal indekseres
I Indekserer sektion, markér de postkasser, der skal medtages. Medtag interne noter er slået til som standard, fordi medarbejdere ofte søger i deres egne noter. Indstil Dage for bagudfyldning for hvor langt tilbage der skal indekseres (standard er 365 dage).Slå søgning efter betydning til
Sæt flueben Søg efter betydning og gem. Hvis udbyderen, modellen eller base URL'en blev ændret, fortæller siden dig, at samtaler vil blive genindekseret i baggrunden.Start det første indeks
Klik Indekser nu. Statusblokken viser fremdrift såsom "Indekseret 1.240 af 8.900 (14%)", seneste kørselstidspunkt, den seneste fejl, hvis nogen, og den anslåede resterende omkostning. Indeksering kører i batches på cirka 200 samtaler hvert femte minut, så en stor desk tager et par timer. Søgning fungerer hele tiden.
Hvilken udbyder?
Brug et brugerdefineret embedding-endpoint
Indtast en API-base-URL som https://embeddings.example.com/v1 eller http://10.0.0.25:8001/v1, efterfulgt af det præcise embedding-model-ID, der leveres der. Semantisk søgning tilføjer /embeddings til base-URL'en. Offentlige adresser kræver HTTPS. En privat eller loopback HTTP-adresse skal være på et betroet netværk, som FreeScout kan nå.
Hvis en gateway betjener både chat og embeddings, kan du indtaste den samme /v1 base URL her og i ReplyRabbits brugerdefinerede udbyderindstillinger. Konfigurer embedding-modellen her og chat-modellen i ReplyRabbit. Hvis dine chat- og embedding-servere har separate URL'er, skal du indtaste hver URL i sit eget produkt. Produkterne deler ikke tokens eller indstillinger.
Den Test embeddings action skal returnere en embedding-vektor. En chat-model, der kun svarer /chat/completions kan ikke drive søgning efter betydning. Ændring af endpointet eller modellen starter en ny indeksprofil; ændring af kun tokenet beholder de eksisterende vektorer.


Holder det opdateret
Når en ny version udgives, viser FreeScout den på Administrer, derefter Moduler, og Opdater nu installerer den på stedet: ingen SFTP, ingen ny upload. Den ZIP, du downloadede fra dit dashboard, indeholder din egen licens' downloadlink, så opdateringen hentes bag samme licenskontrol som den første download.
To ting at vide:
- Opdateringen virker kun for en kopi downloadet fra dit dashboard, og du bør ikke give din kopi videre: dens opdateringslink indeholder din egen licens' downloadnøgle, så enhver, der har ZIP-filen, kan hente opdateringer på din licens. En kopi fra en anden er bundet til deres licens og opdateres på deres nøgle.
- Hvis FreeScout rapporterer en downloadfejl, skal du downloade den nye ZIP fra dit dashboard og erstatte mappen manuelt, som i installationsvejledningen ovenfor. Din index og dine indstillinger overlever: de ligger i databasen, ikke i modulmappen.
Pris
Indeksering sender teksten fra hver samtale til din udbyder én gang, plus igen hvis samtalen får et nyt svar. Søgning sender kun søgeordene.
| Udbyder | Model | Pris | Omkring 100 samtaler |
|---|---|---|---|
| OpenAI | text-embedding-3-small | 0,02 USD pr. million tokens | cirka 0,01 USD |
| Google Gemini | gemini-embedding-001 | gratis niveau, derefter pris pr. token | normalt gratis |
| Ollama eller LM Studio | enhver embedding-model | ingen | ingen |
Indstillingssiden viser et skøn for de samtaler, der stadig venter på at blive indekseret, så du kan tjekke tallet, før du klikker Indekser nu. Genindeksering sker kun, når du ændrer udbyderen eller modellen, eller klikker på Genindekser alt.
Panel for lignende samtaler
Med søgning efter betydning slået til, en Lignende samtaler panelet vises i samtalesidebjælken. Det viser andre samtaler i samme postkasse, som handler om det samme, med emne, kundenavn og dato. Agenter ser kun samtaler, de allerede har adgang til.
Slå panelet fra for alle med Lignende samtaler slå til på indstillingssiden. En ny samtale viser "Nothing similar yet", indtil den er indekseret, hvilket tager et par minutter.

Kommandolinje
To kommandoer hjælper, når du administrerer FreeScout over SSH:
php artisan semanticsearch:status
php artisan semanticsearch:reindex --limit=2000status viser de samme dækningstal som indstillingssiden. reindex kører en batch med det samme i stedet for at vente på planlæggeren, hvilket er nyttigt til det første indeks på en stor desk.
Fejlfinding
| Symptom | Hvad du skal kontrollere |
|---|---|
| Søgesiden viser Nøgleord i stedet for Semantisk | Bekræft Søg efter betydning er markeret, er licensstatus Licenseret, og statusblokken viser ingen nylig fejl. Hvis nøglen fejlede, falder søgningen tilbage til nøgleordstilstand, indtil den er rettet. |
| Ingen etiket vises på søgesiden overhovedet | Søgningen blev overdraget til FreeScouts egen søgning. Det sker for søgninger, der kun er et tal (sags- eller ordrenumre), som kernen allerede håndterer godt. |
| Test embeddings fejler | Tjek, at nøglen ikke har indledende eller afsluttende mellemrum og tilhører den rigtige udbyder. For en kompatibel tjeneste skal du bekræfte, at basis-URL'en kan nås fra FreeScout-serveren, og at embedding-modellens navn præcis er det, tjenesten forventer. |
| Status siger "Intet indekseret endnu" | Sørg for, at queue-workeren og scheduler-cron kører. Klik Indekser nu og opdater efter et minut. På delt hosting kan den første batch tage et par minutter om at starte. |
| Indeksering stopper undervejs | Læs den sidste fejl på statusblokken. Hastighedsgrænser og kvotefejl fra udbyderen er den sædvanlige årsag; indeksering genoptages ved næste planlagte kørsel. |
| Søgeresultater er langsomme på et meget stort desk | Nøgleordstilstand tjekker hvert søgeord mod meddelelses tekst, hvilket er tungere end kernens enkeltfrase-matchning. Hold søgninger til få ord, eller reducér antallet af mailbokse, der indgår i indekseringen. |
| Panelet for lignende samtaler er tomt | Samtalen er ikke blevet indekseret endnu, eller panelet er slået fra i indstillingerne. Nye samtaler indekseres inden for få minutter. |
Privatliv og datahåndtering
Nøgleordssøgning kører helt inde i din FreeScout-database og sender intet nogen steder. Med søgning efter betydning slået til sendes teksten i hver indekseret samtale (emne, kundemeddelelser, agentsvar og interne noter, hvis inkluderet) til den udbyder, du konfigurerede. Et offentligt endpoint bruger HTTPS; et privat HTTP-endpoint forbliver på det netværk, du konfigurerer. Nøglen er valgfri for et kompatibelt endpoint. Kun det returnerede fingeraftryk gemmes.
Den eneste kontakt med replyrabbit.app er licenskontrollen, som sender licensnøglen, FreeScout-websteds-URL'en og modulversionen. Ingen samtaletekst, søgeord eller kundedata sendes til os.
Hvis samtaletekst skal blive på dine egne servere, skal du bruge en lokal udbyder eller et kompatibelt endpoint på dit betroede private netværk, eller blive i nøgleords-tilstand. Med et kompatibelt offentligt endpoint rejser teksten over HTTPS. Private HTTP-endpoints er kun tilladt på et betroet netværk.
FAQ
Skal jeg have ReplyRabbit for at bruge Semantic Search?
Nej. Semantic Search er et separat FreeScout-modul fra de samme skabere. Det installeres og kører selvstændigt. ReplyRabbit er kun der, hvor du køber det, downloader det og administrerer licensnøglen.
Fungerer Semantic Search uden en AI-nøgle?
Ja. Keyword-tilstand er aktiv fra det øjeblik, du aktiverer modulet, uden nøgle og uden indstillinger. Hvert ord i din søgning skal forekomme et sted i samtalen, i emnet, kundenavnet, e-mailadressen eller beskedteksten. AI-nøglen tilføjer kun søgning efter betydning og panelet med lignende samtaler.
Hvilke AI-udbydere kan jeg bruge?
OpenAI (text-embedding-3-small som standard), Google Gemini (gemini-embedding-001 som standard) eller enhver OpenAI-kompatibel tjeneste som OpenRouter, Ollama eller LM Studio, hvor du selv indtaster basis-URL og model. Z.AI understøttes ikke, fordi det ikke har nogen embeddings-tjeneste.
Hvad koster AI-nøglen?
Med OpenAI text-embedding-3-small til 0,02 USD pr. million tokens koster indeksering af omkring 100 samtaler cirka 0,01 USD. En desk med 10.000 samtaler betaler omkring 1 USD for at indeksere alt én gang, derefter et par cent om måneden for ny mail. Indstillingssiden viser et skøn, før det første indeks kører.
Hvor opbevares søgedataene?
I to tabeller i din eksisterende FreeScout-database. Hver indekseret samtale tilføjer cirka en halv kilobyte. Der er ikke behov for en separat søgeserver, og intet gemmes på replyrabbit.app.
Fungerer den på PostgreSQL?
Ja. Keyword-søgning og søgning efter betydning fungerer begge på MySQL, MariaDB og PostgreSQL.
Hvad sker der, hvis min nøgle holder op med at virke, eller licensen udløber?
Søgning falder selv tilbage til nøgleordstilstand, så agenter fortsat får resultater. Indstillingssiden viser årsagen. Nøgleordssøgning afhænger aldrig af licensen eller nøglen.