FreeScout için Semantic Search
Semantic Search, çok kelimeli aramayı düzelten ve kendi AI anahtarınızı ekledikten sonra konuşmaları ne hakkında olduklarına göre bulan bağımsız bir FreeScout modülüdür. ReplyRabbit'in yapımcıları tarafından satılır ancak ReplyRabbit kurulu olmasını gerektirmez.
Genel bakışı mı arıyorsunuz?
Genel bakış
FreeScout'un yerleşik araması, tüm sorgunuzu tek bir alanda tek bir ifade olarak arar. Şöyle bir arama frank invoice hiçbir şey bulmaz, çünkü müşteri adı bir yerde ve "fatura" kelimesi başka bir yerdedir. Semantic Search bu davranışı iki aşamada değiştirir:
- Anahtar kelime modu (anahtar gerekmez): aramanızdaki her kelime konuşmanın bir yerinde görünmelidir. Konu, müşteri adı, e-posta adresi ve mesaj metni hesaba katılır. Modül etkinleştirildiği anda bu açıktır.
- Anlama göre ara (kendi AI anahtarınız): her konuşma, ne hakkında olduğuna dair kompakt bir parmak izi alır ve bu FreeScout veritabanınızda saklanır. Arama, anlam ve anahtar kelimeler üzerinde eşleştirilir ve iki liste en iyi yanıtın önce gelmesi için harmanlanır. Bu mod ayrıca şunu da destekler: Benzer konuşmalar konuşma kenar çubuğundaki panel.
Arama sayfası küçük bir Anlamsal veya Anahtar kelime sonuç sayısının yanındaki etiket, böylece ajanlar hangi modun yanıtladığını bilir.
Arama sözdizimi
Her iki modda da olağan arama motoru kısaltmaları çalışır:
| Şunu yazarsınız: | Ne yapar |
|---|---|
frank invoice | Her iki kelime de konuşmanın bir yerinde görünmelidir. |
"out of stock" | Tam ifade görünmelidir. |
-refund veya -"out of stock" | Kelimeyi veya ifadeyi içeren konuşmalar hariç tutulur. |
cart OR basket | Her iki kelime de yeterli. OR büyük harfle olmalıdır. |
admin@example.com veya example.com | Bir e-posta adresi veya alan adı tam olarak eşleştirilir. |
Anlama göre arama yalnızca yazdığınız kelimelerle açıkça aynı şey hakkında olan konuşmaları ekler. Alıntılanan ifadeler, adresler ve -exclusions bu sonuçlara uygulanmaya devam eder, böylece bir e-posta adresi araması asla ilgisiz konuşmalarla dolmaz.
Arama çubuğu ve filtreler
Arama sonuçları sayfasında, arama kutusu hemen şunun yanında yer alır Konuşmalar ve Müşteriler sekmeler, böylece en üste geri kaydırmadan bir aramayı değiştirebilirsiniz. Sıralama açılır menüsü şunun sağında yer alır: Müşteriler sekmesi.

Açmak için arama kutusunun yanındaki kaydırıcılar düğmesine tıklayın Filtreler panel. Yukarıdaki kısa yolu hatırlamanıza gerek yok: dört kelime kuralı bunu sizin için arama kutusuna yazar.
| Filtre | Neleri yazar | Ne yapar |
|---|---|---|
| Bu kelimelerin tümü | frank invoice | Her kelime görünmelidir. |
| Bu tam ifade | "out of stock" | Kelimeler bu sırayla bir arada görünmelidir. |
| Bu kelimelerden herhangi biri | cart OR basket | Kelimelerden biri yeterli. |
| Bu kelimelerin hiçbiri | -refund | Kelimeyi içeren konuşmalar hariç tutulur. |

