PushizoDocs

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

  1. Sayfalarınız dizine alınır: site haritanız taranır ya da belgeleri API ile yüklersiniz.
  2. Ziyaretçi yazarken arama Postgres tam metin dizininde yapılır (sözcük kökleriyle; AI kullanılmaz, her zaman çalışır).
  3. 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.
  4. 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ı.

  1. 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.
  2. Ayarlar sekmesinden site aramasını açın; isterseniz AI yanıtını da açın.
  3. Dene sekmesinde ziyaretçinin göreceği sonuçları ve yanıtı kontrol edin.
  4. Sitenize ekleyin:
<button id="site-search-button">Ara</button>
<script>
  Pushizo.Search.attach('#site-search-button', { hotkey: true });
</script>
AyarAçı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 diliSö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ökenlerAramayı çağırabilecek siteler. Boşsa uygulamanın izinli kökenleri geçerlidir.
Sorgu saklama süresiRapor için sorgu kayıtlarının tutulduğu gün sayısı (7–365, varsayılan 90).

Kaynaklar ve tarama

  • Site haritası: sitemap.xml ya da site haritası dizini. Yalnız aynı sitedeki sayfalar taranır.
  • Adres listesi: en çok 500 adres.
  • Yalnız herkese açık https adresleri taranır; özel ağ adresleri reddedilir. Yönlendirme yalnız aynı siteye izlenir.
  • Tarayıcı kendini PushizoBot olarak tanıtır ve robots.txt kurallarına, noindex etiketine 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.
DurumAnlamı
Kuyrukta / TaranıyorTarama bekliyor ya da sürüyor.
GüncelTü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ızSite 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-searchAyarlar, dizin durumu, AI kullanımı
PATCH /v1/apps/{app}/site-search/settingsAyarları güncelle
GET/POST /v1/apps/{app}/site-search/sourcesKaynakları 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/documentsDizindeki belgeler
PUT/DELETE /v1/apps/{app}/site-search/documents/{anahtar}Belge yükle / sil
GET /v1/apps/{app}/site-search/reportArama raporu
POST /sdk/v1/apps/{app}/searchZiyaretçi araması (anahtarsız; Web SDK kullanır)

Okuma uçları analytics:read, yönetim uçları admin kapsamı ister.

Bu sayfada