Site içi AI arama
Web sitenize gömülen arama kutusu: ziyaretçi sitenizin kendi içeriğinde arar, soru sorduğunda bulunan sayfalardan kaynak gösteren kısa bir yanıt alır. Growth ve üzeri planlarda kullanılır; AI yanıtı için organizasyonda…
Web sitenize gömülen arama kutusu: ziyaretçi sitenizin kendi içeriğinde arar, soru sorduğunda bulunan sayfalardan kaynak gösteren kısa bir yanıt alır. Growth ve üzeri planlarda kullanılır; AI yanıtı için organizasyonda AI asistanı açık olmalıdır (ADR-0093).
Nasıl çalışır
- Sayfalarınız dizine alınır: site haritanız taranır ya da belgeleri API ile yüklersiniz.
- Ziyaretçi yazarken arama Postgres tam metin dizininde yapılır (sözcük kökleriyle; AI kullanılmaz, her zaman çalışır).
- Ziyaretçi soru sorarsa (Enter ya da "Yapay zekâya sor") en iyi eşleşen bölümlerden kısa bir yanıt üretilir. Yanıt yalnız sitenizin içeriğine dayanır ve kaynak sayfaları gösterir; içerikte yanıt yoksa "bulunamadı" denir.
- AI yanıtı verilemezse (kapalı, kota ya da tavan doldu) arama sonuçları aynen gösterilir; ziyaretçi hata görmez.
Kurulum
Panel → Web büyüme araçları → Site araması.
- Kaynaklar sekmesinden site haritanızı (
https://www.example.com/sitemap.xml) ya da bir adres listesi ekleyin. İlk tarama birkaç dakika içinde tamamlanır. - Ayarlar sekmesinden site aramasını açın; isterseniz AI yanıtını da açın.
- Dene sekmesinde ziyaretçinin göreceği sonuçları ve yanıtı kontrol edin.
- Sitenize ekleyin:
<button id="site-search-button">Ara</button>
<script>
Pushizo.Search.attach('#site-search-button', { hotkey: true });
</script>| Ayar | Açıklama |
|---|---|
| Site araması | Kapalıyken arama ucu yanıt vermez (403). |
| AI yanıtı | Soru sorulduğunda kaynak gösteren yanıt. Kapalıyken yalnız sonuç listesi. |
| İçerik dili | Sözcük kökü eşleştirme dili. Değiştirince dizin yeniden hesaplanır, yeniden tarama gerekmez. |
| Aylık token tavanı | AI yanıtlarının bu uygulamada bir ayda harcayabileceği en çok token (varsayılan 500.000). |
| İzinli kökenler | Aramayı çağırabilecek siteler. Boşsa uygulamanın izinli kökenleri geçerlidir. |
| Sorgu saklama süresi | Rapor için sorgu kayıtlarının tutulduğu gün sayısı (7–365, varsayılan 90). |
Kaynaklar ve tarama
- Site haritası:
sitemap.xmlya da site haritası dizini. Yalnız aynı sitedeki sayfalar taranır. - Adres listesi: en çok 500 adres.
- Yalnız herkese açık
httpsadresleri taranır; özel ağ adresleri reddedilir. Yönlendirme yalnız aynı siteye izlenir. - Tarayıcı kendini
PushizoBotolarak tanıtır verobots.txtkurallarına,noindexetiketine uyar:
User-agent: PushizoBot
Disallow: /hesap/
Disallow: /sepet- Menü, üst ve alt bilgi dizine girmez; sayfada
<main>ya da<article>varsa yalnız o bölüm okunur. - Sayfalar belirlediğiniz aralıkla (1–720 saat) yeniden taranır. Değişmeyen sayfa yeniden yazılmaz, sitede kalmayan sayfa dizinden silinir, geçici hata veren sayfanın önceki sürümü korunur.
- Sınırlar: kaynak başına en çok 2000 sayfa, sayfa başına 4 MB, uygulama başına 10.000 belge.
| Durum | Anlamı |
|---|---|
| Kuyrukta / Taranıyor | Tarama bekliyor ya da sürüyor. |
| Güncel | Tüm sayfalar dizine alındı. |
| Kısmen tarandı | Bazı sayfalar alınamadı; hata kodu kaynakta görünür (ör. http_404, timeout). |
| Başarısız | Site haritası okunamadı ya da hiçbir sayfa alınamadı (ör. sitemap_http_500, robots_unreachable). |
Belgeleri API ile yükleme
Taranamayan içerikleri (giriş arkasındaki yardım yazıları, ürün verisi) API ile yükleyin. Anahtar uygulama içinde tekildir; aynı anahtarla yeniden yükleme belgeyi değiştirir.
curl -X PUT "https://api.pushizo.com/v1/apps/$APP_ID/site-search/documents/kargo" \
-H "Authorization: Bearer $PUSHIZO_API_KEY" -H "Content-Type: application/json" \
-d '{
"url": "https://www.example.com/kargo",
"title": "Kargo ve teslimat",
"content": "# Kargo ücreti\n500 TL üzeri siparişlerde kargo ücretsizdir.\n# Teslimat süresi\nSiparişler 2 iş günü içinde kargoya verilir."
}'content (düz metin; #, ##, ### satırları bölüm başlığıdır) ya da html alanlarından biri verilir. Silmek için
DELETE /v1/apps/{app}/site-search/documents/{anahtar}.
Arama penceresi ve başsız kullanım
Hazır pencere ayrı bir paket olarak ilk açılışta yüklenir; klavye ile kullanılabilir (ok tuşları, Enter, Esc), sağdan sola dilleri ve 22 dili destekler.
// Hazır pencere
await Pushizo.Search.open({ placeholder: 'Ürün, kargo, iade…', theme: 'auto', color: '#2563eb' });
// Kendi arayüzünüz
const res = await Pushizo.Search.query('kargo ücreti ne kadar', { mode: 'answer', limit: 5 });
res.results; // [{ id, url, title, heading, snippet, snippet_html }]
res.answer; // { text, sources: [{ id, url, title }] } ya da null
res.answer_status; // 'answered' | 'not_found' | null
await Pushizo.Search.trackClick(res.query_id, res.results[0].url, 1);Ayrıntılar: Web SDK → Site içi arama.
Maliyet ve güvenlik
- Hız sınırı: IP başına dakikada 120 arama ve 10 AI yanıtı; uygulama başına dakikada 12.000 arama.
- Token tavanı: uygulamanın aylık tavanı dolunca yalnız arama sonuçları döner. Organizasyonun AI kotası ve plan kredisi ayrıca geçerlidir.
- Köken listesi: liste tanımlıysa yalnız o sitelerden gelen istekler yanıtlanır.
- Yanıt sınırları: model yalnız bulunan bölümleri görür, başka kiracının içeriği hiçbir zaman isteme girmez. Yanıt yasaklı ifade listesinden geçer; eşleşirse gösterilmez.
- Yazarken yalnız arama yapılır; AI yanıtı yalnız ziyaretçi isteyince üretilir.
Rapor ve kişisel veri
Rapor sekmesi son 30 günün arama sayısını, sonuçsuz aramaları, tıklama oranını, AI yanıt sayılarını, en çok aranan ve sonuçsuz sorguları gösterir. Sonuçsuz sorgular eksik içeriği bulmanın en hızlı yoludur.
- Sorgu metni kayıttan ve modele gitmeden önce maskelenir: e-posta, telefon, IBAN ve 6 haneden uzun sayılar yer tutucuyla değiştirilir.
- Ziyaretçi kimliği, abonelik ve IP adresi saklanmaz; sorgu kayıtları kişiyle ilişkilendirilemez.
- Kayıtlar saklama süresi dolunca silinir; "Verileri temizle" işlemi de sorgu kayıtlarını siler.
API özeti
| Uç | Açıklama |
|---|---|
GET /v1/apps/{app}/site-search | Ayarlar, dizin durumu, AI kullanımı |
PATCH /v1/apps/{app}/site-search/settings | Ayarları güncelle |
GET/POST /v1/apps/{app}/site-search/sources | Kaynakları listele / ekle |
PATCH/DELETE /v1/apps/{app}/site-search/sources/{id} | Kaynağı düzenle / sil |
POST /v1/apps/{app}/site-search/sources/{id}/crawl | Şimdi yeniden tara |
GET /v1/apps/{app}/site-search/documents | Dizindeki belgeler |
PUT/DELETE /v1/apps/{app}/site-search/documents/{anahtar} | Belge yükle / sil |
GET /v1/apps/{app}/site-search/report | Arama raporu |
POST /sdk/v1/apps/{app}/search | Ziyaretçi araması (anahtarsız; Web SDK kullanır) |
Okuma uçları analytics:read, yönetim uçları admin kapsamı ister.