Semantic Search för FreeScout
Semantic Search är en fristående FreeScout-modul som fixar sökning med flera ord och, när du lägger till din egen AI-nyckel, hittar konversationer efter vad de handlar om. Den säljs av skaparna av ReplyRabbit men behöver inte ReplyRabbit installerat.
Letar du efter översikten?
Översikt
FreeScouts inbyggda sökning söker efter hela din fråga som en fras i ett fält. En sökning som frank invoice hittar inget, eftersom kundnamnet finns på ett ställe och ordet "faktura" på ett annat. Semantic Search ersätter det beteendet i två steg:
- Nyckelordsläge (ingen nyckel behövs): varje ord i din sökning måste förekomma någonstans i konversationen. Ämne, kundnamn, e-postadress och meddelandetext räknas alla. Detta är på så snart modulen är aktiv.
- Sök efter betydelse (din egen AI-nyckel): varje konversation får ett kompakt fingeravtryck av vad den handlar om, lagrat i din FreeScout-databas. En sökning matchas på betydelse och på nyckelord, och de två listorna blandas så att det bästa svaret kommer först. Detta läge driver även Liknande konversationer panelen i konversationssidofältet.
Söksidan visar en liten Semantisk eller Nyckelord etikett bredvid resultatantalet så att agenter vet vilket läge som svarade.
Söksyntax
Den vanliga sökmotorsförkortningen fungerar i båda lägena:
| Du skriver | Vad det gör |
|---|---|
frank invoice | Båda orden måste förekomma någonstans i konversationen. |
"out of stock" | Den exakta frasen måste förekomma. |
-refund eller -"out of stock" | Konversationer som innehåller ordet eller frasen lämnas utanför. |
cart OR basket | Antingen ordet räcker. OR måste vara med versaler. |
admin@example.com eller example.com | En e-postadress eller domän matchas exakt. |
Sök efter betydelse lägger bara till konversationer som tydligt handlar om samma sak som orden du skrev. Citerade fraser, adresser och -exclusions gäller fortfarande för dessa resultat, så en sökning på en e-postadress fylls aldrig med orelaterade konversationer.
Sökfält och filter
På sökresultatsidan sitter sökrutan precis bredvid Konversationer och Kunder flikar, så du kan ändra en sökning utan att scrolla tillbaka till toppen. Sorteringsmenyn finns till höger om Kunder fliken.

Klicka på reglageknappen bredvid sökrutan för att öppna Filter panelen. Du behöver inte komma ihåg förkortningen ovan: de fyra ordreglerna skriver in den i sökfältet åt dig.
| Filter | Vad det skriver | Vad det gör |
|---|---|---|
| Alla dessa ord | frank invoice | Varje ord måste förekomma. |
| Denna exakta fras | "out of stock" | Orden måste förekomma tillsammans, i denna ordning. |
| Något av dessa ord | cart OR basket | Ett av orden räcker. |
| Inget av dessa ord | -refund | Konversationer med ordet lämnas utanför. |

De vanliga FreeScout-filtren (brevlåda, status, tilldelad, kund, datum och mer) finns i Avancerat avsnittet längst ner i panelen. Det är ihopfällt för att hålla panelen kort och öppnas av sig självt när ett av dessa filter redan används. En liten siffra på reglageknappen visar hur många filter som är aktiva. Klicka Tillämpa för att köra sökningen, eller Rensa alla för att börja om.

