Yapay zekâ ile arama
Yapay zekâ ile arama, gündelik sözcüklerle yazılmış sorguyu anlar: “100 euroya kadar su geçirmez koşu ayakkabısı, yalnız Contoso olmasın”, “koşucuya hediye”, “15 inç dizüstü bilgisayar çantası”. Yapay zekâ sorguyu katalog filtrelerine dönüştürür (kategoriler, markalar, özellikler, fiyat ve hariç tutulanlar), ürün arama da ürünleri bu filtrelere göre gösterir. Ürünlerin üstünde kısa bir yapay zekâ önerisi ve daraltma çipleri yer alır: “daha ucuz”, “kadın”, “başka renk”. Normal sonuçlar her zamanki gibi hemen görünür, çözümleme hazır olduğunda yapay zekâ sonuçları onların yerini alır. Yapay zekâ yanıt vermezse normal sonuçlar kalır.
Yapay zekâ ile arama, ürün aramanın bir parçasıdır: izleyici, katalog ve arama widget’ı ya da bir mağaza eklentisi gerekir. Yapay zekâ, proje bakiyesinden kullandıkça ücretlendirilir ve ücretli tarifede çalışır, bkz. Ödeme ve sınırlar.
Nasıl açılır
Web sitesi → Ürün arama sayfasındaki Yapay zekâ ile arama bloğunda Yapay zekâ ne zaman çalışsın seçimini yapın. Seçim hemen kaydedilir.

