Webové ukotvení pro Decisions API

Rozhodovací modely AI jsou rychlé a nákladově efektivní, ale znají jen to, co jim uživatelé pošlou, a to, co se naučily při trénování. U otázek na měnící se fakta, například zda je někdo stále generálním ředitelem společnosti nebo zda má produkt novou verzi, potřebuje model k přesné odpovědi aktuální informace.

Od dnešního dne umí Decisions API od Perplexity před odpovědí vyhledávat na webu.

Stačí jedno nastavení, "mode": "web_grounding", přidané do libovolného požadavku na Decisions API, a Perplexity Fast Search spustí pro každou otázku jeden dotaz. Výsledky se přidají do vašeho state jako důkazy, takže rozhodovací model vrací pravděpodobnosti podložené tím, co je na webu právě teď. State může být také adresa URL, která model nasměruje na konkrétní webovou stránku, místo abyste zadávali její text.

Na PWS-Decisions, veřejném benchmarku se 100 otázkami závislými na aktuálních faktech z webu, vzrostla přesnost z 51 % na 86 % při typické odezvě pod 400 ms.

Rozhodovací model vrací jako odpověď na každou otázku číslo. Uživatelé posílají obsah jako state (text, JSON nebo obrázky) spolu s jednou nebo více otázkami. U otázky typu noul (ano, nebo ne) je výsledkem pravděpodobnost odpovědi ano. U otázky typu choice je výsledkem pravděpodobnost pro každou možnost, kterou uživatel definuje. U otázky typu score je výsledkem pravděpodobnost pro každou úroveň vašeho hodnoticího schématu a očekávané skóre.

Model má dva zdroje informací: state, který pošle uživatel, a to, co se naučil při trénování. To stačí na otázku jako „Uvádí tato recenze vadu?“ Nestačí to ale k odpovědi na otázku „Je tato osoba stále generálním ředitelem?“ Odpověď se mohla po trénování změnit a ve state o tom nic není. Webové ukotvení přidává třetí zdroj: web, prohledaný v okamžiku požadavku. State může být také adresa URL, takže uživatel může model místo na text nasměrovat na webovou stránku.

Ukotvení probíhá v bráně API ještě před voláním modelu. Pro každou otázku v požadavku brána sestaví dotaz pro Fast Search. Dotazy běží paralelně. Brána výsledky sloučí, odstraní duplicitní URL a připojí podklady k hodnotě state: název, URL a text stránky. Pokud je hodnotou state URL, vyhledávací dotaz tuto URL obsahuje, takže se jako podklad vrátí samotná stránka a model odpovídá na základě jejího textu. Model vrací pravděpodobnosti stejně jako u jakéhokoli jiného požadavku na rozhraní Decisions API. Pokud vyhledávání selže nebo vyprší jeho časový limit, model odpoví na základě podkladů, které se vrátily. Odpověď obsahuje search_results, takže uživatel vidí, z čeho model vycházel. Požadavek uživatele i struktura odpovědi zůstávají stejné. Mění se jen podklady, které má model k dispozici, když odpovídá.

Stejnému rozhodovacímu modelu jsme dvakrát poslali 328 tvrzení typu pravda/nepravda, jednou s webovým ukotvením a jednou bez něj. Tvrzení byla rozdělena mezi zprávy z října 2026 a málo známá fakta z Wikipedie a každé pravdivé tvrzení mělo nepravdivé dvojče, které se lišilo v jednom detailu. Ve state nebyly dodány žádné důkazy.

Bez Web Grounding odpovědělo rozhraní Decisions API správně na 56,4 % tvrzení, což se blíží náhodnému tipování. S Web Grounding odpovědělo správně na 97,3 % a snížilo počet chyb ze 143 na 9. Daní za to je rychlost: medián latence vzrostl ze 139 ms na 366 ms a latence 95. percentilu z 514 ms na 742 ms.

PWS-Decisions je veřejný benchmark uzavřených otázek týkajících se způsobilosti účtů, funkcí produktů, pravidel v zásadách a rychle se vyvíjejících událostí. 100 otázek je veřejných a hodnotí se přesnou shodou s referenční odpovědí. Dne 4. listopadu 2026 jsme je spustili proti rozhraní Decisions API + Web Grounding (pplx-decider-v1.2) a správně odpovědělo na 86 z nich. Ostatní výsledky níže pocházejí ze zveřejněného žebříčku autorů benchmarku. Jejich výsledek 51 % pro rozhraní Decisions API bez Web Grounding odpovídá našemu vlastnímu běhu.

Požadavky na Decisions API + Web Grounding se vrátily za 370 ms v mediánu a za 685 ms v 95. percentilu, měřeno z našeho klienta na 100 veřejných otázkách. Autoři benchmarku uvádějí pro své API 560 ms a 710 ms na celé sadě 300 otázek, měřeno z jejich klienta 29. října 2026. Ve srovnání se zveřejněným žebříčkem má Decisions API + Web Grounding nejvyšší přesnost na veřejné sadě a medián odezvy pod 400 ms.

Zapněte webové ukotvení a odpovídejte na otázky, na které data odpovědět nedokážou: když se fakta po trénování změnila a na webu byly zveřejněny nové informace. Několik příkladů:

Kvalifikujte účty podle nedávných zpráv. „Získali financování za posledních 90 dní?“ napříč celým seznamem účtů.
Sledujte nástroje, na kterých závisíte. „Existuje stabilní verze novější než naše připnutá verze?“ kontrolováno pravidelně podle plánu.
Ověřte si to dřív, než agent začne jednat. „Koná se tato akce ještě?“ se zkontroluje před rezervací.

Každá odpověď je pravděpodobnost, podle které může kód vývojáře jednat, a k ní webové zdroje, na nichž se zakládá.

Přidejte "mode": "web_grounding" do libovolného požadavku na rozhraní Decisions API. Hodnotou state může být text, například tvrzení nebo záznam, nebo URL.

Ověřte tvrzení podle 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?"
      }
    }
  }'

Odpověď navíc obsahuje search_results, tedy stránky, které model přečetl. Dne 4. listopadu tento dotaz vrátil pravděpodobnost odpovědi „ano“ vyšší než 0,99 a prvním výsledkem byl záznam NASA o dané kosmické lodi.

Chcete-li model nasměrovat na konkrétní stránku, předejte její URL jako hodnotu 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?"
      }
    }
  }'

V knihovně Perplexity pro Python předejte mode v těle požadavku:

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é vyhledávání stojí 0,001 USD nad rámec vstupních tokenů. Podklady z vyhledávání se započítávají do vstupních tokenů. Požadavek s Web Grounding může obsahovat až 100 otázek.

Začněte prostudováním dokumentace k Web Grounding.

Jak funguje rozhodovací model

Jak funguje webové ukotvení

Testování webového ukotvení

PWS-Decisions

Co mohou vývojáři vytvořit

Začínáme