Semantic Search FreeScoutille
Semantic Search on erillinen FreeScout-moduuli, joka korjaa monisanahaun ja, kun lisäät oman AI-avaimesi, löytää keskustelut sen mukaan, mistä ne kertovat. ReplyRabbitin tekijät myyvät sitä, mutta se ei vaadi ReplyRabbitin asentamista.
Etsitkö yleiskatsausta?
Yleiskatsaus
FreeScoutin sisäänrakennettu haku etsii koko kyselyäsi yhtenä lauseena yhdestä kentästä. Haku kuten frank invoice ei löydä mitään, koska asiakkaan nimi on yhdessä paikassa ja sana "lasku" toisessa. Semantic Search korvaa tämän toiminnan kahdessa vaiheessa:
- Avainsanatila (avainta ei tarvita): jokaisen hakusanan on esiinnyttävä jossain keskustelussa. Aihe, asiakkaan nimi, sähköpostiosoite ja viestin teksti lasketaan mukaan. Tämä on käytössä heti, kun moduuli on aktiivinen.
- Hae merkityksen mukaan (oma AI-avaimesi): jokainen keskustelu saa tiiviin sormenjäljen siitä, mistä siinä on kyse, ja se tallennetaan FreeScout-tietokantaasi. Haku täsmäytetään merkityksen ja avainsanojen perusteella, ja kaksi listaa yhdistetään niin, että paras vastaus tulee ensin. Tämä tila mahdollistaa myös Samankaltaiset keskustelut paneeli keskustelun sivupalkissa.
Hakusivu näyttää pienen Semanttinen tai Avainsana tunniste tulosmäärän vieressä, jotta agentit tietävät, mikä tila vastasi.
Hakusyntaksi
Tavallinen hakukoneiden pikakirjoitus toimii molemmissa tiloissa:
| Kirjoitat | Mitä se tekee |
|---|---|
frank invoice | Molempien sanojen on esiinnyttävä jossain keskustelussa. |
"out of stock" | Tarkan lauseen on esiinnyttävä. |
-refund tai -"out of stock" | Keskustelut, jotka sisältävät sanan tai lauseen, jätetään pois. |
cart OR basket | Kumpi tahansa sana riittää. OR on oltava isoilla kirjaimilla. |
admin@example.com tai example.com | Sähköpostiosoite tai verkkotunnus täsmää tarkalleen. |
Merkityksen mukaan -haku lisää vain keskustelut, jotka selvästi käsittelevät samaa asiaa kuin kirjoittamasi sanat. Lainatut lauseet, osoitteet ja -exclusions koskevat edelleen näitä tuloksia, joten sähköpostiosoitteen haku ei koskaan täyty asiaankuulumattomista keskusteluista.
Hakupalkki ja suodattimet
Hakutulossivulla hakukenttä on aivan Keskustelut ja Asiakkaat tabs, joten voit muuttaa hakua palaamatta ylös. Lajittelun pudotusvalikko on Asiakkaat tab.

Napsauta liukusäätimien painiketta hakuruudun vieressä avataksesi Suodattimet paneeli. Sinun ei tarvitse muistaa yllä olevaa lyhennettä: neljän sanan säännöt kirjoittavat sen puolestasi hakukenttään.
| Suodatin | Mitä se kirjoittaa | Mitä se tekee |
|---|---|---|
| Kaikki nämä sanat | frank invoice | Jokaisen sanan on esiinnyttävä. |
| Tämä tarkka lause | "out of stock" | Sanojen on esiinnyttävä yhdessä tässä järjestyksessä. |
| Mikä tahansa näistä sanoista | cart OR basket | Yksi sanoista riittää. |
| Ei mitään näistä sanoista | -refund | Keskustelut, joissa sana esiintyy, jätetään pois. |

