Utemeljenje na webu za Decisions API

AI modeli odlučivanja brzi su i isplativi, ali znaju samo ono što im korisnici pošalju i ono što su naučili tijekom treniranja. Za pitanja o činjenicama koje se mijenjaju, primjerice je li netko još uvijek izvršni direktor tvrtke ili je li proizvod dobio novo izdanje, modelu su potrebne ažurne informacije kako bi točno odgovorio.

Od danas Decisions API tvrtke Perplexity može pretraživati web prije nego što odgovori.

Dodajte jednu postavku, "mode": "web_grounding", u bilo koji zahtjev za Decisions API i Perplexity Fast Search izvršit će po jedan upit za svako pitanje. Rezultati se kao dokazi dodaju u vaše polje state, tako da model odlučivanja vraća vjerojatnosti utemeljene na onome što je trenutačno na webu. State može biti i URL kako biste model usmjerili na određenu web stranicu umjesto da unosite njezin tekst.

Na PWS-Decisions, javnom referentnom testu sa 100 pitanja koja ovise o aktualnim činjenicama s weba, točnost je porasla s 51 % na 86 %, uz uobičajeno vrijeme odgovora ispod 400 ms.

Model odlučivanja vraća broj kao odgovor na svako pitanje. Korisnici šalju sadržaj kao state (tekst, JSON ili slike) s jednim ili više pitanja. Za pitanje tipa noul (da ili ne) rezultat je vjerojatnost odgovora „da”. Za pitanje tipa choice rezultat je vjerojatnost za svaku opciju koju korisnik definira. Za pitanje tipa score rezultat je vjerojatnost za svaku razinu vaše bodovne ljestvice i očekivani rezultat.

Model ima dva izvora informacija: state koji korisnik pošalje i ono što je naučio tijekom treniranja. To je dovoljno za pitanje poput „Navodi li ova recenzija nedostatak?” No nije dovoljno za odgovor na pitanje „Je li ta osoba još uvijek izvršni direktor?” Odgovor se možda promijenio nakon treniranja, a ništa u polju state to ne navodi. Utemeljenje na webu dodaje treći izvor: web, pretražen u trenutku zahtjeva. State može biti i URL, pa korisnik može usmjeriti model na web stranicu umjesto na tekst.

Utemeljivanje se izvodi u API pristupniku prije poziva modela. Za svako pitanje u zahtjevu pristupnik izrađuje upit za Fast Search. Upiti se izvode paralelno. Pristupnik spaja rezultate, uklanja duplicirane URL-ove i dodaje dokaze u stanje: naslov, URL i tekst stranice. Ako je stanje URL, upit za pretraživanje sadrži taj URL, pa se sama stranica vraća kao dokaz i model odgovara na temelju njezina teksta. Model vraća vjerojatnosti jednako kao i za bilo koji zahtjev prema Decisions API-ju. Ako pretraživanje ne uspije ili mu istekne vrijeme, model odgovara na temelju onih dokaza koji su ipak vraćeni. Odgovor sadrži search_results kako bi korisnik mogao vidjeti što je model vidio. Korisnikov zahtjev i oblik odgovora ostaju isti. Mijenjaju se dokazi kojima model raspolaže kada odgovara.

Istom smo modelu odlučivanja dvaput poslali 328 tvrdnji tipa točno-netočno, jednom s utemeljenjem na webu i jednom bez njega. Tvrdnje su bile podijeljene između vijesti iz listopada 2026. i rijetkih činjenica s Wikipedije, a svaka točna tvrdnja imala je netočnog blizanca koji se razlikovao u jednom detalju. U polju state nisu dostavljeni nikakvi dokazi.

Bez značajke Web Grounding Decisions API točno je odgovorio na 56,4 posto tvrdnji, što je blizu nagađanja. Uz Web Grounding točno je odgovorio na 97,3 % tvrdnji, čime se broj pogrešaka smanjio sa 143 na 9. Cijena toga je brzina: medijan latencije porastao je sa 139 ms na 366 ms, a latencija 95. percentila sa 514 ms na 742 ms.

PWS-Decisions javni je referentni test zatvorenih pitanja o ispunjavanju uvjeta za račun, mogućnostima proizvoda, pravilima politika i događajima koji se brzo mijenjaju. 100 pitanja javno je dostupno, a ocjenjuju se točnim podudaranjem s referentnim odgovorom. Pokrenuli smo ih na Decisions API + Web Grounding (pplx-decider-v1.2) 4. studenoga 2026. i točno je odgovorio na 86 pitanja. Ostali rezultati u nastavku potječu s ljestvice koju su objavili autori referentnog testa. Njihovih 51 % za Decisions API bez značajke Web Grounding podudara se s rezultatom našeg vlastitog pokretanja.

Zahtjevi za Decisions API + Web Grounding vraćeni su za 370 ms u medijanu i 685 ms na 95. percentilu, mjereno s našeg klijenta na 100 javnih pitanja. Autori referentnog testa navode 560 ms i 710 ms za svoj API na cijelom skupu od 300 pitanja, mjereno s njihova klijenta 29. listopada 2026. U usporedbi s objavljenom ljestvicom, Decisions API + Web Grounding ima najveću točnost na javnom skupu i medijan vremena odgovora ispod 400 ms.

Omogućite utemeljenje na webu kako biste odgovorili na pitanja na koja podaci ne mogu odgovoriti: kada su se činjenice promijenile nakon treniranja, a na webu su objavljene nove informacije. Nekoliko primjera:

Kvalificirajte klijente na temelju nedavnih vijesti. „Je li prikupio financiranje u posljednjih 90 dana?” za cijeli popis klijenata.
Pratite alate o kojima ovisite. „Postoji li stabilno izdanje novije od naše fiksirane verzije?” provjerava se prema rasporedu.
Potvrdite prije nego što agent djeluje. „Održava li se ovaj događaj još uvijek?” provjerava se prije rezervacije.

Svaki je odgovor vjerojatnost na temelju koje kôd programera može djelovati, uz web izvore na kojima se temelji.

Dodajte "mode": "web_grounding" u bilo koji zahtjev prema Decisions API-ju. Stanje (state) može biti tekst, poput tvrdnje ili zapisa, ili URL.

Provjerite tvrdnju na webu:

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?"
      }
    }
  }'

Odgovor dodaje search_results, odnosno stranice koje je model pročitao. Dana 4. studenoga to je vratilo vjerojatnost odgovora „da” veću od 0,99, a prvi je rezultat bio NASA-in zapis o letjelici.

Usmjerite model na stranicu tako da njezin URL proslijedite kao stanje (state):

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?"
      }
    }
  }'

U biblioteci Perplexity za Python proslijedite mode u tijelu zahtjeva:

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)

Svako dovršeno pretraživanje stoji 0,001 USD uz cijenu ulaznih tokena. Dokazi iz pretraživanja ubrajaju se u ulazne tokene. Zahtjev koji koristi Web Grounding može sadržavati do 100 pitanja.

Započnite proučavanjem dokumentacije za Web Grounding.

Kako funkcionira model odlučivanja

Kako funkcionira utemeljenje na webu

Testiranje utemeljenja na webu

PWS-Decisions

Što programeri mogu izgraditi

Započnite