| Mod | Yapay zekâ sorguyu ne zaman çözümler |
|---|---|
| Kapalı | hiçbir zaman: arama her zamanki gibi çalışır |
| Otomatik | açıklayıcı bir sorguda: üç sözcük ve üzeri ya da bir soru; kısa sorgular (“spor ayakkabı”, “nike”) her zamanki gibi aranır |
| Anahtar | yalnızca müşteri “Yapay zekâya sorun” düğmesine bastığında |
| Her zaman | her sorguda |
Otomatik ve Anahtar modlarında ziyaretçinin Yapay zekâya sorun düğmesi vardır: sonuçların sıralamasının yanında ve öneri katmanında bir satır olarak. Bu düğmeyle yapay zekâ kısa bir sorguyu da çözümler.
- Ürünlerin üstünde kısa yapay zekâ yanıtı: bulunan ürünler hakkında bir iki cümle; en uygun olan ve fiyat aralığı. Yalnızca filtreler gerekiyorsa kapatın.
- Yapay zekânın faydasını ölçün: ziyaretçilerin yarısı normal arama alır ve rapor iki grubun tıklamalarını ve satın almalarını karşılaştırır, bkz. Yapay zekânın faydasını ölçme.
Çözümlemeyi kontrol etme
Çözümlemeyi kontrol et alanı, yapay zekânın sorgudan ne anladığını gösterir: aranacak metin, kategoriler, markalar, özellikler, fiyat, hariç tutulanlar, sıralama ve daraltmalar. Sorguyu bir müşterinin yazacağı gibi girin ve Çözümle düğmesine basın. Çözümleme sitedeki gibi ücretlendirilir; aynı sorgunun tekrar çözümlemesi önbellekten ücretsiz gelir ve sonucun altında “Önbellekten — model çağrısı yok” yazar.
Yapay zekâ sorguda katalogdan hiçbir şey bulamazsa arama metne göre yapılır; alanın altında da bu yazar. Bu, kataloğa müşterilerin aradığı kategorileri veya özellikleri eklemek için bir işarettir.
Müşteri ne görür
- Müşteri bir sorgu girer; normal sonuçlar hemen görünür.
- Ürünlerin üstünde “Yapay zekâ ürün seçiyor…” yazar. Bir iki saniye sonra yapay zekâ sonuçları normal sonuçların yerini alır.
- Yapay zekânın yanıtı, “Yapay zekâ önerisi” başlığı altında model yanıt verdikçe yazılır.
- Yapay zekânın anladığı: çipleri uygulanan filtreleri gösterir: kategori, markalar, özellikler, fiyat ve “−” işaretli hariç tutulanlar. Bir çip kaldırılabilir; sonuçlar model çağrısı olmadan hemen güncellenir.
- Daraltmalar: çipler ve “Daraltın: daha ucuz, başka renk…” alanı. Daraltma önceki sorguyu sürdürür: “Northwind koşu ayakkabısı” sorgusundan sonra “daha ucuz”, markayı korur ve fiyatı düşürür.
- Sohbette sorun, sohbet bağlıysa müşterinin sorgusuyla web sitesi sohbetini açar.
- Normal arama, sorgu değişene kadar normal sonuçlara döner.
Katalogda istenen şey yoksa yapay zekâ filtreleri gevşetir: önce özellikleri ve hariç tutulanları, sonra fiyatı kaldırır, ardından ilk metne göre arar. Bu durumda ürünlerin üstünde “Tam eşleşme yok — benzer ürünler gösteriliyor.” yazar.
Ziyaretçi sonuçlarda filtreleri veya sıralamayı kendisi seçtiyse yapay zekâ bu seçimi değiştirmez: seçilen sıralama yapay zekâ sonuçlarına uygulanır, ziyaretçinin kendi filtreleri ise normal sonuçlara döndürür.
Yapay zekâ sorguyu nasıl çözümler
- Yalnızca katalog. Yapay zekâ kataloğunuzdaki kategorileri, markaları ve özellik değerlerini alır ve bunlar arasından seçer. Katalogda olmayan her şey atılır: yapay zekâ marka veya beden uydurmaz.
- Dil. Sorgu herhangi bir dilde yazılabilir: yapay zekâ aranacak metni kataloğun diline çevirir, daraltmaları ise müşterinin dilinde yazar.
- Önbellek. Sorgunun çözümlemesi 7 gün saklanır: aynı dildeki aynı sorgu modelsiz ve ücretsiz çözümlenir. Her gece web sitesinin son 30 gündeki popüler aramaları önceden çözümlenir (proje başına en fazla 100 sorgu); bu yüzden sık sorgular hemen yanıtlanır.
- Ürünlerin üstündeki yanıt yalnızca bulunan ürünlerin kartlarına göre yazılır: ad, marka, fiyat, stok durumu ve özellikler. Kartlarda olmayan bir sayı (fiyat, indirim, süre) içeren cümle silinir. Aynı sorgu ve aynı ürünler için hazır yanıt bir gün saklanır.
- Ürünlerin sırası aramanın sırası olarak kalır: tıklamalardan öğrenme, ziyaretçinin ilgi alanları ve anlama göre arama yapay zekâ sonuçlarında da çalışır, bkz. Ürünler nasıl aranır.
Mağaza eklentileri
WooCommerce ve Magento 2 eklentileri ile 1C-Bitrix modülü, ürün arama modunda yapay zekâ sonuçlarını mağazanın arama sayfasında gösterir. Mağaza teması ürünleri her zamanki gibi çizer, üstlerinde ise izleyici yapay zekâ bloğunu gösterir: öneri, “Yapay zekânın anladığı:” çipleri, daraltmalar ve “Normal arama”. Bir çipi kaldırmak ve daraltma, aynı arama sayfasını yeni parametrelerle açar.
Eklenti çözümlemeyi en fazla 2,5 saniye bekler. Popüler sorgular gece çözümlenmiştir ve hemen açılır, yeni bir açıklayıcı sorgu normalden 1–2 saniye daha geç açılır. Çözümleme yetişmezse mağaza normal sonuçları gösterir. WooCommerce 1.18.0, Magento 2 1.15.0 veya 1C-Bitrix 1.14.0 ya da daha yenisi gerekir.
Kendi sonuç sayfanız
Sonuç sayfası sizinse yapay zekâ sonuçlarını izleyiciden alın:
const result = await cdp.searchAi(q, { perPage: 24 });
if (result.ai) {
// result.items — ürünler, result.ai.understood — “Yapay zekânın anladığı:” çipleri, result.ai.refinements — daraltmalar,
// result.ai.relaxed — filtreler gevşetildi, result.ai.state — sonraki istek için çözümleme
await cdp.searchAiAnswer(q, result.items.slice(0, 6).map((item) => item.id), (text) => { answer.textContent = text; });
} else {
// Sorgu için yapay zekâ gerekmiyor, kullanılamıyor veya yetişmedi — normal sonuçları cdp.search(q) ile gösterin
}
cdp.searchAi seçenekleri: previous — önceki yanıtın result.ai.state değeri, daraltma ifadesiyle (“daha ucuz”) birlikte; state — kaldırılan çip olmadan çözümleme (model çağrısı olmadan sonuçlar); asked: true — ziyaretçi “Yapay zekâya sorun” düğmesine bastı; ayrıca sort, page, perPage. Çözümleme, modelin yanıtını en fazla 8 saniye bekler. İzleyici 1.37.0 gerekir.
Sunucular aynı isteği yazma anahtarıyla yapabilir: POST https://cdp.onetrace.pro/api/v1/search/ai; PHP SDK’da search()->ai(). Parametrelerin tam listesi API başvurusundadır: https://cdp.onetrace.pro/api/v1/openapi.json.
Rapor
Yapay zekâ ile arama açık olduğu sürece Web sitesi → Ürün arama sayfasında sorgu raporunun altında aynı dönem için Yapay zekâ araması raporu gösterilir.