Från 1.1.3, Kunder fliken tittar också på varje ord för sig. Om ingen kund matchar alla ord listar den kunder som matchar något av dem, närmaste matchningar först, så invoice frank hittar fortfarande en kund som heter Frank.
Förutsättningar
Innan du börjar, se till att du har:
- FreeScout 1.8.101 eller nyare på PHP 8.1 eller senare.
- En fungerande FreeScout-köarbetare och schemaläggare (
php artisan queue:workochschedule:runcron). Indexeringen körs på dem. - En Semantic Search-licens från din ReplyRabbit-konto. Köpmejlet innehåller licensnyckeln.
- Valfritt, för sökning efter betydelse: en API-nyckel från OpenAI eller Google Gemini, eller bas-URL:en och embedding-modellnamnet för en kompatibel tjänst som OpenRouter, Ollama eller LM Studio.
Installera modulen
Ladda ner ZIP-filen
Logga in på app.replyrabbit.app med den e-postadress du använde i kassan och öppna Semantic Search kortet på instrumentpanelen. Ladda nersemantic-search.zip.Kopiera den till mappen Modules
Packa uppsemantic-search.zipoch kopieraSemanticSearchmappen tillModuleskatalogen i din FreeScout-installation, via SFTP eller din värdleverantörs filhanterare, bredvid de andra modulerna. FreeScout har ingen uppladdning i appen för tredjepartsmoduler.Aktivera modulen
Aktivera Semantic Search från modullistan. Aktivering kör databasmigreringarna som skapar de två indextabellerna.Prova en sökning
Sök efter ett kundnamn plus ett ämne, till exempel ett förnamn och "faktura". Resultaten matchar nu varje ord var det än förekommer i en konversation, och söksidan visar Nyckelord etikett.
Nyckelordsläge fungerar vid denna punkt utan ytterligare konfiguration. Stegen nedan låser upp sökning efter betydelse och panelen för liknande konversationer.
Ange licensnyckeln
Öppna inställningssidan
I FreeScout, gå till Hantera, sedan Inställningar, sedan Semantic Search.Klistra in licensnyckeln
I Licens avsnittet, klistra in nyckeln från ditt köpmejl och spara. Statusen visar Licensierad med tiden för den senaste kontrollen.
Licensen är knuten till webbplats-URL:en för FreeScout-installationen. Om du flyttar FreeScout till en ny domän, kontakta hey@replyrabbit.app så återställer vi den.
Konfigurera sökning efter betydelse
Välj en leverantör
I Embedding-provider avsnittet, välj OpenAI, Google, eller OpenAI-kompatibel. Standardmodellen är ifylld för OpenAI och Google. För en kompatibel tjänst, ange bas-URL:en och det modellnamn den förväntar sig.Lägg till nyckeln och testa den
Klistra in API-nyckeln om din leverantör behöver en och klicka sedan på Testa inbäddningar. Testet skickar en kort mening till embedding-slutpunkten och kontrollerar dess svar. Nycklar lagras krypterade, och endast en maskerad förhandsvisning visas efter sparning.Välj brevlådorna som ska indexeras
I Indexerar avsnittet, markera brevlådorna som ska ingå. Inkludera interna anteckningar är på som standard, eftersom agenter ofta söker i sina egna anteckningar. Ställ in Dagar för efterfyllning för hur långt tillbaka som ska indexeras (standard är 365 dagar).Slå på sökning efter betydelse
Markera Sök efter betydelse och spara. Om leverantören, modellen eller bas-URL:en ändrades meddelar sidan att konversationerna kommer att indexeras om i bakgrunden.Starta det första indexet
Klicka Indexera nu. Statusblocket visar förlopp såsom "Indexerat 1 240 av 8 900 (14 %)", senaste körningstid, senaste fel om något, och den uppskattade återstående kostnaden. Indexering körs i omgångar på cirka 200 konversationer var femte minut, så en stor helpdesk tar några timmar. Sökningen fortsätter att fungera hela tiden.
Vilken leverantör?
Använd en anpassad embedding-slutpunkt
Ange en API-bas-URL som https://embeddings.example.com/v1 eller http://10.0.0.25:8001/v1, följt av det exakta embedding-modell-ID som serveras där. Semantisk sökning lägger till /embeddings till bas-URL:en. Offentliga adresser kräver HTTPS. En privat eller loopback HTTP-adress måste finnas på ett betrott nätverk som FreeScout kan nå.
Om en gateway hanterar både chatt och embeddings kan du ange samma /v1 bas-URL här och i ReplyRabbits anpassade leverantörsinställningar. Konfigurera embedding-modellen här och chattmodellen i ReplyRabbit. Om dina chatt- och embedding-servrar har separata URL:er, ange varje URL i sin egen produkt. Produkterna delar inte tokens eller inställningar.
Den Testa inbäddningar åtgärden måste returnera en inbäddningsvektor. En chattmodell som bara svarar /chat/completions kan inte driva sökning efter betydelse. Att ändra endpoint eller modell startar en ny indexprofil; att bara ändra token behåller befintliga vektorer.