Standart FreeScout filtreleri (posta kutusu, durum, atanan, müşteri, tarihler ve daha fazlası) şurada bulunur: Gelişmiş paneldeki alt bölümde. Paneli kısa tutmak için katlanmıştır ve bu filtrelerden biri zaten kullanılıyorsa kendiliğinden açılır. Kaydırıcı düğmesindeki küçük bir sayı kaç filtrenin etkin olduğunu gösterir. Tıklayın Uygula aramayı çalıştırmak için veya Tümünü temizle yeniden başlamak için.

1.1.3 sürümünden itibaren, Müşteriler sekmesi her kelimeye ayrı ayrı da bakar. Her kelimeyle eşleşen müşteri yoksa, herhangi biriyle eşleşen müşterileri en yakın eşleşmeler önce olacak şekilde listeler, böylece invoice frank yine de Frank adında bir müşteri bulur.
Ön koşullar
Başlamadan önce şunlara sahip olduğunuzdan emin olun:
- PHP 8.1 veya üzerinde FreeScout 1.8.101 veya daha yenisi.
- Çalışan bir FreeScout kuyruk çalışanı ve zamanlayıcı (
php artisan queue:workveschedule:runcron). Dizin oluşturma bunlar üzerinde çalışır. - Şuradan bir Semantic Search lisansı ReplyRabbit hesabı. Satın alma e-postası lisans anahtarını içerir.
- İsteğe bağlı, anlama göre arama için: OpenAI veya Google Gemini'den bir API anahtarı ya da OpenRouter, Ollama veya LM Studio gibi uyumlu bir hizmetin temel URL'si ve gömme modeli adı.
Modülü kurun
ZIP'i indir
Şurada giriş yapın app.replyrabbit.app ödeme sırasında kullandığınız e-posta adresiyle ve şunu açın: Semantic Search kontrol panelindeki kart. İndirinsemantic-search.zip.Modules klasörüne kopyalayın
Sıkıştırmayı açsemantic-search.zipve şunu kopyalayın:SemanticSearchklasörünü şuraya kopyalayın:ModulesFreeScout kurulumunuzun dizinine, SFTP veya ana makinenizin dosya yöneticisi aracılığıyla, diğer modüllerin yanına. FreeScout'ta üçüncü taraf modüller için uygulama içi yükleme yoktur.Modülü etkinleştir
Etkinleştir Semantic Search Modüller listesinden. Etkinleştirme, iki dizin tablosunu oluşturan veritabanı geçişlerini çalıştırır.Bir arama deneyin
Bir müşteri adı ve bir konu arayın, örneğin bir ad ve "fatura". Sonuçlar artık her kelimeyi bir konuşmada göründüğü her yerde eşleştirir ve arama sayfası şunu gösterir Anahtar kelime etiket.
Anahtar kelime modu bu noktada ek kurulum olmadan çalışır. Aşağıdaki adımlar anlama göre aramayı ve benzer konuşmalar panelini açar.
Lisans anahtarını girin
Ayarlar sayfasını açın
FreeScout'ta şuraya gidin Yönet, ardından Ayarlar, ardından Semantic Search.Lisans anahtarını yapıştırın
Şurada Lisans bölümünde, satın alma e-postanızdaki anahtarı yapıştırın ve kaydedin. Durum gösterir Lisanslı son kontrol zamanıyla.
Lisans, FreeScout kurulumunun site URL'sine bağlıdır. FreeScout'u yeni bir alan adına taşırsanız iletişime geçin hey@replyrabbit.app ve sıfırlayacağız.
Anlama göre arama ayarlayın
Bir sağlayıcı seçin
Şurada Embedding sağlayıcı bölümünde, seçin OpenAI, Google, veya OpenAI uyumlu. Varsayılan model OpenAI ve Google için doldurulur. Uyumlu bir hizmet için temel URL'yi ve beklediği model adını girin.Anahtarı ekleyin ve test edin
Sağlayıcınız bir anahtar gerektiriyorsa API anahtarını yapıştırın, ardından şuna tıklayın Gömme vektörlerini test et. Test, gömme uç noktasına kısa bir cümle gönderir ve yanıtını kontrol eder. Anahtarlar şifrelenmiş olarak saklanır ve kaydettikten sonra yalnızca maskelenmiş bir önizleme gösterilir.Dizinlenecek posta kutularını seçin
Şurada Dizinleniyor bölümünde, dahil edilecek posta kutularını işaretleyin. Dahili notları dahil et varsayılan olarak açıktır, çünkü ajanlar sıklıkla kendi notlarında arama yapar. Şunu ayarlayın: Geri doldurma günleri ne kadar geriye dizinleneceğine (varsayılan 365 gündür).Anlama göre aramayı açın
İşaretle Anlama göre ara ve kaydedin. Sağlayıcı, model veya temel URL değiştiyse sayfa size konuşmaların arka planda yeniden dizinleneceğini söyler.İlk dizini başlatın
Tıklayın Şimdi dizinle. Durum bloğu "8.900 konuşmanın 1.240'ı indekslendi (%14)" gibi ilerlemeyi, son çalıştırma zamanını, varsa son hatayı ve tahmini kalan maliyeti gösterir. İndeksleme her beş dakikada yaklaşık 200 konuşmalık gruplar halinde çalışır, bu yüzden büyük bir masa birkaç saat sürer. Arama bu süre boyunca çalışmaya devam eder.
Hangi sağlayıcı?
Özel bir gömme uç noktası kullanın
Şu gibi bir API temel URL'si girin https://embeddings.example.com/v1 veya http://10.0.0.25:8001/v1, ardından orada sunulan tam gömme modeli kimliği. Semantic Search şunu ekler: /embeddings temel URL'ye. Genel adresler HTTPS gerektirir. Özel veya geri döngü HTTP adresi, FreeScout'un erişebildiği güvenilir bir ağda olmalıdır.
Bir ağ geçidi hem sohbet hem de gömme hizmeti sunuyorsa, aynı değeri girebilirsiniz /v1 temel URL'yi burada ve şurada: ReplyRabbit'in özel sağlayıcı ayarları. Gömme modelini burada ve sohbet modelini ReplyRabbit'te yapılandırın. Sohbet ve gömme sunucularınızın ayrı URL'leri varsa, her URL'yi kendi ürününe girin. Ürünler token'ları veya ayarları paylaşmaz.
The Gömme vektörlerini test et eylem bir gömme vektörü döndürmelidir. Yalnızca yanıt veren bir sohbet modeli /chat/completions anlama göre aramayı güçlendiremez. Uç noktayı veya modeli değiştirmek yeni bir dizin profili başlatır; yalnızca token'ı değiştirmek mevcut vektörleri korur.


