Veebipõhine maandamine Decisions API jaoks

AI-otsustusmudelid on kiired ja kulutõhusad, kuid nad teavad ainult seda, mida kasutajad neile saadavad ja mida nad treenimise käigus õppisid. Muutuvate faktide kohta käivatele küsimustele – näiteks kas keegi on endiselt ettevõtte tegevjuht või kas tootel on uus väljalase – täpselt vastamiseks vajab mudel ajakohast teavet.

Alates tänasest saab Perplexity Decisions API enne vastamist veebist otsida.

Lisage üks seadistus, "mode": "web_grounding", mis tahes Decisions API päringule ja Perplexity Fast Search käivitab iga küsimuse kohta ühe otsingupäringu. Tulemused lisatakse teie olekule tõenditena, nii et otsustusmudel tagastab tõenäosused, mis tuginevad sellele, mis on praegu veebis. Olek võib olla ka URL, et suunata mudel teksti sisestamise asemel konkreetsele veebilehele.

Avalikus võrdlustestis PWS-Decisions, mille 100 küsimust sõltuvad ajakohastest veebifaktidest, tõusis täpsus 51%-lt 86%-le ning tüüpiline vastuseaeg jäi alla 400 ms.

Otsustusmudel tagastab igale küsimusele vastuseks arvu. Kasutajad saadavad sisu väljal state (tekst, JSON või pildid) koos ühe või mitme küsimusega. noul-küsimuse (jah või ei) puhul on tulemuseks jah-vastuse tõenäosus. choice-küsimuse puhul on tulemuseks tõenäosus iga kasutaja määratud valikuvariandi kohta. score-küsimuse puhul on tulemuseks tõenäosus teie hindamisskaala iga taseme kohta ning eeldatav hinne.

Mudelil on kaks teabeallikat: kasutaja saadetud olek ja see, mida ta treenimise käigus õppis. Sellest piisab küsimuse puhul nagu „Kas see arvustus teatab defektist?“ Sellest ei piisa, et vastata küsimusele „Kas see inimene on endiselt tegevjuht?“ Vastus võib olla pärast treenimist muutunud ja olekus pole selle kohta midagi. Veebipõhine maandamine lisab kolmanda allika: veebi, milles otsitakse päringu tegemise ajal. Olek võib olla ka URL, nii et kasutaja saab suunata mudeli teksti asemel veebilehele.

Web Grounding töötab API lüüsis enne mudeli väljakutset. Iga päringus sisalduva küsimuse jaoks koostab lüüs Fast Searchi otsingupäringu. Otsingupäringud käivitatakse paralleelselt. Lüüs ühendab tulemused, eemaldab korduvad URL-id ja lisab tõendid olekusse: pealkirja, URL-i ja lehe teksti. Kui olek on URL, sisaldab otsingupäring seda URL-i, nii et tõendina tuleb tagasi leht ise ja mudel vastab selle teksti põhjal. Mudel tagastab tõenäosused samamoodi nagu mis tahes muu Decisions API päringu puhul. Kui otsing ebaõnnestub või aegub, vastab mudel nende tõendite põhjal, mis tagasi tulid. Vastus sisaldab välja search_results, et kasutaja saaks vaadata, mida mudel nägi. Kasutaja päring ja vastuse struktuur jäävad samaks. Muutub see, millised tõendid on mudelil vastamise ajal olemas.

Saatsime samale otsustusmudelile kaks korda 328 väidet, mis olid kas tõesed või väärad – üks kord veebipõhise maandamisega ja üks kord ilma. Väited jagunesid 2026. aasta oktoobri uudiste ja Wikipedia haruldaste faktide vahel ning igal tõesel väitel oli väär kaksik, mis erines sellest ühe detaili poolest. Olekus tõendeid ei esitatud.

Ilma Web Groundinguta vastas Decisions API õigesti 56,4 protsendile väidetest, mis on lähedane juhuslikule arvamisele. Web Groundinguga vastas see õigesti 97,3%-le, vähendades vigade arvu 143-lt 9-le. Hinnaks on kiirus: latentsuse mediaan kasvas 139 ms-lt 366 ms-ni ja 95. protsentiili latentsus 514 ms-lt 742 ms-ni.

PWS-Decisions on avalik võrdlustest, mis koosneb suletud küsimustest konto kvalifitseerumise, toote võimaluste, poliitikareeglite ja kiiresti arenevate sündmuste kohta. Avalikke küsimusi on 100 ja neid hinnatakse täpse vastavuse alusel võrdlusvastusega. Käitasime need 4. novembril 2026 süsteemiga Decisions API + Web Grounding (pplx-decider-v1.2) ja see vastas õigesti 86 küsimusele. Allpool toodud ülejäänud tulemused pärinevad võrdlustesti autorite avaldatud edetabelist. Nende tulemus 51% Decisions API kohta ilma Web Groundinguta ühtib meie enda testiga.

Decisions API + Web Grounding päringud said vastuse mediaanina 370 ms ja 95. protsentiilis 685 ms jooksul, mõõdetuna meie kliendirakendusest 100 avaliku küsimuse põhjal. Võrdlustesti autorid teatavad oma API kohta kogu 300 küsimusega komplekti puhul 560 ms ja 710 ms, mõõdetuna nende kliendirakendusest 29. oktoobril 2026. Avaldatud edetabeliga võrreldes on Decisions API + Web Grounding lahendusel avaliku komplekti kõrgeim täpsus ja mediaanne vastuseaeg alla 400 ms.

Lülitage sisse veebipõhine maandamine, et vastata küsimustele, millele andmed vastust ei anna: kui faktid on pärast treenimist muutunud ja veebis on avaldatud uut teavet. Mõned näited:

Kvalifitseerige kliente hiljutiste uudiste põhjal. „Kas on viimase 90 päeva jooksul rahastust kaasanud?“ – kogu kliendinimekirja ulatuses.
Jälgige tööriistu, millest sõltute. „Kas on olemas stabiilne väljalase, mis on uuem kui meie fikseeritud versioon?“ – kontrollitakse ajakava alusel.
Kinnitage enne, kui agent tegutseb. „Kas see üritus toimub endiselt?“ – kontrollitakse enne broneerimist.

Iga vastus on tõenäosus, mille põhjal arendaja kood saab tegutseda, koos selle aluseks olevate veebiallikatega.

Lisage mis tahes Decisions API päringule "mode": "web_grounding". Olek võib olla tekst, näiteks väide või kirje, või URL.

Kontrollige väidet veebi põhjal:

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

Vastusele lisatakse search_results ehk lehed, mida mudel luges. 4. novembril tagastas see vastuse „jah“ tõenäosuseks üle 0,99 ning esimene tulemus oli NASA kosmoseaparaadi kirje.

Suunake mudel konkreetsele lehele, edastades selle URL-i olekuna:

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 Pythoni teegis edastage mode päringu kehas:

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)

Iga lõpuleviidud otsing maksab lisaks sisendtokenitele 0,001 $. Otsingutõendid arvestatakse sisendtokenite hulka. Web Groundingut kasutav päring võib sisaldada kuni 100 küsimust.

Alustamiseks tutvuge Web Groundingu dokumentatsiooniga.

Kuidas otsustusmudel töötab

Kuidas veebipõhine maandamine töötab

Veebipõhise maandamise testimine

PWS-Decisions

Mida arendajad saavad luua

Alustamine