| Gösterge | Ne gösterir |
|---|---|
| Yapay zekâ aramaları ve Tüm aramalar içindeki pay | yapay zekânın kaç sonuç gösterdiği ve bunun web sitesindeki aramaların ne kadarını oluşturduğu |
| Önbellekten | model çağrısı olmadan gelen sonuçların payı: ücretsiz ve anında |
| Ayrıştırma: p50 / p95 | aramaların yarısında ve %95’inde modelin sorguyu ne kadar sürede çözümlediği |
| Yanıtın ilk sözcükleri | müşterinin yapay zekâ önerisinin başını ne kadar sürede gördüğü |
| Gevşetilmiş | tam eşleşme olmadığı için yapay zekânın bazı filtreleri kaldırdığı aramaların payı |
| Hatalar | modelin yanıt vermediği çözümlemeler; bu durumlarda müşteri normal sonuçları gördü |
| 1000 arama başına maliyet | yapay zekâ ile arama için bakiyeden ne kadar düşüldüğü, 1000 aramaya göre |
Göstergelerin altında kaç daraltmanın modelsiz yapıldığı, kaç yapay zekâ yanıtı verildiği ve dönemde ne kadar düşüldüğü yazar. Tabloda yapay zekânın çözümlediği sorgular, bulunan ürün sayısı ve gevşetme payıyla yer alır: gevşetme payı yüksek sorgular ürün yelpazenizde neyin eksik olduğunu gösterir.
Yapay zekânın faydasını ölçme
Yapay zekânın satışa yardımcı olup olmadığını öğrenmek için Yapay zekânın faydasını ölçün seçeneğini açın. Yapay zekâya ihtiyaç duyacak ziyaretçiler iki eşit gruba bölünür: biri yapay zekâ ile arama, diğeri normal arama alır. Ziyaretçi her zaman kendi grubunda kalır. “Yapay zekâya sorun” düğmesine kendisi basan veya sorguyu daraltan kişi her grupta yapay zekâ alır. Normal arama grubunun aramaları yapay zekâ olarak ücretlendirilmez.
Raporda Yapay zekânın faydası bloğu grupları karşılaştırır:
- 30 dakika içinde sonuçlara tıklama: ziyaretçinin bu sorgunun sonuçlarında bir ürüne tıkladığı aramaların payı;
- Aramadan sonraki 7 gün içinde satın alma: aynı müşterinin bir şey satın aldığı aramaların payı. Öneri ayarlarında bir satın alma olayı tanımlıysa gösterilir, bkz. Öneriler ve ürün kataloğu.
Sonuç, diğer varyant karşılaştırmalarındaki gibidir: veri azken rapor bunu yazar; fark istatistiksel olarak anlamlı olduğunda kazananı belirtir. Normal arama daha iyiyse sık sorguların çözümlemesini Çözümlemeyi kontrol et alanında kontrol edin. Sonuçlara tıklamaları arama widget’ı kaydeder; eklentilerin arama sayfasında mağaza teması tıklamaları kaydetmez, bu yüzden orada yalnızca satın almalar karşılaştırılır. Ölçüm kapatıldıktan sonra rapor, çalıştığı dönemin sonuçlarını gösterir.
Ödeme ve sınırlar
Her çözümlemenin ve yapay zekâ yanıtının ücreti, modelin işlediği metin (token) miktarına platformun komisyonu eklenerek hesaplanır. Ücret projenin bakiyesinden düşülür, harcama kalemi “Yapay zekâ ile arama”dır. Önbellekten çözümleme, çip kaldırma, sonraki sayfalar ve sıralama değişikliği modelsizdir ve ücretsizdir. Modeli platform seçer; bir sorgunun çözümlemesi genellikle bir sentin küçük bir kesridir.
- Yapay zekâ ile arama, ürün arama içeren ücretli bir tarifede çalışır. Deneme süresinde, bakiyede para yokken veya yapay zekâ harcama limitine ulaşıldığında yapay zekâ devreye girmez; müşteriler normal aramayı görür.
- Yapay zekâya giden bir istek, tarifenin aylık sınırında bir arama isteği daha sayılır, bkz. Sorgu sınırı. Widget normal sonuçları ve yapay zekâ sonuçlarını aynı anda aradığı için widget’taki açıklayıcı bir sorgu iki kez sayılır; mağaza eklentilerinde bir kez. Yapay zekânın gerekmediği veya kullanılamadığı istekler ve fayda ölçümündeki normal arama grubunun aramaları ikinci kez sayılmaz.
- Bir ziyaretçi modeli dakikada en fazla 10 kez ve günde en fazla 100 kez çağırabilir; bunun üstünde normal sonuçları görür. Önbellekten gelen yanıtlar bu sınırlara dahil değildir.
- Tek bir adresten, sitenin tüm yapay zekâ işlevleri için dakikada en fazla 30 ve günde en fazla 300 model çağrısı; eklentili ve gizli anahtarlı mağaza sunucusu bununla sınırlanmaz. Sitedeki yapay zekânın günde ne kadar harcayabileceğini günlük bütçe belirler: bütçe bittiğinde gece yarısına kadar normal arama çalışır.