Decisions API için web temellendirmesi

Yapay zekâ karar modelleri hızlı ve uygun maliyetlidir ancak yalnızca kullanıcıların kendilerine gönderdiklerini ve eğitimde öğrendiklerini bilirler. Birinin hâlâ bir şirketin CEO’su olup olmadığı ya da bir ürünün yeni bir sürümünün çıkıp çıkmadığı gibi değişen olgularla ilgili sorularda, modelin doğru yanıt verebilmesi için güncel bilgilere ihtiyacı vardır.

Bugünden itibaren Perplexity’nin Decisions API’si yanıt vermeden önce web’de arama yapabiliyor.

Tek bir ayar yeterli: "mode": "web_grounding" ayarını herhangi bir Decisions API isteğine ekleyin; Perplexity Fast Search her soru için bir sorgu çalıştırır. Sonuçlar state alanınıza kanıt olarak eklenir; böylece karar modeli, şu anda web’de bulunan bilgilere dayalı olasılıklar döndürür. State, metnini girmek yerine modeli belirli bir web sayfasına yönlendirmek için bir URL de olabilir.

Güncel web bilgilerine dayanan 100 sorudan oluşan herkese açık kıyaslama testi PWS-Decisions üzerinde doğruluk, tipik yanıt süreleri 400 ms’nin altında kalırken %51’den %86’ya yükseldi.

Bir karar modeli, her soruya yanıt olarak bir sayı döndürür. Kullanıcılar içeriği bir veya daha fazla soruyla birlikte state (metin, JSON veya görseller) olarak gönderir. noul sorusunda (evet veya hayır) sonuç, evet olma olasılığıdır. choice sorusunda sonuç, kullanıcının tanımladığı her seçenek için bir olasılıktır. score sorusunda sonuç, değerlendirme ölçütünüzün her düzeyi için bir olasılık ve beklenen puandır.

Modelin iki bilgi kaynağı vardır: kullanıcının gönderdiği state ve eğitimde öğrendikleri. Bu, "Bu yorum bir kusur bildiriyor mu?" gibi bir soru için yeterlidir. Ancak "Bu kişi hâlâ CEO mu?" sorusunu yanıtlamak için yeterli değildir. Yanıt eğitimden sonra değişmiş olabilir ve state içinde bunu belirten hiçbir şey yoktur. Web temellendirmesi üçüncü bir kaynak ekler: istek anında aranan web. State bir URL de olabilir; böylece kullanıcı modeli metin yerine bir web sayfasına yönlendirebilir.

Temellendirme, model çağrısından önce API ağ geçidinde çalışır. Ağ geçidi, bir istekteki her soru için bir Fast Search sorgusu oluşturur. Sorgular paralel olarak çalışır. Ağ geçidi sonuçları birleştirir, yinelenen URL'leri kaldırır ve kanıtları (başlık, URL ve sayfa metni) state alanına ekler. state bir URL ise arama sorgusu bu URL'yi içerir; böylece sayfanın kendisi kanıt olarak geri döner ve model, sayfanın metnine dayanarak yanıt verir. Model, diğer tüm Decisions API isteklerinde olduğu gibi olasılıklar döndürür. Bir arama başarısız olursa veya zaman aşımına uğrarsa model, elde edilen kanıtlar hangileriyse onlara dayanarak yanıt verir. Kullanıcının modelin ne gördüğünü inceleyebilmesi için yanıt, search_results alanını içerir. Kullanıcının isteği ve yanıtın yapısı aynı kalır. Değişen tek şey, modelin yanıt verirken elinde bulunan kanıtlardır.

Aynı karar modeline 328 doğru-yanlış iddiasını iki kez gönderdik: bir kez web temellendirmesiyle, bir kez de web temellendirmesi olmadan. İddialar, Ekim 2026 haberleri ile Wikipedia’dan alınan nadir bilgiler arasında bölündü ve her doğru iddianın tek bir ayrıntıda farklılaşan yanlış bir ikizi vardı. State alanında hiçbir kanıt sağlanmadı.

Web Grounding olmadan Decisions API, iddiaların %56,4'ünü doğru yanıtladı; bu oran rastgele tahmine yakındır. Web Grounding ile doğru yanıt oranı %97,3'e çıktı ve hata sayısı 143'ten 9'a düştü. Bunun bedeli hızdır: medyan gecikme 139 ms'den 366 ms'ye, 95. yüzdelik dilim gecikmesi ise 514 ms'den 742 ms'ye yükseldi.

