Semantic Search for FreeScout
Semantic Search er en frittstående FreeScout-modul som fikser søk med flere ord og, når du legger til din egen AI-nøkkel, finner samtaler etter hva de handler om. Den selges av skaperne av ReplyRabbit, men trenger ikke ReplyRabbit installert.
Ser du etter oversikten?
Oversikt
FreeScouts innebygde søk ser etter hele spørringen din som én frase i ett felt. Et søk som frank invoice finner ingenting, fordi kundenavnet er på ett sted og ordet "faktura" er på et annet. Semantic Search erstatter denne oppførselen i to trinn:
- Nøkkelordmodus (ingen nøkkel nødvendig): hvert ord i søket må finnes et sted i samtalen. Emne, kundenavn, e-postadresse og meldingstekst teller alle. Dette er på så snart modulen er aktiv.
- Søk etter betydning (din egen AI-nøkkel): hver samtale får et kompakt fingeravtrykk av hva den handler om, lagret i FreeScout-databasen din. Et søk matches på betydning og på nøkkelord, og de to listene blandes slik at det beste svaret kommer først. Denne modusen driver også Lignende samtaler panelet i sidepanelet for samtalen.
Søkesiden viser en liten Semantisk eller Nøkkelord etikett ved siden av resultatantallet slik at agenter vet hvilken modus som svarte.
Søkesyntaks
Den vanlige søkemotorsjargongen fungerer i begge moduser:
| Du skriver | Hva det gjør |
|---|---|
frank invoice | Begge ordene må forekomme et sted i samtalen. |
"out of stock" | Den nøyaktige frasen må vises. |
-refund eller -"out of stock" | Samtaler som inneholder ordet eller frasen utelates. |
cart OR basket | Ett av ordene er nok. OR må være med store bokstaver. |
admin@example.com eller example.com | En e-postadresse eller et domene matches nøyaktig. |
Søk etter betydning legger bare til samtaler som tydelig handler om det samme som ordene du skrev. Siterte fraser, adresser og -exclusions gjelder fortsatt for disse resultatene, så et søk etter en e-postadresse fylles aldri opp med urelaterte samtaler.
Søkefelt og filtre
På søkeresultatsiden ligger søkeboksen rett ved siden av Samtaler og Kunder fanene, slik at du kan endre et søk uten å rulle tilbake til toppen. Sorteringsrullegardinen ligger til høyre for Kunder fanen.

Klikk på glidebryterknappen ved siden av søkefeltet for å åpne Filtre panelet. Du trenger ikke huske forkortelsen ovenfor: de fire ordreglene skriver den inn i søkefeltet for deg.
| Filter | Hva det skriver | Hva det gjør |
|---|---|---|
| Alle disse ordene | frank invoice | Hvert ord må forekomme. |
| Denne nøyaktige frasen | "out of stock" | Ordene må vises sammen, i denne rekkefølgen. |
| Noen av disse ordene | cart OR basket | Ett av ordene er nok. |
| Ingen av disse ordene | -refund | Samtaler med ordet utelates. |

De vanlige FreeScout-filtrene (postkasse, status, tildelt, kunde, datoer og mer) ligger i Avansert seksjonen nederst i panelet. Den er foldet sammen for å holde panelet kort, og åpnes av seg selv når ett av disse filtrene allerede er i bruk. Et lite tall på glidebryterknappen viser hvor mange filtre som er aktive. Klikk Bruk for å kjøre søket, eller Fjern alle for å starte på nytt.

