Web grounding til Decisions API
Forankr beslutninger i aktuelle fakta fra nettet med Perplexitys Decisions API. Tilføj livesøgning for præcise og opdaterede svar.

AI-beslutningsmodeller er hurtige og omkostningseffektive, men de kender kun det, brugerne sender til dem, og det, de lærte under træningen. Ved spørgsmål om fakta, der ændrer sig – fx om en person stadig er administrerende direktør i en virksomhed, eller om et produkt har fået en ny version – har en model brug for opdaterede oplysninger for at kunne svare præcist.
Fra i dag kan Perplexitys Decisions API søge på nettet, før den svarer.
Tilføj én indstilling, "mode": "web_grounding", til enhver Decisions API-anmodning, og Perplexity Fast Search kører én forespørgsel for hvert spørgsmål. Resultaterne føjes til dit state-felt som evidens, så beslutningsmodellen returnerer sandsynligheder baseret på det, der står på nettet lige nu. State kan også være en URL, der peger modellen mod en bestemt webside, i stedet for at du indtaster sidens tekst.
På PWS-Decisions, et offentligt benchmark med 100 spørgsmål, der afhænger af aktuelle fakta på nettet, steg nøjagtigheden fra 51 % til 86 % med typiske svartider på under 400 ms.
Sådan fungerer en beslutningsmodel
En beslutningsmodel returnerer et tal som svar på hvert spørgsmål. Brugere sender indhold som state (tekst, JSON eller billeder) sammen med et eller flere spørgsmål. For et noul-spørgsmål (ja eller nej) er resultatet sandsynligheden for ja. For et choice-spørgsmål er resultatet en sandsynlighed for hver mulighed, som brugeren definerer. For et score-spørgsmål er resultatet en sandsynlighed for hvert niveau i din vurderingsskala samt den forventede score.
Modellen har to informationskilder: det state-felt, en bruger sender, og det, den lærte under træningen. Det er nok til et spørgsmål som »Rapporterer denne anmeldelse en defekt?« Det er ikke nok til at besvare »Er denne person stadig administrerende direktør?« Svaret kan have ændret sig efter træningen, og intet i state-feltet siger det. Web grounding tilføjer en tredje kilde: nettet, gennemsøgt på tidspunktet for anmodningen. State kan også være en URL, så en bruger kan pege modellen mod en webside i stedet for tekst.
Sådan fungerer web grounding
Grounding kører i API-gatewayen før modelkaldet. For hvert spørgsmål i en anmodning opbygger gatewayen en Fast Search-forespørgsel. Forespørgslerne kører parallelt. Gatewayen fletter resultaterne, fjerner dublerede URL'er og føjer belægget til state: titel, URL og sidetekst. Hvis state er en URL, indeholder søgeforespørgslen den URL, så selve siden kommer tilbage som belæg, og modellen svarer ud fra dens tekst. Modellen returnerer sandsynligheder på samme måde som ved enhver anden Decisions API-anmodning. Hvis en søgning mislykkes eller får timeout, svarer modellen ud fra det belæg, der kom tilbage. Svaret indeholder search_results, så en bruger kan se, hvad modellen så. En brugers anmodning og svarets struktur forbliver de samme. Det, der ændrer sig, er det belæg, modellen har, når den svarer.
Test af web grounding
Vi sendte 328 sand-eller-falsk-påstande til den samme beslutningsmodel to gange: én gang med web grounding og én gang uden. Påstandene var fordelt mellem nyheder fra oktober 2026 og sjældne fakta fra Wikipedia, og hver sand påstand havde en falsk tvilling, der adskilte sig på én detalje. Der blev ikke leveret nogen evidens i state-feltet.
Uden web grounding besvarede Decisions API 56,4 procent af påstandene korrekt, hvilket er tæt på at gætte. Med web grounding besvarede det 97,3 % korrekt og reducerede antallet af fejl fra 143 til 9. Prisen er hastighed: Medianlatenstiden steg fra 139 ms til 366 ms, og latenstiden ved 95. percentil fra 514 ms til 742 ms.
PWS-Decisions
PWS-Decisions er et offentligt benchmark med lukkede spørgsmål om kontokvalificering, produktfunktioner, politikregler og begivenheder i hurtig udvikling. 100 spørgsmål er offentlige og bedømmes ved nøjagtigt match med et referencesvar. Vi kørte dem mod Decisions API + Web Grounding (pplx-decider-v1.2) den 4. november 2026, og det besvarede 86 korrekt. De øvrige resultater nedenfor er benchmarkforfatternes offentliggjorte rangliste. Deres 51 % for Decisions API uden Web Grounding svarer til vores egen kørsel.
Anmodninger til Decisions API + Web Grounding blev besvaret på 370 ms i medianen og 685 ms ved 95. percentil, målt fra vores klient på de 100 offentlige spørgsmål. Benchmarkets forfattere rapporterer 560 ms og 710 ms for deres API på det fulde sæt med 300 spørgsmål, målt fra deres klient den 29. oktober 2026. Sammenlignet med den offentliggjorte rangliste har Decisions API + Web Grounding den højeste nøjagtighed på det offentlige sæt og en mediansvartid på under 400 ms.
Hvad udviklere kan bygge
Aktivér web grounding for at besvare spørgsmål, som data ikke kan: når fakta har ændret sig efter træningen, og der er offentliggjort nye oplysninger på nettet. Nogle eksempler:
- Kvalificer konti ud fra de seneste nyheder. »Har rejst kapital inden for de seneste 90 dage?« på tværs af en hel kontoliste.
- Hold øje med de værktøjer, du er afhængig af. »Findes der en stabil version, der er nyere end vores fastlåste version?« gennemgås efter en fast tidsplan.
- Bekræft, før en agent handler. »Bliver dette arrangement stadig afholdt?« tjekkes, før agenten booker.
Hvert svar er en sandsynlighed, som en udviklers kode kan handle ud fra, sammen med de webkilder, der ligger bag.
Kom i gang
Tilføj "mode": "web_grounding" til enhver Decisions API-anmodning. Værdien af state kan være tekst, f.eks. en påstand eller en registrering, eller en URL.
Tjek en påstand mod nettet:
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?"
}
}
}'Svaret tilføjer search_results, de sider, modellen læste. Den 4. november returnerede dette en sandsynlighed for ja på over 0,99 med NASA's registrering af rumfartøjet som første resultat.
Peg modellen mod en side ved at angive dens URL som state:
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?"
}
}
}'I Perplexity Python-biblioteket angiver du mode i anmodningens brødtekst:
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)Hver gennemført søgning koster 0,001 USD ud over input-tokens. Søgebelæg tæller med i input-tokens. En anmodning, der bruger Web Grounding, kan indeholde op til 100 spørgsmål.
Kom i gang ved at udforske dokumentationen til web grounding.