Decisions API үшін веб-негіздеу

ЖИ шешім модельдері жылдам әрі үнемді, бірақ олар тек пайдаланушылар жіберген деректерді және оқыту кезінде үйренгенін ғана біледі. Өзгеретін фактілер туралы сұрақтарға, мысалы, біреудің әлі де компанияның бас директоры екені немесе өнімнің жаңа нұсқасы шыққаны туралы сұрақтарға дәл жауап беру үшін модельге өзекті ақпарат қажет.

Бүгіннен бастап Perplexity Decisions API жауап бермес бұрын интернеттен іздей алады.

Бір параметрді — "mode": "web_grounding" — кез келген Decisions API сұрауына қосыңыз, сонда Perplexity Fast Search әр сұрақ үшін бір іздеу сұрауын орындайды. Нәтижелер state өрісіне дәлел ретінде қосылады, сондықтан шешім моделі дәл қазір интернетте бар ақпаратқа негізделген ықтималдықтарды қайтарады. Сондай-ақ модельді белгілі бір веб-бетке бағыттау үшін оның мәтінін енгізудің орнына state өрісінде URL мекенжайын көрсетуге болады.

Ағымдағы веб-фактілерге тәуелді 100 сұрақтан тұратын ашық бенчмарк PWS-Decisions бойынша дәлдік 51%-дан 86%-ға дейін өсті, ал әдеттегі жауап уақыты 400 мс-тан аз болды.

Шешім моделі әр сұраққа жауап ретінде сан қайтарады. Пайдаланушылар мазмұнды state ретінде (мәтін, JSON немесе суреттер) бір немесе бірнеше сұрақпен бірге жібереді. noul сұрағы (иә немесе жоқ) үшін нәтиже — «иә» жауабының ықтималдығы. choice сұрағы үшін нәтиже — пайдаланушы анықтаған әр нұсқаның ықтималдығы. score сұрағы үшін нәтиже — бағалау шкалаңыздың әр деңгейінің ықтималдығы және күтілетін балл.

Модельдің екі ақпарат көзі бар: пайдаланушы жіберетін state және оқыту кезінде үйренгені. Бұл «Бұл пікірде ақау туралы айтылған ба?» сияқты сұраққа жеткілікті. Бірақ «Бұл адам әлі де бас директор ма?» деген сұраққа жауап беруге жеткіліксіз. Жауап оқытудан кейін өзгеруі мүмкін, ал state өрісінде бұл туралы ештеңе айтылмайды. Веб-негіздеу үшінші дереккөзді қосады: сұрау кезінде ізделетін интернет. Сондай-ақ state өрісі URL болуы мүмкін, сондықтан пайдаланушы модельді мәтіннің орнына веб-бетке бағыттай алады.

Grounding API шлюзінде модель шақырылмас бұрын орындалады. Сұраудағы әрбір сұрақ үшін шлюз Fast Search іздеу сұранысын құрады. Сұраныстар қатар орындалады. Шлюз нәтижелерді біріктіреді, қайталанатын URL мекенжайларын алып тастайды және дәлелдерді state өрісіне қосады: тақырып, URL және бет мәтіні. Егер state өрісі URL болса, іздеу сұранысы сол URL мекенжайын қамтиды, сондықтан беттің өзі дәлел ретінде қайтарылады және модель оның мәтініне сүйеніп жауап береді. Модель кез келген басқа Decisions API сұрауындағыдай ықтималдықтарды қайтарады. Егер іздеу сәтсіз аяқталса немесе күту уақыты өтіп кетсе, модель қайтарылған дәлелдердің негізінде жауап береді. Пайдаланушы модель нені көргенін көре алуы үшін жауапта search_results өрісі болады. Пайдаланушы сұрауы мен жауап құрылымы өзгермейді. Өзгеретіні — модель жауап берген кездегі оның қолындағы дәлелдер.

Біз бір шешім моделіне 328 шын немесе жалған тұжырымды екі рет жібердік: бір рет веб-негіздеумен, бір рет онсыз. Тұжырымдар 2026 жылғы қазандағы жаңалықтар мен Уикипедиядағы сирек фактілерге бөлінді, ал әр шын тұжырымның бір ғана детальмен ерекшеленетін жалған егізі болды. Сұраудың state өрісінде ешқандай дәлел берілмеді.