Güncel tutmak
Yeni bir sürüm yayınlandığında, FreeScout bunu şurada gösterir Yönet, ardından Modüller, ve Şimdi Güncelle yerinde yükler: SFTP yok, yeniden yükleme yok. Panonuzdan indirdiğiniz ZIP kendi lisansınızın indirme bağlantısını taşır, böylece güncelleme ilk indirmeyle aynı lisans kontrolünün arkasından alınır.
Bilinmesi gereken iki şey:
- Güncelleme yalnızca kontrol panelinizden indirilen bir kopya için çalışır ve kopyanızı başkasına vermemelisiniz: güncelleme bağlantısı kendi lisansınızın indirme anahtarını içerir, bu nedenle ZIP'i elinde tutan herkes lisansınız üzerinden güncelleme alabilir. Başkasından alınan bir kopya onların lisansına bağlıdır ve onların anahtarıyla güncellenir.
- FreeScout bir indirme hatası bildirirse, kontrol panelinizden yeni ZIP dosyasını indirin ve yukarıdaki kurulum adımlarında olduğu gibi klasörü elle değiştirin. Dizin ve ayarlarınız korunur: bunlar modül klasöründe değil, veritabanında bulunur.
Maliyet
Dizinleme, her konuşmanın metnini sağlayıcınıza bir kez gönderir, ayrıca konuşma yeni bir yanıt aldığında tekrar gönderir. Arama yalnızca arama kelimelerini gönderir.
| Sağlayıcı | Model | Fiyat | Yaklaşık 100 konuşma |
|---|---|---|---|
| OpenAI | text-embedding-3-small | milyon token başına 0,02 USD | yaklaşık 0.01 USD |
| Google Gemini | gemini-embedding-001 | ücretsiz katman, ardından token başına fiyatlandırma | genellikle ücretsiz |
| Ollama veya LM Studio | herhangi bir gömme modeli | yok | yok |
Ayarlar sayfası, dizinlenmeyi bekleyen konuşmalar için bir tahmin gösterir, böylece tıklamadan önce sayıyı kontrol edebilirsiniz Şimdi dizinle. Yeniden indeksleme yalnızca sağlayıcıyı veya modeli değiştirdiğinizde ya da şuna tıkladığınızda gerçekleşir: Her şeyi yeniden dizinle.
Benzer konuşmalar paneli
Anlamla arama açıkken, bir Benzer konuşmalar paneli konuşma kenar çubuğunda görünür. Aynı posta kutusundaki aynı konuyla ilgili diğer konuşmaları konu, müşteri adı ve tarihle listeler. Temsilciler yalnızca zaten erişimi olan konuşmaları görür.
Paneli herkes için şununla kapatın: Benzer konuşmalar ayarlar sayfasında açın. Yeni bir konuşma, dizinlenene kadar "Henüz benzer bir şey yok" gösterir; bu birkaç dakika sürer.

