Ukotvenie vo webe pre Decisions API

Rozhodovacie modely AI sú rýchle a nákladovo efektívne, no vedia len to, čo im používatelia pošlú, a to, čo sa naučili počas trénovania. Pri otázkach o meniacich sa faktoch, napríklad či je niekto stále generálnym riaditeľom spoločnosti alebo či má produkt nové vydanie, potrebuje model na presnú odpoveď aktuálne informácie.

Odteraz dokáže Decisions API od Perplexity pred odpoveďou vyhľadávať na webe.

Pridajte jedno nastavenie, "mode": "web_grounding", do ľubovoľnej požiadavky na Decisions API a Perplexity Fast Search spustí pre každú otázku jeden dopyt. Výsledky sa pridajú do vášho parametra state ako dôkazy, takže rozhodovací model vracia pravdepodobnosti podložené tým, čo je na webe práve teraz. Parameter state môže byť aj adresa URL, ktorá model nasmeruje na konkrétnu webovú stránku namiesto zadávania jej textu.

V PWS-Decisions, verejnom benchmarku so 100 otázkami, ktoré závisia od aktuálnych faktov z webu, vzrástla presnosť z 51 % na 86 % pri typických odozvách pod 400 ms.

Rozhodovací model vracia ako odpoveď na každú otázku číslo. Používatelia posielajú obsah ako state (text, JSON alebo obrázky) s jednou alebo viacerými otázkami. Pri otázke typu noul (áno alebo nie) je výsledkom pravdepodobnosť odpovede áno. Pri otázke typu choice je výsledkom pravdepodobnosť pre každú možnosť, ktorú používateľ definuje. Pri otázke typu score je výsledkom pravdepodobnosť pre každú úroveň vašej hodnotiacej stupnice a očakávané skóre.

Model má dva zdroje informácií: parameter state, ktorý pošle používateľ, a to, čo sa naučil počas trénovania. To stačí na otázku ako „Uvádza táto recenzia chybu?“ Nestačí to však na odpoveď na otázku „Je táto osoba stále generálnym riaditeľom?“ Odpoveď sa mohla po trénovaní zmeniť a v parametri state o tom nič nie je. Ukotvenie vo webe pridáva tretí zdroj: web prehľadávaný v čase požiadavky. Parameter state môže byť aj adresa URL, takže používateľ môže model namiesto textu nasmerovať na webovú stránku.

Web grounding prebieha v bráne API ešte pred volaním modelu. Pre každú otázku v požiadavke brána zostaví dopyt pre Fast Search. Dopyty prebiehajú paralelne. Brána zlúči výsledky, odstráni duplicitné URL adresy a pripojí dôkazy k stavu: názov, URL a text stránky. Ak je stavom URL, vyhľadávací dopyt obsahuje túto URL, takže ako dôkaz sa vráti samotná stránka a model odpovedá na základe jej textu. Model vracia pravdepodobnosti rovnako ako pri akejkoľvek inej požiadavke na Decisions API. Ak vyhľadávanie zlyhá alebo vyprší jeho časový limit, model odpovie na základe dôkazov, ktoré sa vrátili. Odpoveď obsahuje search_results, aby si používateľ mohol pozrieť, čo model videl. Požiadavka používateľa aj štruktúra odpovede zostávajú rovnaké. Mení sa len to, aké dôkazy má model k dispozícii, keď odpovedá.

Rovnakému rozhodovaciemu modelu sme dvakrát poslali 328 tvrdení typu pravda/nepravda, raz s ukotvením vo webe a raz bez neho. Tvrdenia boli rozdelené medzi správy z októbra 2026 a zriedkavé fakty z Wikipédie a každé pravdivé tvrdenie malo nepravdivé dvojča, ktoré sa líšilo v jednom detaile. V parametri state neboli poskytnuté žiadne dôkazy.

Bez funkcie web grounding odpovedalo Decisions API správne na 56,4 % tvrdení, čo je blízko náhodnému tipovaniu. S funkciou web grounding odpovedalo správne na 97,3 % a počet chýb klesol zo 143 na 9. Daňou je rýchlosť: medián latencie stúpol zo 139 ms na 366 ms a latencia 95. percentilu z 514 ms na 742 ms.

PWS-Decisions je verejný benchmark uzavretých otázok o kvalifikácii účtov, schopnostiach produktov, pravidlách zásad a rýchlo sa meniacich udalostiach. 100 otázok je verejných a hodnotia sa presnou zhodou s referenčnou odpoveďou. Dňa 4. novembra 2026 sme ich spustili na Decisions API + Web Grounding (pplx-decider-v1.2) a správne odpovedalo na 86 z nich. Ostatné výsledky nižšie pochádzajú z rebríčka zverejneného autormi benchmarku. Ich výsledok 51 % pre Decisions API bez funkcie Web Grounding sa zhoduje s naším vlastným meraním.

Požiadavky na Decisions API + Web Grounding sa vrátili s mediánom 370 ms a za 685 ms na 95. percentile, merané z nášho klienta na 100 verejných otázkach. Autori benchmarku uvádzajú pre svoje API 560 ms a 710 ms na úplnej sade 300 otázok, merané z ich klienta 29. októbra 2026. V porovnaní so zverejneným rebríčkom má Decisions API + Web Grounding najvyššiu presnosť na verejnej sade a medián odozvy pod 400 ms.

Zapnite ukotvenie vo webe a odpovedajte aj na otázky, na ktoré samotné dáta nestačia: keď sa fakty po trénovaní zmenili a na webe sú zverejnené nové informácie. Niekoľko príkladov:

Kvalifikujte účty podľa najnovších správ. Otázka „Získali za posledných 90 dní financovanie?“ položená pre celý zoznam účtov.
Sledujte nástroje, od ktorých závisíte. Otázka „Existuje stabilné vydanie novšie ako naša pripnutá verzia?“ kontrolovaná podľa harmonogramu.
Overte si to skôr, než agent začne konať. Otázka „Koná sa táto udalosť ešte?“ overená pred rezerváciou.

Každá odpoveď je pravdepodobnosť, podľa ktorej môže kód vývojára konať, spolu s webovými zdrojmi, z ktorých vychádza.

Do ľubovoľnej požiadavky na Decisions API pridajte "mode": "web_grounding". Stavom môže byť text, napríklad tvrdenie alebo záznam, alebo URL.

Overte tvrdenie na webe:

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

Odpoveď pridáva search_results, teda stránky, ktoré model prečítal. Dňa 4. novembra táto požiadavka vrátila pravdepodobnosť odpovede áno vyššiu ako 0,99, pričom prvým výsledkom bol záznam NASA o kozmickej lodi.

Nasmerujte model na stránku tak, že ako stav odovzdáte jej URL:

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

V knižnici Perplexity pre Python odovzdajte parameter mode v tele požiadavky:

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)

Každé dokončené vyhľadávanie stojí 0,001 USD navyše k vstupným tokenom. Dôkazy z vyhľadávania sa započítavajú do vstupných tokenov. Požiadavka využívajúca Web Grounding môže obsahovať až 100 otázok.

Začnite preskúmaním dokumentácie k funkcii web grounding.

Ako funguje rozhodovací model

Ako funguje ukotvenie vo webe

Testovanie ukotvenia vo webe

PWS-Decisions

Čo môžu vývojári vytvárať

Začnite