Tīmekļa pamatošana Decisions API

MI lēmumu modeļi ir ātri un izmaksu ziņā efektīvi, taču tie zina tikai to, ko lietotāji tiem nosūta, un to, ko tie apguva apmācības laikā. Lai precīzi atbildētu uz jautājumiem par mainīgiem faktiem, piemēram, vai kāds joprojām ir uzņēmuma izpilddirektors, vai produktam ir iznākusi jauna versija, modelim ir nepieciešama aktuāla informācija.

Sākot ar šodienu, Perplexity Decisions API pirms atbildes var meklēt tīmeklī.

Pievienojiet vienu iestatījumu, "mode": "web_grounding", jebkuram Decisions API pieprasījumam, un Perplexity Fast Search izpildīs vienu vaicājumu katram jautājumam. Rezultāti tiek pievienoti jūsu parametram state kā pierādījumi, tāpēc lēmumu modelis atgriež varbūtības, kuru pamatā ir tas, kas tīmeklī ir pieejams tieši tagad. Parametrs state var būt arī URL, lai novirzītu modeli uz konkrētu tīmekļa lapu, nevis ievadītu tās tekstu.

Etalontestā PWS-Decisions — publiskā etalontestā ar 100 jautājumiem, kuru atbildes ir atkarīgas no aktuāliem tīmekļa faktiem, — precizitāte pieauga no 51% līdz 86%, un tipiskais atbildes laiks bija zem 400 ms.

Lēmumu modelis uz katru jautājumu atbild ar skaitli. Lietotāji nosūta saturu kā state (tekstu, JSON vai attēlus) ar vienu vai vairākiem jautājumiem. noul tipa jautājumam (jā vai nē) rezultāts ir varbūtība, ka atbilde ir „jā”. choice tipa jautājumam rezultāts ir varbūtība katrai lietotāja definētajai opcijai. score tipa jautājumam rezultāts ir varbūtība katram jūsu vērtēšanas skalas līmenim un sagaidāmais vērtējums.

Modelim ir divi informācijas avoti: lietotāja nosūtītais state un tas, ko modelis apguva apmācības laikā. Ar to pietiek tādam jautājumam kā „Vai šajā atsauksmē ir ziņots par defektu?”. Ar to nepietiek, lai atbildētu uz jautājumu „Vai šī persona joprojām ir izpilddirektors?”. Atbilde var būt mainījusies pēc apmācības, un state par to neko neliecina. Tīmekļa pamatošana pievieno trešo avotu: tīmekli, kurā meklēšana notiek pieprasījuma brīdī. Parametrs state var būt arī URL, tāpēc lietotājs var novirzīt modeli uz tīmekļa lapu, nevis sniegt tekstu.

Pamatošana notiek API vārtejā pirms modeļa izsaukuma. Katram pieprasījumā iekļautajam jautājumam vārteja izveido Fast Search vaicājumu. Vaicājumi tiek izpildīti paralēli. Vārteja apvieno rezultātus, atmet dublētos URL un pievieno pierādījumus state vērtībai: virsrakstu, URL un lapas tekstu. Ja state ir URL, meklēšanas vaicājumā tiek iekļauts šis URL, tāpēc pati lapa tiek atgriezta kā pierādījums un modelis atbild, balstoties uz tās tekstu. Modelis atgriež varbūtības tāpat kā jebkuram citam Decisions API pieprasījumam. Ja meklēšana neizdodas vai pārsniedz laika limitu, modelis atbild, izmantojot tos pierādījumus, kas tika atgriezti. Atbildē ir iekļauts lauks search_results, lai lietotājs varētu redzēt, ko redzēja modelis. Lietotāja pieprasījums un atbildes struktūra paliek nemainīgi. Mainās pierādījumi, kas modelim ir pieejami, kad tas atbild.

Mēs nosūtījām 328 apgalvojumus, kas ir patiesi vai nepatiesi, vienam un tam pašam lēmumu modelim divreiz — vienreiz ar tīmekļa pamatošanu un vienreiz bez tās. Apgalvojumi tika sadalīti starp 2026. gada oktobra ziņām un retiem faktiem no Vikipēdijas, un katram patiesajam apgalvojumam bija nepatiess dvīnis, kas atšķīrās vienā detaļā. Parametrā state netika sniegti nekādi pierādījumi.