Komut satırı
FreeScout'u SSH üzerinden yönetirken iki komut yardımcı olur:
php artisan semanticsearch:status
php artisan semanticsearch:reindex --limit=2000status ayarlar sayfasıyla aynı kapsam sayılarını yazdırır. reindex zamanlayıcıyı beklemek yerine hemen bir toplu iş çalıştırır, bu büyük bir masada ilk dizin için kullanışlıdır.
Sorun giderme
| Belirti | Neleri kontrol etmeli |
|---|---|
| Arama sayfası gösterir Anahtar kelime yerine Anlamsal | Onayla Anlama göre ara işaretliyse, lisans durumu şudur: Lisanslı, ve durum bloğu yakın zamanda bir hata göstermiyor. Anahtar başarısız olduysa, düzeltilene kadar arama anahtar kelime moduna geri döner. |
| Arama sayfasında hiçbir etiket görünmüyor | Arama, FreeScout'un kendi aramasına devredildi. Bu, yalnızca bir sayı olan aramalar (bilet veya sipariş numaraları) için olur ve çekirdek bunları zaten iyi işler. |
| Gömme vektörlerini test et başarısız olur | Anahtarda başta veya sonda boşluk olmadığını ve doğru sağlayıcıya ait olduğunu kontrol edin. Uyumlu bir hizmet için temel URL'nin FreeScout sunucusundan erişilebilir olduğunu ve gömme modeli adının hizmetin beklediğiyle tam olarak aynı olduğunu doğrulayın. |
| Durum "Henüz dizinlenmiş bir şey yok" diyor | Kuyruk çalışanının ve zamanlayıcı cron'un çalıştığından emin olun. Tıklayın Şimdi dizinle ve bir dakika sonra yenileyin. Paylaşımlı barındırmada ilk toplu işlemin başlaması birkaç dakika sürebilir. |
| Dizinleme yarıda duruyor | Durum bloğundaki son hatayı okuyun. Sağlayıcıdan gelen hız limitleri ve kota hataları genellikle nedendir; dizinleme bir sonraki planlanmış çalıştırmada devam eder. |
| Çok büyük bir masada arama sonuçları yavaş | Anahtar kelime modu her arama sözcüğünü ileti metnine göre denetler, bu da çekirdeğin tek ifade eşleşmesinden daha ağırdır. Aramaları birkaç sözcükle sınırlayın veya dizine eklemeye dahil edilen posta kutularını azaltın. |
| Benzer konuşmalar paneli boş | Konuşma henüz dizinlenmedi veya panel ayarlarda kapalı. Yeni konuşmalar birkaç dakika içinde dizinlenir. |
Gizlilik ve veri işleme
Anahtar kelime araması tamamen FreeScout veritabanınız içinde çalışır ve hiçbir yere bir şey göndermez. Anlama göre arama açıkken, dizine eklenen her konuşmanın metni (konu, müşteri iletileri, temsilci yanıtları ve dahil edilirse dahili notlar) yapılandırdığınız sağlayıcıya gönderilir. Genel bir uç nokta HTTPS kullanır; özel bir HTTP uç noktası yapılandırdığınız ağda kalır. Anahtar, uyumlu bir uç nokta için isteğe bağlıdır. Yalnızca döndürülen parmak izi saklanır.
replyrabbit.app ile tek iletişim, lisans anahtarını, FreeScout site URL'sini ve modül sürümünü gönderen lisans kontrolüdür. Bize hiçbir konuşma metni, arama sözcüğü veya müşteri verisi gönderilmez.
Konuşma metni kendi sunucularınızda kalması gerekiyorsa, yerel bir sağlayıcı veya güvenilir özel ağınızda uyumlu bir uç nokta kullanın ya da anahtar kelime modunda kalın. Uyumlu bir genel uç noktayla metin HTTPS üzerinden iletilir. Özel HTTP uç noktalarına yalnızca güvenilir bir ağda izin verilir.
SSS
Semantic Search kullanmak için ReplyRabbit'e ihtiyacım var mı?
Hayır. Semantic Search, aynı geliştiricilerden ayrı bir FreeScout modülüdür. Kendi başına kurulur ve çalışır. ReplyRabbit yalnızca onu satın aldığınız, indirdiğiniz ve lisans anahtarını yönettiğiniz yerdir.
Semantic Search bir AI anahtarı olmadan çalışır mı?
Evet. Anahtar kelime modu, modülü etkinleştirdiğiniz andan itibaren anahtar ve ayar gerektirmeden açıktır. Aramanızdaki her kelime konuşmanın bir yerinde, konuda, müşteri adında, e-posta adresinde veya mesaj metninde bulunmalıdır. AI anahtarı yalnızca anlama göre arama ve benzer konuşmalar panelini ekler.
Hangi AI sağlayıcılarını kullanabilirim?
OpenAI (varsayılan olarak text-embedding-3-small), Google Gemini (varsayılan olarak gemini-embedding-001) veya OpenRouter, Ollama ya da LM Studio gibi temel URL'yi ve modeli kendiniz girdiğiniz herhangi bir OpenAI uyumlu hizmet. Z.AI desteklenmez çünkü gömme hizmeti yoktur.
AI anahtarı ne kadar tutar?
Milyon token başına 0.02 USD olan OpenAI text-embedding-3-small ile yaklaşık 100 konuşmayı dizinlemek kabaca 0.01 USD tutar. 10.000 konuşması olan bir masa her şeyi bir kez dizinlemek için yaklaşık 1 USD öder, ardından yeni postalar için ayda birkaç sent. Ayarlar sayfası ilk dizin çalışmadan önce bir tahmin gösterir.
Arama verileri nerede saklanır?
Mevcut FreeScout veritabanınızdaki iki tabloda. Dizinlenen her konuşma yaklaşık yarım kilobayt ekler. Ayrı bir arama sunucusu gerekmez ve replyrabbit.app üzerinde hiçbir şey saklanmaz.
PostgreSQL üzerinde çalışıyor mu?
Evet. Anahtar kelime araması ve anlama göre arama MySQL, MariaDB ve PostgreSQL üzerinde çalışır.
Anahtarım çalışmayı durdurursa veya lisans sona ererse ne olur?
Arama kendi kendine anahtar kelime moduna döner, böylece ajanlar sonuç almaya devam eder. Ayarlar sayfası nedeni gösterir. Anahtar kelime araması asla lisansa veya anahtara bağlı değildir.