Web Grounding қолданылмағанда Decisions API тұжырымдардың 56,4 пайызына дұрыс жауап берді, бұл кездейсоқ болжауға жақын. Web Grounding қолданылғанда ол 97,3% жағдайда дұрыс жауап беріп, қателер санын 143-тен 9-ға дейін азайтты. Оның есесіне жылдамдық төмендейді: кідірістің медианасы 139 мс-тан 366 мс-қа дейін, ал 95-процентильдік кідіріс 514 мс-тан 742 мс-қа дейін өсті.

PWS-Decisions — аккаунттың талаптарға сай келуі, өнім мүмкіндіктері, саясат ережелері және жылдам өзгеретін оқиғалар туралы жабық сұрақтардан тұратын ашық бенчмарк. 100 сұрақ жалпыға қолжетімді және эталондық жауаппен дәл сәйкестік бойынша бағаланады. Біз оларды 2026 жылғы 4 қарашада Decisions API + Web Grounding (pplx-decider-v1.2) арқылы іске қостық, және ол 86 сұраққа дұрыс жауап берді. Төмендегі басқа нәтижелер — бенчмарк авторлары жариялаған көшбасшылар кестесі. Олардың Web Grounding қолданылмаған Decisions API үшін көрсеткен 51% нәтижесі біздің өз сынағымыздың нәтижесімен сәйкес келеді.

Decisions API + веб-негіздеу сұраулары 100 ашық сұрақ бойынша біздің клиенттен өлшегенде медиана бойынша 370 мс, ал 95-процентильде 685 мс ішінде қайтарылды. Бенчмарк авторлары 300 сұрақтан тұратын толық жиында өз API-і үшін 560 мс және 710 мс нәтижесін хабарлайды, ол 2026 жылғы 29 қазанда олардың клиентінен өлшенген. Жарияланған көшбасшылар кестесімен салыстырғанда Decisions API + веб-негіздеу ашық жиында ең жоғары дәлдікке және 400 мс-тан аз медианалық жауап уақытына ие.

Деректер жауап бере алмайтын сұрақтарға жауап алу үшін веб-негіздеуді қосыңыз: фактілер оқытудан кейін өзгерген және интернетте жаңа ақпарат жарияланған жағдайлар. Бірнеше мысал:

Клиенттерді соңғы жаңалықтар негізінде іріктеңіз. «Соңғы 90 күнде қаржыландыру тартты ма?» — бүкіл клиенттер тізімі бойынша.
Өзіңіз тәуелді құралдарды бақылаңыз. «Біз бекіткен нұсқадан жаңарақ тұрақты шығарылым бар ма?» — кесте бойынша тексеріледі.
Агент әрекет етпес бұрын растаңыз. «Бұл іс-шара әлі де өте ме?» — брондау алдында тексеріледі.

Әр жауап — әзірлеушінің коды негізге ала алатын ықтималдық және оған негіз болған веб-дереккөздер.

Кез келген Decisions API сұрауына "mode": "web_grounding" параметрін қосыңыз. Мұндағы state өрісі мәтін (мысалы, тұжырым немесе жазба) не 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": "Claim: The James Webb Space Telescope launched in December 2021.",
    "questions": {
      "supported": {
        "type": "noul",
        "instructions": "Is the claim true?"
      }
    }
  }'

Жауапқа search_results өрісі қосылады — бұл модель оқыған беттер. 4 қарашада бұл сұрау «иә» жауабының ықтималдығын 0,99-дан жоғары деп қайтарды, ал бірінші нәтиже NASA-ның ғарыш аппараты туралы жазбасы болды.

Модельді белгілі бір бетке бағыттау үшін оның URL мекенжайын 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 кітапханасында mode параметрін сұрау денесінде беріңіз:

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)

Әрбір аяқталған іздеу кіріс токендеріне қосымша 0,001 $ тұрады. Іздеу дәлелдері кіріс токендеріне есептеледі. Web Grounding қолданылатын сұрауда 100-ге дейін сұрақ болуы мүмкін.

Бастау үшін Web Grounding құжаттамасымен танысыңыз.

Шешім моделі қалай жұмыс істейді

Веб-негіздеу қалай жұмыс істейді

Веб-негіздеуді сынау

PWS-Decisions

Әзірлеушілер не жасай алады

Бастау