Decisions API 的網絡依據功能

AI 決策模型速度快、成本效益高，但它們只知道用戶傳送的內容，以及在訓練期間學到的知識。對於會變化的事實，例如某人是否仍是公司的行政總裁，或某產品是否已推出新版本，模型需要最新資訊才能準確回答。

由今天起，Perplexity 的 Decisions API 可以在作答前搜尋網絡。

將一項設定 "mode": "web_grounding" 加入任何 Decisions API 請求，Perplexity Fast Search 便會為每個問題執行一次查詢。結果會作為證據加入你的 state，讓決策模型根據網上當下的內容傳回機率。state 亦可以是網址，讓模型指向特定網頁，而無須輸入網頁文字。

在 PWS-Decisions（一項包含 100 條依賴最新網絡事實的問題的公開基準測試）上，準確率由 51% 提升至 86%，一般回應時間低於 400 毫秒。

決策模型會為每個問題傳回一個數值作為答案。用戶以 state 形式傳送內容（文字、JSON 或圖片），並附上一個或多個問題。對於 noul 問題（是或否），結果是「是」的機率。對於 choice 問題，結果是用戶所定義每個選項的機率。對於 score 問題，結果是評分準則中每個等級的機率，以及預期分數。

模型有兩個資訊來源：用戶傳送的 state，以及它在訓練期間學到的知識。這足以回答「這則評論是否報告了缺陷？」之類的問題，但不足以回答「這個人是否仍是行政總裁？」。答案可能在訓練後已有改變，而 state 中並無任何相關說明。網絡依據加入了第三個來源：在請求當下搜尋的網絡。state 亦可以是網址，讓用戶將模型指向網頁，而非文字。

Grounding 在 API 閘道中執行，時間在調用模型之前。對於請求中的每條問題，閘道都會建立一個 Fast Search 查詢。這些查詢會並行執行。閘道會合併結果、刪除重複的 URL，並將佐證資料附加到 state：標題、URL 及網頁文字。如果 state 是 URL，搜尋查詢便會帶有該 URL，因此該網頁本身會作為佐證資料傳回，模型則根據其文字作答。模型傳回機率的方式，與處理任何 Decisions API 請求時相同。如果搜尋失敗或逾時，模型會根據已傳回的佐證資料作答。回應包含 search_results，讓使用者可以查看模型看到的內容。使用者的請求和回應的結構都保持不變，改變的是模型作答時所掌握的佐證資料。

我們將 328 項是非陳述兩次傳送至同一個決策模型，一次啟用網絡依據，一次不啟用。這些陳述分為 2026 年 10 月的新聞和維基百科上的冷門事實，而每項真實陳述都有一項只在一個細節上不同的虛假對應陳述。state 中沒有提供任何證據。

未使用 Web Grounding 時，Decisions API 正確回答了 56.4% 的聲稱，接近隨機猜測。使用 Web Grounding 後，正確率達 97.3%，錯誤由 143 個減至 9 個。代價是速度：延遲中位數由 139 毫秒增至 366 毫秒，第 95 百分位延遲則由 514 毫秒增至 742 毫秒。

PWS-Decisions 是一個公開基準測試，包含有關帳戶資格、產品功能、政策規則及快速變化事件的封閉式問題。其中 100 條問題已公開，並以與參考答案完全相符為準評分。我們在 2026 年 11 月 4 日以 Decisions API + Web Grounding（pplx-decider-v1.2）執行這些問題，結果答對了 86 條。下方的其他結果為基準測試作者公佈的排行榜。他們公佈 Decisions API 在未使用 Web Grounding 時取得 51%，與我們自己的測試結果一致。

根據我們的用戶端針對 100 條公開問題的量度，Decisions API + Web Grounding 請求的回應時間中位數為 370 毫秒，第 95 百分位數為 685 毫秒。基準測試作者報告，其 API 在完整 300 條問題集上的數字為 560 毫秒和 710 毫秒，數據於 2026 年 10 月 29 日從他們的用戶端量度。與已發佈的排行榜相比，Decisions API + Web Grounding 的公開問題集準確率最高，而回應時間中位數低於 400 毫秒。

啟用網絡依據，回答數據無法解答的問題：當事實在訓練後已有改變，而網上已發佈新資訊時。以下是一些例子：

根據最新消息評估客戶資格。針對整份客戶名單查詢「過去 90 天內有否完成融資？」。
追蹤你所依賴的工具。定期檢查「是否有比我們鎖定版本更新的穩定版本？」。
在 AI 代理程式採取行動前先確認。在預訂前先檢查「這項活動是否仍會舉行？」。

每個答案都是開發人員的程式碼可據以採取行動的機率，並附有其背後的網絡來源。

在任何 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，即模型讀過的網頁。在 11 月 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)

除輸入 token 外，每次完成的搜尋另收費 $0.001。搜尋所得的佐證資料會計入輸入 token。使用 Web Grounding 的請求最多可包含 100 條問題。

瀏覽Web Grounding 文件，立即開始使用。

決策模型的運作方式

網絡依據的運作方式

測試網絡依據

PWS-Decisions

開發人員可以構建的應用

開始使用