Fra 1.1.3, Kunder fanen ser også på hvert ord for seg selv. Hvis ingen kunde matcher alle ordene, lister den opp kunder som matcher noen av dem, med nærmeste treff først, slik at invoice frank finner fortsatt en kunde som heter Frank.
Forutsetninger
Før du starter, må du sørge for at du har:
- FreeScout 1.8.101 eller nyere på PHP 8.1 eller senere.
- En fungerende FreeScout-køarbeider og planlegger (
php artisan queue:workogschedule:runcron). Indeksering kjører på dem. - En Semantic Search-lisens fra din ReplyRabbit-konto. Kjøps-e-posten inneholder lisensnøkkelen.
- Valgfritt, for søk etter betydning: en API-nøkkel fra OpenAI eller Google Gemini, eller base-URL-en og navnet på embedding-modellen til en kompatibel tjeneste som OpenRouter, Ollama eller LM Studio.
Installer modulen
Last ned ZIP-filen
Logg inn på app.replyrabbit.app med e-postadressen du brukte ved betaling og åpne Semantic Search kortet på dashbordet. Last nedsemantic-search.zip.Kopier den inn i Modules-mappen
Pakk utsemantic-search.zipog kopierSemanticSearchmappen inn iModulesmappen i FreeScout-installasjonen din, via SFTP eller vertens filbehandler, ved siden av de andre modulene. FreeScout har ingen opplasting i appen for tredjepartsmoduler.Aktiver modulen
Aktiver Semantic Search fra Modullisten. Aktivering kjører databasemigreringene som oppretter de to indekstabellene.Prøv et søk
Søk etter et kundenavn pluss et emne, for eksempel et fornavn og «faktura». Resultatene samsvarer nå med hvert ord uansett hvor det forekommer i en samtale, og søkesiden viser Nøkkelord etikett.
Nøkkelordmodus fungerer på dette punktet uten ytterligere oppsett. Trinnene nedenfor låser opp søk etter betydning og panelet med lignende samtaler.
Skriv inn lisensnøkkelen
Åpne innstillingssiden
I FreeScout, gå til Administrer, deretter Innstillinger, deretter Semantic Search.Lim inn lisensnøkkelen
I Lisens seksjonen, lim inn nøkkelen fra kjøps-e-posten din og lagre. Statusen viser Lisensiert med tidspunktet for siste sjekk.
Lisensen er knyttet til nettsteds-URL-en til FreeScout-installasjonen. Hvis du flytter FreeScout til et nytt domene, kontakt hey@replyrabbit.app og vi tilbakestiller det.
Sett opp søk etter betydning
Velg en leverandør
I Embedding-leverandør seksjonen, velg OpenAI, Google, eller OpenAI-kompatibel. Standardmodellen er fylt inn for OpenAI og Google. For en kompatibel tjeneste, skriv inn basis-URL-en og modellnavnet den forventer.Legg til nøkkelen og test den
Lim inn API-nøkkelen hvis leverandøren din trenger en, og klikk deretter Test innebygninger. Testen sender én kort setning til embedding-endepunktet og sjekker svaret. Nøkler lagres kryptert, og bare en maskert forhåndsvisning vises etter lagring.Velg postkassene som skal indekseres
I Indekserer seksjonen, kryss av for postkassene som skal inkluderes. Inkluder interne notater er på som standard, fordi agenter ofte søker i egne notater. Angi Dager for etterfylling for hvor langt tilbake som skal indekseres (standard er 365 dager).Slå på søk etter betydning
Kryss av Søk etter betydning og lagre. Hvis leverandøren, modellen eller base URL ble endret, forteller siden deg at konversasjoner vil bli re-indeksert i bakgrunnen.Start den første indeksen
Klikk Indekser nå. Statusblokken viser fremdrift som "Indeksert 1 240 av 8 900 (14 %)", siste kjøretid, siste feil hvis noen, og estimert gjenstående kostnad. Indeksering kjøres i partier på omtrent 200 samtaler hvert femte minutt, så en stor kundeservice tar noen timer. Søk fungerer hele tiden.
Hvilken leverandør?
Bruk et egendefinert innbyggingsendepunkt
Skriv inn en API-base-URL som https://embeddings.example.com/v1 eller http://10.0.0.25:8001/v1, etterfulgt av den nøyaktige embedding-modell-ID-en som serveres der. Semantisk søk legger til /embeddings til basis-URL-en. Offentlige adresser krever HTTPS. En privat eller loopback HTTP-adresse må være på et klarert nettverk som FreeScout kan nå.
Hvis en gateway betjener både chat og embeddings, kan du angi den samme /v1 base URL her og i ReplyRabbits tilpassede leverandørinnstillinger. Konfigurer embedding-modellen her og chat-modellen i ReplyRabbit. Hvis chat- og embedding-serverne dine har separate URL-er, skriv inn hver URL i sitt eget produkt. Produktene deler ikke tokens eller innstillinger.
Den Test innebygninger handlingen må returnere en embedding-vektor. En chat-modell som bare svarer /chat/completions kan ikke drive søk etter betydning. Endring av endepunktet eller modellen starter en ny indeksprofil; endring av bare tokenet beholder de eksisterende vektorene.