Bez tīmekļa pamatošanas Decisions API pareizi novērtēja 56,4 % apgalvojumu, kas ir tuvu nejaušai minēšanai. Ar tīmekļa pamatošanu tas pareizi novērtēja 97,3 %, samazinot kļūdu skaitu no 143 līdz 9. Kompromiss ir ātrums: latentuma mediāna pieauga no 139 ms līdz 366 ms, bet 95. procentiles latentums — no 514 ms līdz 742 ms.

PWS-Decisions ir publisks etalontests ar slēgta tipa jautājumiem par kontu kvalifikāciju, produktu iespējām, politikas noteikumiem un strauji mainīgiem notikumiem. 100 jautājumi ir publiski, un tos vērtē pēc precīzas atbilstības atsauces atbildei. Mēs tos izpildījām ar Decisions API + Web Grounding (pplx-decider-v1.2) 2026. gada 4. novembrī, un tas pareizi atbildēja uz 86 jautājumiem. Pārējie tālāk norādītie rezultāti ir etalontesta autoru publicētā līderu tabula. Viņu iegūtais 51 % rezultāts Decisions API bez Web Grounding sakrīt ar mūsu pašu testa rezultātu.

Decisions API + Web Grounding pieprasījumi tika izpildīti 370 ms (mediāna) un 685 ms (95. procentile), mērot no mūsu klienta ar 100 publiskajiem jautājumiem. Etalontesta autori savam API norāda 560 ms un 710 ms ar pilno 300 jautājumu kopu, mērot no sava klienta 2026. gada 29. oktobrī. Salīdzinot ar publicēto līderu tabulu, Decisions API + Web Grounding ir augstākā precizitāte publiskajā kopā un mediānais atbildes laiks zem 400 ms.

Iespējojiet tīmekļa pamatošanu, lai atbildētu uz jautājumiem, uz kuriem dati vien atbildēt nevar: kad fakti ir mainījušies pēc apmācības un tīmeklī ir publicēta jauna informācija. Daži piemēri:

Kvalificējiet kontus pēc jaunākajām ziņām. „Vai pēdējo 90 dienu laikā ir piesaistīts finansējums?” – visā kontu sarakstā.
Sekojiet līdzi rīkiem, no kuriem esat atkarīgi. „Vai ir pieejams stabils laidiens, kas ir jaunāks par mūsu fiksēto versiju?” – tas tiek pārbaudīts pēc grafika.
Pārbaudiet, pirms aģents rīkojas. „Vai šis pasākums joprojām notiks?” – pārbauda pirms rezervēšanas.

Katra atbilde ir varbūtība, uz kuras pamata izstrādātāja kods var rīkoties, kopā ar tīmekļa avotiem, uz kuriem tā balstīta.

Pievienojiet "mode": "web_grounding" jebkuram Decisions API pieprasījumam. Vērtība state var būt teksts, piemēram, apgalvojums vai ieraksts, vai arī URL.

Pārbaudiet apgalvojumu, izmantojot tīmekli:

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

Atbildē tiek pievienots lauks search_results — lapas, kuras modelis izlasīja. 4. novembrī šis pieprasījums atgrieza atbildes „jā” varbūtību virs 0,99, un pirmais rezultāts bija NASA kosmosa kuģa ieraksts.

Novirziet modeli uz lapu, nododot tās URL kā state vērtību:

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 bibliotēkā nododiet mode pieprasījuma pamattekstā:

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)

Katra pabeigta meklēšana maksā 0,001 $ papildus ievades tokeniem. Meklēšanas pierādījumi tiek ieskaitīti ievades tokenos. Pieprasījumā, kurā tiek izmantota funkcija Web Grounding, var iekļaut līdz 100 jautājumiem.

Sāciet darbu, iepazīstoties ar tīmekļa pamatošanas dokumentāciju.

Kā darbojas lēmumu modelis

Kā darbojas tīmekļa pamatošana

Tīmekļa pamatošanas testēšana

PWS-Decisions

Ko izstrādātāji var izveidot

Darba sākšana