FreeScoutin vakiosuodattimet (postilaatikko, tila, määritetty, asiakas, päivämäärät ja muut) sijaitsevat kohdassa Lisäasetukset osio paneelin alaosassa. Se on taitettu piiloon paneelin pitämiseksi lyhyenä, ja avautuu itsestään, kun jokin näistä suodattimista on jo käytössä. Pieni numero liukusäätimien painikkeessa näyttää, kuinka monta suodatinta on aktiivisena. Napsauta Käytä suorittaa haku, tai Tyhjennä kaikki aloittaaksesi uudelleen.

Versiosta 1.1.3 alkaen Asiakkaat tab tarkastelee myös jokaista sanaa erikseen. Jos yksikään asiakas ei vastaa kaikkia sanoja, se luettelee asiakkaat, jotka vastaavat jotakin niistä, lähimmät osumat ensin, joten invoice frank löytää silti Frankin nimisen asiakkaan.
Edellytykset
Ennen kuin aloitat, varmista, että sinulla on:
- FreeScout 1.8.101 tai uudempi PHP 8.1 tai uudemmalla.
- Toimiva FreeScout-jonon työntekijä ja ajastin (
php artisan queue:workjaschedule:runcron). Indeksointi pyörii niillä. - Semantic Search -lisenssi osoitteesta ReplyRabbit-tili. Oston sähköposti sisältää lisenssiavaimen.
- Valinnainen, merkityksen mukaiseen hakuun: API-avain OpenAI:lta tai Google Geminiltä tai yhteensopivan palvelun, kuten OpenRouterin, Ollaman tai LM Studion, perus-URL ja embedding-mallin nimi.
Asenna moduuli
Lataa ZIP
Kirjaudu sisään osoitteessa app.replyrabbit.app kassalla käyttämälläsi sähköpostiosoitteella ja avaa Semantic Search kortti hallintapaneelissa. Lataasemantic-search.zip.Kopioi se Modules-kansioon
Pura ZIPsemantic-search.zipja kopioiSemanticSearchkansio kansioonModulesFreeScout-asennuksesi hakemistoon SFTP:n tai isäntäsi tiedostohallinnan kautta muiden moduulien viereen. FreeScoutissa ei ole sovelluksen sisäistä latausta kolmannen osapuolen moduuleille.Aktivoi moduuli
Aktivoi Semantic Search Moduulit-luettelosta. Aktivointi suorittaa tietokantamigraatiot, jotka luovat kaksi indeksitaulua.Kokeile hakua
Hae asiakkaan nimi ja aihe, esimerkiksi etunimi ja "lasku". Tulokset vastaavat nyt jokaista sanaa missä tahansa se esiintyy keskustelussa, ja hakusivu näyttää Avainsana tunniste.
Avainsanatila toimii tässä vaiheessa ilman lisäasetuksia. Alla olevat vaiheet avaavat haun merkityksen perusteella ja samankaltaisten keskustelujen paneelin.
Anna lisenssiavain
Avaa asetussivu
Siirry FreeScoutissa kohtaan Hallinnoi, sitten Asetukset, sitten Semantic Search.Liitä lisenssiavain
Kohdassa Lisenssi osio, liitä ostosähköpostistasi saatu avain ja tallenna. Tila näyttää Lisensoitu viimeisen tarkistuksen ajan kanssa.
Lisenssi on sidottu FreeScout-asennuksen sivuston URL-osoitteeseen. Jos siirrät FreeScoutin uuteen verkkotunnukseen, ota yhteyttä hey@replyrabbit.app ja nollaamme sen.
Ota merkitykseen perustuva haku käyttöön
Valitse palveluntarjoaja
Kohdassa Embedding-palveluntarjoaja osio, valitse OpenAI, Google, tai OpenAI-yhteensopiva. Oletusmalli on täytetty OpenAI:lle ja Googlelle. Yhteensopivalle palvelulle syötä perus-URL-osoite ja mallin nimi, jota se odottaa.Lisää avain ja testaa se
Liitä API-avain, jos palveluntarjoajasi tarvitsee sellaisen, ja napsauta sitten Testaa upotukset. Testi lähettää yhden lyhyen lauseen upotuspäätepisteeseen ja tarkistaa sen vastauksen. Avaimet tallennetaan salattuina, ja tallentamisen jälkeen näytetään vain peitetty esikatselu.Valitse indeksoitavat postilaatikot
Kohdassa Indeksointi osio, valitse mukaan otettavat postilaatikot. Sisällytä sisäiset muistiinpanot on oletuksena päällä, koska agentit etsivät usein omia muistiinpanojaan. Aseta Täydennyspäivät kuinka pitkälle taaksepäin indeksoidaan (oletus on 365 päivää).Kytke haku merkityksen mukaan päälle
Valitse Hae merkityksen mukaan ja tallenna. Jos palveluntarjoaja, malli tai perus-URL muuttui, sivu kertoo, että keskustelut indeksoidaan uudelleen taustalla.Aloita ensimmäinen indeksointi
Napsauta Indeksoi nyt. Tilalohko näyttää edistymisen, kuten "Indeksoitu 1 240 / 8 900 (14 %)", viimeisen ajoajan, viimeisimmän virheen, jos sellainen on, ja arvioidun jäljellä olevan kustannuksen. Indeksointi ajetaan noin 200 keskustelun erissä viiden minuutin välein, joten suuri työpöytä kestää muutaman tunnin. Haku toimii koko ajan.
Mikä palveluntarjoaja?
Käytä mukautettua upotus-päätepistettä
Anna API-perus-URL, kuten https://embeddings.example.com/v1 tai http://10.0.0.25:8001/v1, jota seuraa siellä tarjottava tarkka upotusmallin tunnus. Semanttinen haku lisää /embeddings perus-URL-osoitteeseen. Julkiset osoitteet vaativat HTTPS:n. Yksityisen tai loopback-HTTP-osoitteen on oltava luotetussa verkossa, johon FreeScout pääsee.
Jos yhdyskäytävä palvelee sekä chatia että upotuksia, voit syöttää saman /v1 perus-URL täällä ja osoitteessa ReplyRabbitin mukautetun tarjoajan asetukset. Määritä upotusmalli täällä ja chat-malli ReplyRabbitissa. Jos chat- ja upotuspalvelimillasi on erilliset URL-osoitteet, syötä kukin URL-osoite omaan tuotteeseensa. Tuotteet eivät jaa tokeneita tai asetuksia.
The Testaa upotukset actionin on palautettava upotusvektori. Chat-malli, joka vain vastaa /chat/completions ei voi toimia merkitykseen perustuvan haun voimanlähteenä. Päätepisteen tai mallin muuttaminen aloittaa uuden indeksiprofiilin; vain tokenin muuttaminen säilyttää olemassa olevat vektorit.