Holde det oppdatert
Når en ny versjon er utgitt, viser FreeScout den på Administrer, deretter Moduler, og Oppdater nå installerer den på stedet: ingen SFTP, ingen ny opplasting. ZIP-filen du lastet ned fra dashbordet ditt, bærer din egen lisens' nedlastingslenke, så oppdateringen hentes bak samme lisenskontroll som den første nedlastingen.
To ting å vite:
- Oppdateringen fungerer bare for en kopi lastet ned fra dashbordet ditt, og du bør ikke gi kopien videre: oppdateringslenken inneholder nedlastingsnøkkelen til din egen lisens, så alle som har ZIP-filen kan hente oppdateringer på din lisens. En kopi fra noen andre er knyttet til deres lisens og oppdateres på deres nøkkel.
- Hvis FreeScout rapporterer en nedlastingsfeil, laster du ned den nye ZIP-filen fra dashbordet ditt og erstatter mappen manuelt, som i installasjonstrinnene ovenfor. Index og innstillinger overlever: de ligger i databasen, ikke i modulmappen.
Kostnad
Indeksering sender teksten i hver samtale til leverandøren din én gang, pluss igjen hvis samtalen får et nytt svar. Søking sender bare søkeordene.
| Leverandør | Modell | Pris | Omtrent 100 samtaler |
|---|---|---|---|
| OpenAI | text-embedding-3-small | 0,02 USD per million tokens | omtrent 0,01 USD |
| Google Gemini | gemini-embedding-001 | gratisnivå, deretter per-token-prising | vanligvis gratis |
| Ollama eller LM Studio | enhver embedding-modell | ingen | ingen |
Innstillingssiden viser et anslag for samtalene som fortsatt venter på å bli indeksert, slik at du kan sjekke tallet før du klikker Indekser nå. Reindeksering skjer bare når du endrer leverandøren eller modellen, eller klikker Reindekser alt.
Panel for lignende samtaler
Med søk etter betydning på, en Lignende samtaler panelet vises i sidepanelet for samtalen. Det lister opp andre samtaler i samme postkasse som handler om det samme, med emne, kundenavn og dato. Agenter ser bare samtaler de allerede har tilgang til.
Slå av panelet for alle med Lignende samtaler bryteren på innstillingssiden. En ny samtale viser "Nothing similar yet" til den er indeksert, noe som tar noen minutter.

