Veb utemeljenje za Decisions API

Utemeljite odluke na aktuelnim činjenicama sa veba uz Perplexity Decisions API. Dodajte pretragu uživo za tačne i ažurne odgovore.

Web Grounded Decisions API title over an abstract sphere with glowing streams of light.

AI modeli odlučivanja su brzi i isplativi, ali znaju samo ono što im korisnici pošalju i ono što su naučili tokom treniranja. Za pitanja o činjenicama koje se menjaju, na primer da li je neko i dalje izvršni direktor kompanije ili da li proizvod ima novo izdanje, modelu su potrebne ažurne informacije da bi tačno odgovorio.

Od danas Perplexity Decisions API može da pretražuje veb pre nego što odgovori.

Dodajte jedno podešavanje, "mode": "web_grounding", u bilo koji Decisions API zahtev i Perplexity Fast Search će pokrenuti po jedan upit za svako pitanje. Rezultati se kao dokazi dodaju u vaše polje state, tako da model odlučivanja vraća verovatnoće zasnovane na onome što se trenutno nalazi na vebu. State može biti i URL adresa, kako biste model usmerili na određenu veb stranicu umesto da unosite njen tekst.

Na PWS-Decisions, javnom benchmarku sa 100 pitanja koja zavise od aktuelnih činjenica sa veba, tačnost je porasla sa 51% na 86%, uz tipično vreme odziva ispod 400 ms.

Kako funkcioniše model odlučivanja

Model odlučivanja vraća broj kao odgovor na svako pitanje. Korisnici šalju sadržaj kao state (tekst, JSON ili slike) uz jedno ili više pitanja. Za pitanje tipa noul (da ili ne), rezultat je verovatnoća odgovora „da“. Za pitanje tipa choice, rezultat je verovatnoća za svaku opciju koju korisnik definiše. Za pitanje tipa score, rezultat je verovatnoća za svaki nivo vaše skale ocenjivanja i očekivana ocena.

Model ima dva izvora informacija: polje state koje korisnik šalje i ono što je naučio tokom treniranja. To je dovoljno za pitanje kao što je „Da li ova recenzija prijavljuje nedostatak?“ Nije dovoljno da se odgovori na pitanje „Da li je ova osoba i dalje izvršni direktor?“ Odgovor se možda promenio nakon treniranja, a ništa u polju state to ne navodi. Veb utemeljenje dodaje treći izvor: veb, pretražen u trenutku zahteva. State može biti i URL adresa, tako da korisnik može da usmeri model na veb stranicu umesto na tekst.

Kako funkcioniše veb utemeljenje

Utemeljenje se izvršava u API gateway-u pre poziva modela. Za svako pitanje u zahtevu gateway pravi Fast Search upit. Upiti se izvršavaju paralelno. Gateway objedinjuje rezultate, uklanja duplirane URL adrese i dodaje dokaze u state: naslov, URL i tekst stranice. Ako je state URL, upit za pretragu sadrži taj URL, pa se sama stranica vraća kao dokaz i model odgovara na osnovu njenog teksta. Model vraća verovatnoće isto kao za bilo koji zahtev ka Decisions API-ju. Ako pretraga ne uspe ili joj istekne vreme, model odgovara na osnovu dokaza koji su pristigli. Odgovor sadrži search_results kako bi korisnik mogao da vidi šta je model video. Zahtev korisnika i oblik odgovora ostaju isti. Menjaju se samo dokazi kojima model raspolaže kada odgovara.

Testiranje veb utemeljenja

Poslali smo 328 tvrdnji tipa tačno/netačno istom modelu odlučivanja dva puta, jednom sa veb utemeljenjem i jednom bez njega. Tvrdnje su bile podeljene između vesti iz oktobra 2026. i retkih činjenica sa Wikipedije, a svaka tačna tvrdnja imala je netačnog blizanca koji se razlikovao u jednom detalju. U polju state nisu dostavljeni nikakvi dokazi.

Bez utemeljenja na vebu, Decisions API je tačno odgovorio na 56,4 odsto tvrdnji, što je blizu nasumičnog pogađanja. Sa utemeljenjem na vebu tačno je odgovorio na 97,3% tvrdnji, čime je broj grešaka smanjen sa 143 na 9. Cena toga je brzina: medijana latencije porasla je sa 139 ms na 366 ms, a latencija 95. percentila sa 514 ms na 742 ms.

PWS-Decisions

PWS-Decisions je javni benchmark sa pitanjima zatvorenog tipa o ispunjavanju uslova za nalog, mogućnostima proizvoda, pravilima politika i događajima koji se brzo razvijaju. Javno je 100 pitanja, a ocenjuju se tačnim poklapanjem sa referentnim odgovorom. Pokrenuli smo ih na sistemu Decisions API + Web Grounding (pplx-decider-v1.2) 4. novembra 2026. i on je tačno odgovorio na 86. Ostali rezultati u nastavku potiču sa rang-liste koju su objavili autori benchmarka. Njihovih 51% za Decisions API bez funkcije Web Grounding poklapa se sa rezultatom našeg testiranja.

Zahtevi ka Decisions API + Web Grounding rešenju dobili su odgovor za 370 ms po medijani i za 685 ms na 95. percentilu, mereno iz našeg klijenta na 100 javnih pitanja. Autori benchmarka navode 560 ms i 710 ms za svoj API na kompletnom skupu od 300 pitanja, mereno iz njihovog klijenta 29. oktobra 2026. U poređenju sa objavljenom rang-listom, Decisions API + Web Grounding ima najveću tačnost na javnom skupu i medijanu vremena odziva ispod 400 ms.

Šta programeri mogu da naprave

Omogućite veb utemeljenje da biste odgovorili na pitanja na koja podaci ne mogu da odgovore: kada su se činjenice promenile nakon treniranja i kada su na vebu objavljene nove informacije. Neki primeri:

  • Kvalifikujte klijente na osnovu nedavnih vesti. „Da li su prikupili finansiranje u poslednjih 90 dana?“ za celu listu klijenata.
  • Pratite alate od kojih zavisite. „Da li postoji stabilno izdanje novije od naše fiksirane verzije?“ proverava se po rasporedu.
  • Potvrdite pre nego što agent preduzme radnju. „Da li se ovaj događaj i dalje održava?“ proverava se pre rezervacije.

Svaki odgovor je verovatnoća na osnovu koje kod programera može da deluje, zajedno sa veb izvorima na kojima se zasniva.

Započnite

Dodajte "mode": "web_grounding" u bilo koji zahtev ka Decisions API-ju. State može biti tekst, poput tvrdnje ili zapisa, ili URL.

Proverite tvrdnju pomoću veba:

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, stranice koje je model pročitao. Dana 4. novembra ovo je vratilo verovatnoću odgovora „da” veću od 0,99, a prvi rezultat bio je NASA-in zapis o svemirskoj letelici.

Usmerite model na stranicu tako što ćete proslediti njen URL kao 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 Perplexity Python biblioteci prosledite mode u telu zahteva:

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)

Svaka završena pretraga košta 0,001 $, pored ulaznih tokena. Dokazi iz pretrage se uračunavaju u ulazne tokene. Zahtev koji koristi Web Grounding može da sadrži do 100 pitanja.

Započnite istraživanjem dokumentacije o utemeljenju na vebu.