Sen pitäminen ajan tasalla
Kun uusi versio julkaistaan, FreeScout näyttää sen kohdassa Hallinnoi, sitten Moduulit, ja Päivitä nyt asentaa sen paikan päällä: ei SFTP:tä, ei uudelleenlatausta. Hallintapaneelistasi lataamasi ZIP sisältää oman lisenssisi latauslinkin, joten päivitys haetaan saman lisenssitarkistuksen takaa kuin ensimmäinen lataus.
Kaksi asiaa tiedoksi:
- Päivitys toimii vain hallintapaneelistasi ladatulle kopiolle, eikä kopiotasi pidä välittää eteenpäin: sen päivityslinkki sisältää oman lisenssisi latausavaimen, joten kuka tahansa ZIP-tiedoston haltija voisi hakea päivityksiä lisenssilläsi. Jonkun toisen kopio on sidottu heidän lisenssiinsä ja päivittyy heidän avaimellaan.
- Jos FreeScout ilmoittaa latausvirheestä, lataa uusi ZIP-tiedosto hallintapaneelistasi ja korvaa kansio käsin yllä olevien asennusohjeiden mukaisesti. Hakemistosi ja asetuksesi säilyvät: ne sijaitsevat tietokannassa, eivät moduulikansiossa.
Hinta
Indeksointi lähettää kunkin keskustelun tekstin tarjoajallesi kerran ja uudelleen, jos keskustelu saa uuden vastauksen. Haku lähettää vain hakusanat.
| Tarjoaja | Malli | Hinta | Noin 100 keskustelua |
|---|---|---|---|
| OpenAI | text-embedding-3-small | 0,02 USD miljoonaa tokenia kohden | noin 0,01 USD |
| Google Gemini | gemini-embedding-001 | ilmainen taso, sitten token-pohjainen hinnoittelu | yleensä ilmainen |
| Ollama tai LM Studio | mikä tahansa upotusmalli | ei mitään | ei mitään |
Asetussivu näyttää arvion vielä indeksointia odottavista keskusteluista, joten voit tarkistaa luvun ennen napsauttamista Indeksoi nyt. Uudelleenindeksointi tapahtuu vain, kun vaihdat palveluntarjoajaa tai mallia tai napsautat Indeksoi kaikki uudelleen.
Samankaltaisten keskustelujen paneeli
Kun merkityksen mukainen haku on päällä, Samankaltaiset keskustelut paneeli näkyy keskustelun sivupalkissa. Se listaa saman postilaatikon muut keskustelut, jotka käsittelevät samaa asiaa, sekä aiheen, asiakkaan nimen ja päivämäärän. Agentit näkevät vain keskustelut, joihin heillä on jo pääsy.
Kytke paneeli pois päältä kaikilta kohdassa Samankaltaiset keskustelut kytke asetussivulla päälle. Uusi keskustelu näyttää "Nothing similar yet", kunnes se on indeksoitu, mikä kestää muutaman minuutin.