Hålla det uppdaterat
När en ny version släpps visar FreeScout den på Hantera, sedan Moduler, och Uppdatera nu installerar den på plats: ingen SFTP, ingen ny uppladdning. ZIP-filen du laddade ner från din instrumentpanel innehåller din egen licens nedladdningslänk, så uppdateringen hämtas bakom samma licenskontroll som den första nedladdningen.
Två saker att veta:
- Uppdateringen fungerar bara för en kopia som laddats ner från din instrumentpanel, och du bör inte föra vidare din kopia: dess uppdateringslänk innehåller din egen licens nedladdningsnyckel, så alla som har ZIP-filen kan hämta uppdateringar på din licens. En kopia från någon annan är knuten till deras licens och uppdateras på deras nyckel.
- Om FreeScout rapporterar ett nedladdningsfel, ladda ner den nya ZIP-filen från din instrumentpanel och ersätt mappen manuellt, som i installationsstegen ovan. Din index och dina inställningar överlever: de finns i databasen, inte i modulmappen.
Kostnad
Indexering skickar texten i varje konversation till din leverantör en gång, plus igen om konversationen får ett nytt svar. Sökning skickar endast sökorden.
| Leverantör | Modell | Pris | Cirka 100 konversationer |
|---|---|---|---|
| OpenAI | text-embedding-3-small | 0,02 USD per miljon tokens | ungefär 0,01 USD |
| Google Gemini | gemini-embedding-001 | gratisnivå, sedan prissättning per token | vanligtvis gratis |
| Ollama eller LM Studio | vilken inbäddningsmodell som helst | ingen | ingen |
Inställningssidan visar en uppskattning för de konversationer som fortfarande väntar på att indexeras, så du kan kontrollera antalet innan du klickar Indexera nu. Omindexering sker endast när du byter leverantör eller modell, eller klickar på Indexera om allt.
Panelen Liknande konversationer
Med sökning efter betydelse påslagen, en Liknande konversationer panelen visas i konversationssidofältet. Den listar andra konversationer i samma brevlåda som handlar om samma sak, med ämne, kundnamn och datum. Agenter ser bara konversationer de redan har åtkomst till.
Stäng av panelen för alla med Liknande konversationer växla på inställningssidan. En ny konversation visar "Nothing similar yet" tills den har indexerats, vilket tar några minuter.

