RAQSSSS
Sıkça sorulan sorular
RAQS, herhangi bir web sitesine tek satır kodla eklenen sesli bir yapay zeka asistanıdır — ziyaretçi mikrofona dokunup konuşur, asistan sorusunu sitenizin kendi içeriğinden yanıtlar. Bu sayfada kurulumdan diller, maliyet, güvenlik, bilgi tabanı taraması, maskotlar ve ajan aksiyonlarına kadar en çok sorulan soruları tema tema topladık. Aradığınız yanıtı bulamazsanız aşağıdaki uzun SSS listesine de göz atın.
Kurulum ve başlangıç
RAQS'ı canlıya almak için sunucu kurmanıza, kod yazmanıza veya geliştirici beklemenize gerek yok. Panelden sitenizi eklersiniz, size özel bir site anahtarı verilir ve tek bir <script> satırını sitenizin HTML'ine yapıştırırsınız. Asistan asenkron yüklenir; sayfanızın açılış hızını yavaşlatmaz çünkü ağır işlem (konuşma tanıma, dil modeli, arama) tamamen bulutta çalışır.
Kurulumdan sonra yapılacak tek anlamlı iş bilgi tabanını beslemektir: sitenizi taratır, metin/SSS yapıştırır veya dosya yüklersiniz. Bilgi tabanı hazır olduğunda asistan sorulara sitenizin gerçek içeriğinden yanıt vermeye başlar. Bütün bu adımlar genellikle dakikalar sürer.
Tek satır kod
Site anahtarınızı içeren <script> satırını yapıştırın.
Sunucu yok
Yönetilen bulut; ağır işlem tamamen sunucu tarafında.
Hızlı yükleme
Asenkron yüklenir; sayfa açılışını yavaşlatmaz.
<script async src="https://raqs.ai/v1/raqs.js"
data-raqs="SİTE_ANAHTARINIZ"></script>Diller ve ses
RAQS şu an Türkçe ve İngilizce'yi destekler. Ziyaretçi orb'a (veya 3D maskota) dokunur, doğal dilde konuşur ve anında sesli yanıt alır — yazmaya gerek yoktur. Tarayıcının Web Speech API'siyle uyandırma kelimesi yakalanır, ses düşük gecikmeli bir gerçek-zaman katmanı üzerinden taşınır; konuşmayı metne çevirme ve seslendirme Azure Speech ile yapılır, dil modeli (beyin) ise Azure OpenAI üzerinde çalışır.
Asistanın sesi, tonu, persona'sı ve adı panelden ayarlanabilir; markanıza uygun bir kişilik tanımlayabilirsiniz. Asistan konuşurken araya girip (barge-in) yeni bir şey sorabilir, doğal duraklamalarla akıcı bir diyalog kurabilirsiniz.
Türkçe + İngilizce
İki dilde doğal konuşma desteği.
Ayarlanabilir ses
Ses, ton, persona ve asistan adı panelden seçilir.
Barge-in
Asistan konuşurken araya girebilirsiniz.
Maliyet ve ücretlendirme
RAQS yönetilen (hosted) bir bulut hizmetidir ve kullandıkça öde (pay-as-you-go) mantığıyla çalışır: bir taban plan üzerine kullanım bazlı bir maliyet eklenir. Yani küçük başlayıp ihtiyaca göre büyüyebilirsiniz. Başlamadan önce denemeniz için ücretsiz deneme sunulur ve başlangıçta kredi kartı gerekmez.
Taban plan, tarayabileceğiniz sayfa kotası gibi sınırları belirler; kullanım ise asistanın yaptığı konuşma ve işlem hacmine göre ölçeklenir. Bu model özellikle yeni başlayan siteler için risksizdir çünkü trafik düşükken maliyet de düşük kalır.
Kullandıkça öde
Taban plan + kullanım bazlı maliyet.
Ücretsiz deneme
Başlangıçta kredi kartı gerekmez.
Yönetilen bulut
Altyapıyı biz işletiriz; bakım yükü sizde değil.
Güvenlik, gizlilik ve uyumluluk
RAQS çok kiracılı (multi-tenant) bir mimaridir ve her müşterinin verisi satır düzeyi güvenlik (RLS) ile birbirinden izole edilir; bir müşterinin bilgi tabanı başka bir müşteriye asla görünmez. Asistan yalnızca panelde izin verdiğiniz domainlerde (origin allowlist) çalışır ve kötüye kullanıma karşı Cloudflare Turnstile ile korunur.
Sitenizi tarayan crawler SSRF saldırılarına karşı korumalıdır ve robots.txt kurallarına uyar. Altyapı Azure'ın AB bölgesinde barınır ve hizmet KVKK ile GDPR'ı gözeterek tasarlanmıştır. Yani kişisel veri ve veri yerleşimi konusundaki yükümlülüklerinize uygun bir zeminde çalışırsınız.
RLS izolasyon
Her kiracının verisi satır düzeyinde ayrı.
Origin allowlist
Yalnızca izin verdiğiniz domainlerde çalışır.
SSRF korumalı tarama
robots.txt'e uyar; iç ağ adreslerini engeller.
AB bölgesi
Azure AB barındırma; KVKK + GDPR farkındalığı.
Bilgi tabanı ve tarama (RAG)
RAQS uydurmaz; yalnızca sizin verdiğiniz bilgi tabanından yanıt verir. Bilgi tabanını üç şekilde besleyebilirsiniz: sitenizi taratarak (sitemap + sayfalar; JavaScript ile render edilen SPA siteler başlıksız kalmasın diye headless tarayıcıyla işlenir, içerik trafilatura ile temiz biçimde çıkarılır), düz metin/SSS yapıştırarak veya dosya (PDF, Word, TXT, MD, CSV) yükleyerek.
İçerik parçalara ayrılır, Azure embeddings (text-embedding-3-small) ile vektöre çevrilir ve pgvector'da saklanır. Sorgu anında hibrit arama çalışır: anlamsal vektör araması + Postgres tam-metin anahtar kelime araması RRF füzyonuyla birleştirilir ve bir benzerlik eşiğiyle alakasız sonuçlar elenir. İçerikte cevap yoksa asistan dürüstçe 'bilmiyorum' der — bu, halüsinasyonu engelleyen en önemli tasarım kararıdır.
Üç besleme yolu
Site tarama, metin/SSS yapıştırma veya dosya yükleme.
Headless render
JS ile gelen SPA içeriği için tarayıcı tabanlı render.
Hibrit retrieval
Vektör + anahtar kelime + RRF füzyon + eşik.
Ürün verisi
schema.org JSON-LD'den isim/marka/fiyat/stok/kategori.
Maskotlar ve ajan aksiyonları
Klasik orb yerine sayfada gezinen bir 3D maskot seçebilirsiniz: amiral gemisi geyik, evrensel 'Spark' kıvılcımı, stilize karakterler ve 30'dan fazla hayvan. Maskot, sayfanın gerçek DOM elemanlarını bir zemin gibi görür; koşar, zıplar ve ziyaretçiyi doğru hedefe götürür. Maskot panelden tek tıkla seçilir.
RAQS yalnızca cevap vermez, sayfada iş de yapar. Sayfayı 'görür', ziyaretçiyi doğru ürüne/sayfaya yönlendirir, listeden bir öğeyi gösterir veya sepete ekleme gibi eylemleri tetikler. Hassas işlemler (ödeme, hesap işlemleri, silme) her zaman ziyaretçinin açık onayını gerektirir — bu akıllı güvenlik katmanı yanlışlıkla yapılan kritik işlemleri engeller.
3D maskot havuzu
Geyik, Spark, karakterler ve 30+ hayvan.
DOM zemin
Maskot sayfanın gerçek elemanlarını zemin olarak kullanır.
Yönlendirme + eylem
Doğru sayfaya götürme, sepete ekleme vb.
Onay kalkanı
Ödeme/hesap/silme için açık kullanıcı onayı.
Sık sorulan sorular
RAQS'ı sitemde nasıl kurarım?
Panelden sitenizi ekleyip size özel site anahtarını alırsınız, ardından tek bir <script> satırını sitenizin HTML'ine yapıştırırsınız. Sunucu kurmaya veya kod yazmaya gerek yoktur; asistan asenkron yüklenir ve dakikalar içinde canlı olur.
Kurulum gerçekten ne kadar sürer?
Script satırını yapıştırmak birkaç dakikalık iştir. Asıl zamanı bilgi tabanını hazırlamak alır: sitenizi taratmak, metin yapıştırmak veya dosya yüklemek. Çoğu sitede tüm süreç toplamda dakikalarla ölçülür.
RAQS hangi dilleri destekliyor?
Şu an Türkçe ve İngilizce destekleniyor. Asistanın sesi, tonu, persona'sı ve adı panelden markanıza uygun şekilde ayarlanabilir.
Asistanın sesini ve kişiliğini değiştirebilir miyim?
Evet. Ses, ton, persona ve asistan adı panelden seçilir; böylece asistan markanızın kimliğine uygun bir karakterle konuşur.
RAQS yanlış veya uydurma cevap verir mi?
Hayır. RAQS yalnızca sizin bilgi tabanınızdan yanıt verir; içerikte bir bilgi yoksa dürüstçe 'bilmiyorum' der. Bu, halüsinasyonu engelleyen temel tasarım kararıdır.
Bilgi tabanını nasıl beslerim?
Üç yol var: sitenizi taratmak (sitemap + sayfalar, SPA'lar için headless render), düz metin/SSS yapıştırmak veya dosya (PDF, Word, TXT, MD, CSV) yüklemek. İçerik parçalanır, vektöre çevrilir ve aramada kullanılır.
JavaScript ile çalışan (SPA) sitemi tarayabilir mi?
Evet. JavaScript ile render edilen sayfalar headless tarayıcıyla işlenir, böylece içerik boş kalmaz. Metin trafilatura ile temiz biçimde çıkarılır ve robots.txt kurallarına uyulur.
E-ticaret sitesinde ürün fiyatı ve stok durumu sorulabilir mi?
Evet. Ürün sayfalarındaki schema.org JSON-LD verisi (isim, marka, fiyat, stok, kategori) ayrıca çıkarılır; böylece 'X ürünü var mı, kaç para?' gibi sorular doğru biçimde yanıtlanır.
RAQS ne kadara mal olur?
Kullandıkça öde modeli geçerlidir: bir taban plan üzerine kullanım bazlı maliyet eklenir. Başlamadan önce ücretsiz deneme sunulur ve başlangıçta kredi kartı gerekmez.
Verilerim güvende mi ve KVKK'ya uygun mu?
Çok kiracılı mimaride her müşterinin verisi satır düzeyi güvenlik (RLS) ile izole edilir. Asistan yalnızca izin verdiğiniz domainlerde çalışır, Cloudflare Turnstile ile korunur ve altyapı Azure'ın AB bölgesinde barınır; hizmet KVKK ve GDPR gözetilerek tasarlanmıştır.
Asistanı sadece kendi sitemde mi çalıştırabilirim?
Evet. Panelden bir origin allowlist tanımlarsınız; asistan yalnızca izin verdiğiniz domainlerde yüklenir. Bu, site anahtarınızın başka yerlerde kötüye kullanılmasını engeller.
3D maskot nedir ve nasıl seçilir?
Klasik orb yerine sayfada gezinen bir 3D karakter seçebilirsiniz: amiral gemisi geyik, evrensel Spark, stilize karakterler ve 30'dan fazla hayvan. Maskot sayfanın gerçek elemanlarını zemin olarak kullanır ve panelden tek tıkla seçilir.
Asistan sadece cevap mı verir, yoksa işlem de yapabilir mi?
RAQS sayfayı görür ve iş de yapar: ziyaretçiyi doğru ürüne/sayfaya yönlendirir, bir öğeyi gösterir veya sepete ekleme gibi eylemleri tetikler. Ödeme, hesap ve silme gibi hassas işlemler her zaman açık kullanıcı onayı gerektirir.
Birden fazla site ekleyebilir miyim?
Evet. Panelden birden çok site ekleyip her biri için ayrı bilgi tabanı, izinli domainler, maskot ve persona yönetebilirsiniz. Konuşmaları ve analitiği de aynı panelden incelersiniz.
Başka bir sorunuz mu var?
Ücretsiz deneyin; tek satır kodla dakikalar içinde sitenizi konuşturun.
Ücretsiz başla