Kommandolinje
To kommandoer hjelper når du administrerer FreeScout over SSH:
php artisan semanticsearch:status
php artisan semanticsearch:reindex --limit=2000status skriver ut de samme dekningsnumrene som innstillingssiden. reindex kjører en batch med en gang i stedet for å vente på planleggeren, noe som er nyttig for den første indeksen på et stort skrivebord.
Feilsøking
| Symptom | Hva du bør sjekke |
|---|---|
| Søkesiden viser Nøkkelord i stedet for Semantisk | Bekreft Søk etter betydning er avkrysset, er lisensstatusen Lisensiert, og statusblokken viser ingen nylig feil. Hvis nøkkelen feilet, faller søket tilbake til nøkkelordmodus til det er rettet. |
| Ingen etikett vises på søkesiden i det hele tatt | Søket ble overlatt til FreeScouts eget søk. Dette skjer for søk som bare er et tall (saks- eller ordrenumre), som kjernen allerede håndterer godt. |
| Test innebygninger feiler | Sjekk at nøkkelen ikke har innledende eller avsluttende mellomrom og tilhører riktig leverandør. For en kompatibel tjeneste, bekreft at basis-URL-en er tilgjengelig fra FreeScout-serveren og at embedding-modellnavnet er nøyaktig det tjenesten forventer. |
| Statusen sier «Ingenting indeksert ennå» | Sørg for at køarbeideren og planleggeren cron kjører. Klikk Indekser nå og oppdater etter et minutt. På delt hosting kan den første batchen ta noen minutter å starte. |
| Indeksering stopper halvveis | Les den siste feilen i statusblokken. Hastighetsbegrensninger og kvotefeil fra leverandøren er den vanlige årsaken; indeksering gjenopptas ved neste planlagte kjøring. |
| Søkeresultater er trege på en svært stor desk | Nøkkelordmodus sjekker hvert søkeord mot meldingsteksten, noe som er tyngre enn kjernens enkeltfrase-samsvar. Hold søk til noen få ord, eller reduser antall postkasser som inkluderes i indekseringen. |
| Panelet for lignende samtaler er tomt | Samtalen er ikke indeksert ennå, eller panelet er slått av i innstillingene. Nye samtaler indekseres innen noen minutter. |
Personvern og datahåndtering
Nøkkelordsøk kjører helt inne i FreeScout-databasen din og sender ingenting noe sted. Med søk etter betydning på, sendes teksten i hver indekserte samtale (emne, kundemeldinger, agentsvar og interne notater hvis inkludert) til leverandøren du konfigurerte. Et offentlig endepunkt bruker HTTPS; et privat HTTP-endepunkt forblir på nettverket du konfigurerer. Nøkkelen er valgfri for et kompatibelt endepunkt. Bare det returnerte fingeravtrykket lagres.
Den eneste kontakten med replyrabbit.app er lisenssjekken, som sender lisensnøkkelen, FreeScout-nettstedets URL og modulversjonen. Ingen samtaletekst, søkeord eller kundedata sendes til oss.
Hvis samtaletekst må bli på dine egne servere, bruk en lokal leverandør eller et kompatibelt endepunkt på ditt betrodde private nettverk, eller bli i nøkkelordmodus. Med et kompatibelt offentlig endepunkt går teksten over HTTPS. Private HTTP-endepunkter er bare tillatt på et betrodt nettverk.
FAQ
Trenger jeg ReplyRabbit for å bruke Semantic Search?
Nei. Semantic Search er en separat FreeScout-modul fra de samme skaperne. Den installeres og kjører på egen hånd. ReplyRabbit er bare der du kjøper den, laster den ned og administrerer lisensnøkkelen.
Fungerer Semantic Search uten en AI-nøkkel?
Ja. Nøkkelordmodus er på fra det øyeblikket du aktiverer modulen, uten nøkkel og uten innstillinger. Hvert ord i søket må forekomme et sted i konversasjonen, i emnet, kundenavnet, e-postadressen eller meldingsteksten. AI-nøkkelen legger bare til søk etter betydning og panelet med lignende konversasjoner.
Hvilke AI-leverandører kan jeg bruke?
OpenAI (text-embedding-3-small som standard), Google Gemini (gemini-embedding-001 som standard), eller en hvilken som helst OpenAI-kompatibel tjeneste som OpenRouter, Ollama eller LM Studio der du angir base-URL og modell selv. Z.AI støttes ikke fordi det ikke har noen embedding-tjeneste.
Hvor mye koster AI-nøkkelen?
Med OpenAI text-embedding-3-small til 0,02 USD per million tokens koster indeksering av omtrent 100 samtaler rundt 0,01 USD. En desk med 10 000 samtaler betaler rundt 1 USD for å indeksere alt én gang, deretter noen få cent i måneden for ny e-post. Innstillingssiden viser et estimat før den første indekseringen kjøres.
Hvor lagres søkedataene?
I to tabeller i din eksisterende FreeScout-database. Hver indekserte samtale legger til omtrent en halv kilobyte. Ingen separat søkeserver trengs, og ingenting lagres på replyrabbit.app.
Fungerer den på PostgreSQL?
Ja. Nøkkelordsøk og søk etter betydning fungerer begge på MySQL, MariaDB og PostgreSQL.
Hva skjer hvis nøkkelen min slutter å fungere eller lisensen utløper?
Søket faller tilbake til nøkkelordmodus av seg selv, slik at agentene fortsatt får resultater. Innstillingssiden viser årsaken. Nøkkelordsøk avhenger aldri av lisensen eller nøkkelen.