Kommandorad
Två kommandon hjälper när du hanterar FreeScout över SSH:
php artisan semanticsearch:status
php artisan semanticsearch:reindex --limit=2000status skriver ut samma täckningssiffror som inställningssidan. reindex kör en batch direkt istället för att vänta på schemaläggaren, vilket är användbart för det första indexet på en stor desk.
Felsökning
| Symptom | Vad man ska kontrollera |
|---|---|
| Söksidan visar Nyckelord istället för Semantisk | Bekräfta Sök efter betydelse är ikryssad, är licensstatusen Licensierad, och statusblocket visar inget nyligt fel. Om nyckeln misslyckades faller sökningen tillbaka till nyckelordsläge tills den är åtgärdad. |
| Ingen etikett visas på söksidan alls | Sökningen skickades vidare till FreeScouts egen sökning. Detta händer för sökningar som bara är en siffra (ärendenummer eller ordernummer), vilket kärnan redan hanterar bra. |
| Testa inbäddningar misslyckas | Kontrollera att nyckeln inte har inledande eller avslutande mellanslag och tillhör rätt leverantör. För en kompatibel tjänst, bekräfta att bas-URL:en är nåbar från FreeScout-servern och att embedding-modellens namn är exakt vad tjänsten förväntar sig. |
| Statusen säger "Inget indexerat ännu" | Se till att köarbetaren och schemaläggarens cron körs. Klicka på Indexera nu och uppdatera efter en minut. På delad hosting kan den första batchen ta några minuter att starta. |
| Indexeringen stannar halvvägs | Läs det senaste felet i statusblocket. Hastighetsbegränsningar och kvotfel från leverantören är den vanliga orsaken; indexeringen återupptas vid nästa schemalagda körning. |
| Sökresultaten är långsamma på en mycket stor helpdesk | Nyckelordsläge kontrollerar varje sökord mot meddelandetexten, vilket är tyngre än kärnans matchning av en enda fras. Håll sökningarna till några få ord, eller minska antalet brevlådor som ingår i indexeringen. |
| Panelen Liknande konversationer är tom | Konversationen har inte indexerats ännu, eller så är panelen avstängd i inställningarna. Nya konversationer indexeras inom några minuter. |
Integritet och datahantering
Nyckelordssökning körs helt inom din FreeScout-databas och skickar ingenting någonstans. Med sökning efter betydelse på skickas texten i varje indexerad konversation (ämne, kundmeddelanden, agentsvar och interna anteckningar om de ingår) till leverantören du konfigurerat. En offentlig endpoint använder HTTPS; en privat HTTP-endpoint stannar i nätverket du konfigurerar. Nyckeln är valfri för en kompatibel endpoint. Endast det returnerade fingeravtrycket lagras.
Den enda kontakten med replyrabbit.app är licenskontrollen, som skickar licensnyckeln, FreeScout-webbplatsens URL och modulversionen. Ingen konversationstext, inga sökord eller kunddata skickas till oss.
Om konversationstext måste stanna på dina egna servrar, använd en lokal leverantör eller en kompatibel endpoint på ditt betrodda privata nätverk, eller håll dig i nyckelordsläge. Med en kompatibel offentlig endpoint färdas texten över HTTPS. Privata HTTP-endpoints tillåts endast på ett betrott nätverk.
Vanliga frågor
Behöver jag ReplyRabbit för att använda Semantic Search?
Nej. Semantic Search är en separat FreeScout-modul från samma skapare. Den installeras och körs på egen hand. ReplyRabbit är bara där du köper den, laddar ner den och hanterar licensnyckeln.
Fungerar Semantic Search utan en AI-nyckel?
Ja. Nyckelordsläget är på från det att du aktiverar modulen, utan nyckel och utan inställningar. Varje ord i din sökning måste förekomma någonstans i konversationen, i ämnet, kundnamnet, e-postadressen eller meddelandetexten. AI-nyckeln lägger bara till sökning efter betydelse och panelen med liknande konversationer.
Vilka AI-leverantörer kan jag använda?
OpenAI (text-embedding-3-small som standard), Google Gemini (gemini-embedding-001 som standard) eller valfri OpenAI-kompatibel tjänst som OpenRouter, Ollama eller LM Studio där du anger bas-URL och modell själv. Z.AI stöds inte eftersom det saknar embedding-tjänst.
Hur mycket kostar AI-nyckeln?
Med OpenAI text-embedding-3-small till 0.02 USD per miljon tokens kostar indexering av cirka 100 konversationer ungefär 0.01 USD. En helpdesk med 10 000 konversationer betalar runt 1 USD för att indexera allt en gång, sedan några cent i månaden för ny e-post. Inställningssidan visar en uppskattning innan den första indexeringen körs.
Var lagras sökdata?
I två tabeller i din befintliga FreeScout-databas. Varje indexerad konversation lägger till cirka en halv kilobyte. Ingen separat sökserver behövs, och inget lagras på replyrabbit.app.
Fungerar den på PostgreSQL?
Ja. Nyckelordssökning och sökning efter betydelse fungerar båda på MySQL, MariaDB och PostgreSQL.
Vad händer om min nyckel slutar fungera eller licensen löper ut?
Sökningen faller tillbaka till nyckelordsläge på egen hand, så agenter fortsätter få resultat. Inställningssidan visar orsaken. Nyckelordssökning beror aldrig på licensen eller nyckeln.