Komentorivi
Kaksi komentoa auttavat, kun hallitset FreeScoutia SSH:n kautta:
php artisan semanticsearch:status
php artisan semanticsearch:reindex --limit=2000status tulostaa samat kattavuusluvut kuin asetussivu. reindex suorittaa erän heti odottamatta ajastinta, mikä on hyödyllistä suuren työpöydän ensimmäiselle indeksille.
Vianmääritys
| Oire | Mitä tarkistaa |
|---|---|
| Hakusivu näyttää Avainsana sijaan Semanttinen | Vahvista Hae merkityksen mukaan on valittu, lisenssin tila on Lisensoitu, ja tilalohkossa ei näy viimeaikaista virhettä. Jos avain epäonnistui, haku palaa avainsanatilaan, kunnes se on korjattu. |
| Hakusivulla ei näy lainkaan tunnistetta | Haku siirrettiin FreeScoutin omaan hakuun. Näin tapahtuu hauille, jotka ovat vain numero (tiketti- tai tilausnumerot), jotka ydin jo käsittelee hyvin. |
| Testaa upotukset epäonnistuu | Tarkista, ettei avaimessa ole alussa tai lopussa välilyöntejä ja että se kuuluu oikealle palveluntarjoajalle. Yhteensopivan palvelun osalta varmista, että perus-URL on tavoitettavissa FreeScout-palvelimelta ja että upotusmallin nimi on täsmälleen se, mitä palvelu odottaa. |
| Tila sanoo "Nothing indexed yet" | Varmista, että jonotyöntekijä ja ajastimen cron ovat käynnissä. Napsauta Indeksoi nyt ja päivitä minuutin kuluttua. Jaetussa hostingissa ensimmäisen erän käynnistyminen voi kestää muutaman minuutin. |
| Indeksointi pysähtyy kesken | Lue viimeisin virhe tilalohkosta. Tarjoajan nopeusrajoitukset ja kiintiövirheet ovat tavallisin syy; indeksointi jatkuu seuraavalla ajoitetulla ajolla. |
| Hakutulokset ovat hitaita erittäin suurella työpöydällä | Avainsanatila tarkistaa jokaisen hakukanan viestin tekstiä vasten, mikä on raskaampaa kuin ytimen yhden lauseen haku. Pidä haut muutamassa sanassa tai vähennä indeksointiin sisältyviä postilaatikoita. |
| Samankaltaisten keskustelujen paneeli on tyhjä | Keskustelua ei ole vielä indeksoitu tai paneeli on pois päältä asetuksissa. Uudet keskustelut indeksoidaan muutaman minuutin kuluessa. |
Tietosuoja ja tietojen käsittely
Avainsanahaku toimii kokonaan FreeScout-tietokannassasi eikä lähetä mitään minnekään. Kun haku merkityksen perusteella on päällä, jokaisen indeksoidun keskustelun teksti (aihe, asiakasviestit, asiantuntijavastaukset ja sisäiset muistiinpanot, jos ne sisällytetään) lähetetään määrittämällesi palveluntarjoajalle. Julkinen päätepiste käyttää HTTPS:ää; yksityinen HTTP-päätepiste pysyy määrittämässäsi verkossa. Avain on valinnainen yhteensopivalle päätepisteelle. Vain palautettu sormenjälki tallennetaan.
Ainoa yhteydenotto replyrabbit.app-sivustoon on lisenssin tarkistus, joka lähettää lisenssiavaimen, FreeScout-sivuston URL-osoitteen ja moduulin version. Keskustelutekstiä, hakusanoja tai asiakastietoja ei lähetetä meille.
Jos keskustelutekstin on pysyttävä omilla palvelimillasi, käytä paikallista tarjoajaa tai yhteensopivaa päätepistettä luotetussa yksityisverkossasi tai pysy avainsanatilassa. Yhteensopivan julkisen päätepisteen kanssa teksti kulkee HTTPS:n yli. Yksityiset HTTP-päätepisteet ovat sallittuja vain luotetussa verkossa.
UKK
Tarvitsenko ReplyRabbitin käyttääkseni Semantic Searchia?
Ei. Semantic Search on erillinen FreeScout-moduuli samoilta tekijöiltä. Se asentuu ja toimii itsenäisesti. ReplyRabbit on vain paikka, josta ostat sen, lataat sen ja hallinnoit lisenssiavainta.
Toimiiko Semantic Search ilman AI-avainta?
Kyllä. Avainsanatila on käytössä heti, kun aktivoit moduulin, ilman avainta ja asetuksia. Jokaisen haun sanan on esiinnyttävä jossakin keskustelussa: aiheessa, asiakkaan nimessä, sähköpostiosoitteessa tai viestin tekstissä. AI-avain lisää vain merkitykseen perustuvan haun ja samankaltaisten keskustelujen paneelin.
Mitä AI-palveluntarjoajia voin käyttää?
OpenAI (oletuksena text-embedding-3-small), Google Gemini (oletuksena gemini-embedding-001) tai mikä tahansa OpenAI-yhteensopiva palvelu kuten OpenRouter, Ollama tai LM Studio, johon syötät perus-URL:n ja mallin itse. Z.AI ei ole tuettu, koska sillä ei ole embeddings-palvelua.
Paljonko tekoälyavain maksaa?
Kun OpenAI text-embedding-3-small maksaa 0,02 USD miljoonaa tokenia kohden, noin 100 keskustelun indeksointi maksaa suunnilleen 0,01 USD. 10 000 keskustelun työpöytä maksaa noin 1 USD kaiken indeksoimisesta kerran ja sen jälkeen muutaman sentin kuukaudessa uudesta postista. Asetussivu näyttää arvion ennen ensimmäisen indeksin suorittamista.
Missä hakudata säilytetään?
Kahdessa taulukossa olemassa olevassa FreeScout-tietokannassasi. Jokainen indeksoitu keskustelu lisää noin puoli kilotavua. Erillistä hakupalvelinta ei tarvita, eikä mitään tallenneta replyrabbit.app-sivustolle.
Toimiiko se PostgreSQL:ssä?
Kyllä. Avainsanahaku ja merkitykseen perustuva haku toimivat sekä MySQL:ssä, MariaDB:ssä että PostgreSQL:ssä.
Mitä tapahtuu, jos avaimeni lakkaa toimimasta tai lisenssi raukeaa?
Haku palaa automaattisesti avainsanatilaan, jotta agentit saavat edelleen tuloksia. Asetussivu näyttää syyn. Avainsanahaku ei koskaan riipu lisenssistä tai avaimesta.