Pagrindimas žiniatinklio duomenimis, skirtas Decisions API

Grįskite sprendimus dabartiniais žiniatinklio faktais su Perplexity Decisions API. Pridėkite tiesioginę paiešką, kad gautumėte tikslius ir naujausius atsakymus.

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

DI sprendimų modeliai yra greiti ir ekonomiški, tačiau jie žino tik tai, ką jiems siunčia naudotojai, ir tai, ką išmoko mokymo metu. Kai klausimai susiję su kintančiais faktais, pavyzdžiui, ar kas nors vis dar yra įmonės generalinis direktorius arba ar išleista nauja produkto versija, modeliui tiksliai atsakyti reikia naujausios informacijos.

Nuo šiandien Perplexity Decisions API gali atlikti paiešką žiniatinklyje prieš pateikiant atsakymą.

Pridėkite vieną nustatymą, "mode": "web_grounding", prie bet kurios Decisions API užklausos, ir Perplexity Fast Search kiekvienam klausimui įvykdys po vieną paieškos užklausą. Rezultatai pridedami prie jūsų būsenos kaip įrodymai, todėl sprendimų modelis grąžina tikimybes, pagrįstas tuo, kas žiniatinklyje yra būtent dabar. Būsena taip pat gali būti URL, kad nukreiptumėte modelį į konkretų tinklalapį, užuot įvedę jo tekstą.

Atliekant PWS-Decisions – viešą lyginamąjį testą su 100 klausimų, kurių atsakymai priklauso nuo dabartinių žiniatinklio faktų, – tikslumas padidėjo nuo 51 % iki 86 %, o įprasti atsakymai pateikiami greičiau nei per 400 ms.

Kaip veikia sprendimų modelis

Sprendimų modelis į kiekvieną klausimą atsako skaičiumi. Naudotojai siunčia turinį kaip state (tekstą, JSON arba vaizdus) su vienu ar daugiau klausimų. noul klausimo (taip arba ne) atveju rezultatas yra atsakymo „taip“ tikimybė. choice klausimo atveju rezultatas yra kiekvienos naudotojo apibrėžtos parinkties tikimybė. score klausimo atveju rezultatas yra kiekvieno jūsų vertinimo skalės lygio tikimybė ir tikėtinas balas.

Modelis turi du informacijos šaltinius: naudotojo siunčiamą būseną ir tai, ką išmoko mokymo metu. To pakanka tokiam klausimui kaip „Ar šioje apžvalgoje pranešama apie defektą?“ Tačiau to nepakanka atsakyti į klausimą „Ar šis asmuo vis dar yra generalinis direktorius?“ Atsakymas galėjo pasikeisti po mokymo, o būsenoje apie tai nieko nepasakyta. Pagrindimas žiniatinklio duomenimis prideda trečią šaltinį: žiniatinklį, kuriame ieškoma užklausos metu. Būsena taip pat gali būti URL, todėl naudotojas gali nukreipti modelį į tinklalapį, o ne pateikti tekstą.

Kaip veikia pagrindimas žiniatinklio duomenimis

Pagrindimas žiniatinklio duomenimis vyksta API šliuze prieš iškviečiant modelį. Kiekvienam užklausoje pateiktam klausimui šliuzas sudaro Fast Search užklausą. Užklausos vykdomos lygiagrečiai. Šliuzas sujungia rezultatus, pašalina pasikartojančius URL ir prideda įrodymus prie būsenos: pavadinimą, URL ir puslapio tekstą. Jei būsena yra URL, paieškos užklausoje perduodamas tas URL, todėl pats puslapis grąžinamas kaip įrodymas, o modelis atsako remdamasis jo tekstu. Modelis grąžina tikimybes taip pat, kaip ir bet kuriai kitai Decisions API užklausai. Jei paieška nepavyksta arba baigiasi jai skirtas laikas, modelis atsako remdamasis tais įrodymais, kurie buvo grąžinti. Atsakyme pateikiamas laukas search_results, kad naudotojas galėtų peržiūrėti, ką matė modelis. Naudotojo užklausa ir atsakymo struktūra išlieka tokios pačios. Keičiasi tik įrodymai, kuriuos modelis turi atsakydamas.

Pagrindimo žiniatinklio duomenimis testavimas