PWS-Decisions; hesap uygunluğu, ürün özellikleri, politika kuralları ve hızla değişen olaylar hakkında kapalı uçlu sorulardan oluşan, herkese açık bir karşılaştırma testidir. 100 soru herkese açıktır ve bir referans yanıtla tam eşleşmeye göre puanlanır. Bu soruları 4 Kasım 2026'da Decisions API + Web Grounding (pplx-decider-v1.2) üzerinde çalıştırdık ve 86 soru doğru yanıtlandı. Aşağıdaki diğer sonuçlar, karşılaştırma testinin yazarlarının yayımladığı sıralama tablosudur. Yazarların Web Grounding olmadan Decisions API için bildirdiği %51'lik sonuç, kendi çalıştırmamızın sonucuyla örtüşmektedir.

Decisions API + Web Grounding istekleri, 100 herkese açık soru üzerinde kendi istemcimizden ölçüldüğünde medyanda 370 ms’de, 95. yüzdelik dilimde ise 685 ms’de yanıt döndürdü. Kıyaslama testinin yazarları, 29 Ekim 2026’da kendi istemcilerinden ölçülen 300 soruluk setin tamamında kendi API’leri için 560 ms ve 710 ms bildiriyor. Yayımlanan sıralama tablosuyla karşılaştırıldığında Decisions API + Web Grounding, herkese açık sette en yüksek doğruluğa ve 400 ms’nin altında medyan yanıt süresine sahip.

Verilerin yanıtlayamadığı soruları yanıtlamak için web temellendirmesini etkinleştirin: olgular eğitimden sonra değiştiğinde ve web’de yeni bilgiler yayımlandığında. Bazı örnekler:

Hesapları son haberlere göre nitelendirin. "Son 90 gün içinde yatırım aldı mı?" sorusu, tüm hesap listesi genelinde sorulur.
Bağımlı olduğunuz araçları takip edin. "Sabitlediğimiz sürümden daha yeni kararlı bir sürüm var mı?" sorusu belirli bir zamanlamayla kontrol edilir.
Bir ajan harekete geçmeden önce doğrulayın. "Bu etkinlik hâlâ geçerli mi?" sorusu, ajan rezervasyon yapmadan önce kontrol edilir.

Her yanıt, bir geliştiricinin kodunun temel alarak işlem yapabileceği bir olasılıktır ve dayandığı web kaynaklarıyla birlikte sunulur.

Herhangi bir Decisions API isteğine "mode": "web_grounding" ekleyin. state alanı, bir iddia veya kayıt gibi bir metin ya da bir URL olabilir.

Bir iddiayı web kaynaklarıyla doğrulayın:

bash

curl -X POST https://api.perplexity.ai/v1/decisions \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pplx-decider-v1.2",
    "mode": "web_grounding",
    "state": "Claim: The James Webb Space Telescope launched in December 2021.",
    "questions": {
      "supported": {
        "type": "noul",
        "instructions": "Is the claim true?"
      }
    }
  }'

Yanıta, modelin okuduğu sayfaları içeren search_results eklenir. 4 Kasım'da bu istek, ilk sonuç NASA'nın uzay aracı kaydı olmak üzere "evet" için 0,99'un üzerinde bir olasılık döndürdü.

Modeli bir sayfaya yönlendirmek için sayfanın URL'sini state olarak iletin:

bash

curl -X POST https://api.perplexity.ai/v1/decisions \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "pplx-decider-v1.2",
    "mode": "web_grounding",
    "state": "https://pypi.org/project/requests/",
    "questions": {
      "newer_stable_release": {
        "type": "noul",
        "instructions": "Has this package published a stable release newer than 2.31.0 as of today?"
      }
    }
  }'

Perplexity Python kitaplığında mode parametresini istek gövdesinde iletin:

python

from perplexity import Perplexity

client = Perplexity()

response = client.decisions.create(
    model="pplx-decider-v1.2",
    state="Claim: The James Webb Space Telescope launched in December 2021.",
    questions={"supported": {"type": "noul", "instructions": "Is the claim true?"}},
    extra_body={"mode": "web_grounding"},
)

print(response.answers["supported"].noul)

Tamamlanan her aramanın maliyeti, girdi token'larına ek olarak $0,001'dir. Arama kanıtları girdi token'larına dahil edilir. Web Grounding kullanan bir istek en fazla 100 soru içerebilir.

Web Grounding belgelerini inceleyerek başlayın.

Karar modeli nasıl çalışır

Web temellendirmesi nasıl çalışır

Web temellendirmesini test etme

PWS-Decisions

Geliştiriciler neler oluşturabilir

Başlayın