Tam pačiam sprendimų modeliui du kartus pateikėme 328 teiginius, kurie galėjo būti teisingi arba klaidingi: vieną kartą su pagrindimu žiniatinklio duomenimis, kitą – be jo. Teiginiai buvo padalyti į 2026 m. spalio mėnesio naujienas ir retus faktus iš Vikipedijos, o kiekvienas teisingas teiginys turėjo klaidingą dvynį, kuris skyrėsi viena detale. Būsenoje nebuvo pateikta jokių įrodymų.

Be pagrindimo žiniatinklio duomenimis Decisions API teisingai įvertino 56,4 % teiginių – beveik tiek pat, kiek spėjant atsitiktinai. Su pagrindimu žiniatinklio duomenimis teisingai įvertino 97,3 % teiginių, o klaidų sumažėjo nuo 143 iki 9. Kaina už tai – greitis: delsos mediana padidėjo nuo 139 ms iki 366 ms, o 95-ojo procentilio delsa – nuo 514 ms iki 742 ms.

PWS-Decisions

PWS-Decisions – tai viešas lyginamasis testas, sudarytas iš uždarųjų klausimų apie paskyrų tinkamumą, produktų galimybes, politikos taisykles ir sparčiai kintančius įvykius. 100 klausimų yra vieši ir vertinami pagal tikslų atitikimą etaloniniam atsakymui. 2026 m. lapkričio 4 d. pateikėme juos Decisions API + Web Grounding (pplx-decider-v1.2), ir šis teisingai atsakė į 86 iš jų. Kiti toliau pateikti rezultatai – tai testo autorių paskelbta lyderių lentelė. Jų nurodyti 51 % Decisions API be Web Grounding sutampa su mūsų pačių bandymo rezultatu.

Decisions API + Web Grounding užklausų atsakymo laiko mediana buvo 370 ms, o 95-asis procentilis – 685 ms; matavome iš savo kliento su 100 viešų klausimų. Lyginamojo testo autoriai nurodo 560 ms ir 710 ms savo API su visu 300 klausimų rinkiniu; jie matavo iš savo kliento 2026 m. spalio 29 d. Palyginti su paskelbta lyderių lentele, Decisions API + Web Grounding pasiekia didžiausią tikslumą viešajame rinkinyje, o atsakymo laiko mediana yra mažesnė nei 400 ms.

Ką gali sukurti kūrėjai

Įjunkite pagrindimą žiniatinklio duomenimis, kad atsakytumėte į klausimus, į kuriuos duomenys atsakyti negali: kai faktai pasikeitė po mokymo ir žiniatinklyje paskelbta naujos informacijos. Keli pavyzdžiai:

  • Kvalifikuokite klientų paskyras pagal naujausias naujienas. „Ar per pastarąsias 90 dienų pritraukė finansavimą?“ – patikrinama visame paskyrų sąraše.
  • Stebėkite įrankius, nuo kurių priklausote. „Ar yra stabili versija, naujesnė už mūsų užfiksuotąją?“ – tikrinama pagal tvarkaraštį.
  • Patvirtinkite prieš agentui imantis veiksmų. „Ar šis renginys vis dar vyksta?“ patikrinama prieš rezervuojant.

Kiekvienas atsakymas yra tikimybė, pagal kurią kūrėjo kodas gali imtis veiksmų, kartu su ją pagrindžiančiais žiniatinklio šaltiniais.

Kaip pradėti

Pridėkite "mode": "web_grounding" prie bet kurios Decisions API užklausos. Būsena (state) gali būti tekstas, pavyzdžiui, teiginys ar įrašas, arba URL.

Patikrinkite teiginį pagal žiniatinklio šaltinius:

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

Atsakyme pateikiamas laukas search_results – puslapiai, kuriuos perskaitė modelis. Lapkričio 4 d. ši užklausa grąžino didesnę nei 0,99 atsakymo „taip“ tikimybę, o pirmasis rezultatas buvo NASA erdvėlaivio įrašas.

Nukreipkite modelį į konkretų puslapį, perduodami jo URL kaip būseną (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?" } } }'

Perplexity Python bibliotekoje perduokite mode užklausos turinyje:

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)

Kiekviena užbaigta paieška kainuoja 0,001 USD papildomai prie įvesties žetonų kainos. Paieškos įrodymai įskaičiuojami į įvesties žetonus. Užklausoje, kurioje naudojamas Web Grounding, gali būti iki 100 klausimų.

Norėdami pradėti, peržiūrėkite pagrindimo žiniatinklio duomenimis dokumentaciją.