Context API 可從任何網頁擷取完整上下文

使用 Perplexity Context API,從快取或即時網頁為 AI 代理程式提供乾淨的 Markdown、連結和相關段落。

Context API artwork with a luminous mineral cross-section and geometric lines.

當有人向聊天機器人提問時,AI 代理程式可能需要閱讀好幾個網頁才能回答。一般的搜尋結果往往只會傳回片段。直接擷取網頁則可能傳回原始 HTML,其中充斥著導覽列、Cookie 橫幅和廣告。AI 代理程式需要以模型能夠使用的格式取得網頁的上下文,而開發人員則需要一種方式,來控制這些上下文必須有多新。

今天,我們推出 Perplexity Context API,它最多可讀取 10 個 URL,並為每個網頁傳回乾淨的 Markdown、HTML、連結,以及依據查詢產生的片段。這些資訊來自 Perplexity 龐大的網路索引或即時擷取。AI 代理程式可以指定每個請求的資料新鮮度,並驗證每個結果的來源。

Context API 支援多種格式

AI 代理程式只要提供 URL 清單並指定輸出格式,即可發出請求。API 會依相同順序,為每個 URL 傳回一個結果。

Context API 支援多種回應格式:

  • Markdown:以乾淨的 Markdown 呈現網頁內容,可直接放入模型的上下文中。
  • HTML:網頁的 HTML,適用於自行執行剖析的應用程式。
  • 連結:網頁上的連結,以絕對 URL 呈現、去除重複項目,並依網頁中的順序排列,讓 AI 代理程式能決定下一步要前往哪裡。
  • 片段:網頁中與所提供查詢最相關的段落,並受開發人員為每個網頁設定的 token 上限所限制。

Context API 會從每個網頁中挑選與查詢相關的段落,而不是產生摘要。因此,模型收到的是網頁的原始文字,但僅限於所選段落,需要處理的文字量也就更少。

每個成功的結果也都包含標題、描述、語言、作者和發布日期等中繼資料,以及網頁的 Open Graph 標籤。為了產生 Markdown,Context API 會將網頁拆分成多個區塊,再由模型判定每個區塊屬於主要內容還是樣板內容,並只保留內容區塊。

對需要掌握全貌的任務至關重要

找到相關網頁不一定足以完成工作。透過 Context API,AI 代理程式可以從所選 URL 擷取所需內容,以完成複雜的任務。

  • 實作 API 整合:搜尋結果或許能找出正確的說明文件,卻不包含必要的參數、身分驗證說明或錯誤情境。Context API 可協助程式設計 AI 代理程式擷取說明文件和 API 參考資料,並根據這些細節撰寫整合程式。
  • 比較目前價格:標示的價格可能取決於使用量限制、計費條款或資格條件,而這些資訊往往不在搜尋摘錄中。AI 代理程式可以要求即時擷取所選的定價頁面,在進行比較前先讀取這些條件。
  • 回答政策問題:退貨政策摘錄可能載明標準退貨期限,卻遺漏特定產品或地區的例外情況。客服 AI 代理程式可以擷取政策頁面,讓回答將這些例外情況納入考量。
  • 跨多個來源進行研究:搜尋摘錄可能呈現某項研究發現,卻未包含研究方法、限定條件或前後論述。研究 AI 代理程式可以擷取所選的文章和報告,再比較其中的證據,而不只是仰賴摘錄。

控制資料新鮮度,並可靠地處理 URL

根據預設,Context API 會先檢查 Perplexity 的網路索引中,是否有過去兩天內擷取的網頁副本。如果沒有,就會即時擷取該網頁。對於價格、比分和突發新聞,開發人員可以將 max_age_seconds 改為 0,以一律讀取即時網頁。對於很少變動的參考資料,則可以調高此值。若工作負載絕不應觸發即時請求,請將 cache_only 設為 true。

每個結果都會記錄內容是來自儲存的副本還是即時擷取,以及擷取的時間。

請求中的 URL 會平行擷取,每個 URL 都有各自的時間預算和狀態。單一網頁緩慢或損壞,並不會導致其他網頁失敗。狀態會顯示每個 URL 的處理結果,讓 AI 代理程式只需重試逾時的網頁,並保留其餘結果。

Context API 傳回可用且完整的內容

我們從真實 AI 代理程式的擷取請求中抽樣 1,000 個 URL,將 Context API 與 Firecrawl、Exa、Parallel、Keenable 和 Context.dev 進行比較測試。這組樣本涵蓋 715 個網站,包括政府與學術來源以及非英文網頁。接著,由另一個獨立的評審模型在不知道各輸出由哪個供應商產生的情況下,為這些輸出評分。

此圖表依三項標準衡量效能:

  • 可用性:傳回網頁實際內容(而非錯誤頁面或空白結果)的 URL 比例。
  • 事實召回率:評審模型會彙整所有供應商在某個網頁上找到的關鍵事實,再檢查每個輸出包含其中哪些事實。擷取失敗則計為零分。
  • 內容精確度:傳回的文字中屬於頁面內容(而非 Cookie 通知、導覽列或廣告)的比例,並以所有 URL 的平均值計算。擷取失敗者計為零分。

在本次評估中,Context API 為 92.3% 的 URL 傳回了可用內容,找回 87.9% 的關鍵事實,內容精確度得分為 80.3%。

定價

Context API 每擷取 1,000 個 URL 收費 1 美元。開發人員只需為傳回 ok 的每個 URL 付費,失敗的 URL 不會計費。

開始使用

bash
curl --request POST https://api.perplexity.ai/v1/context \ --header "Authorization: Bearer $PERPLEXITY_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "urls": ["https://info.cern.ch/hypertext/WWW/TheProject.html"], "formats": ["markdown"] }'

每個結果都會附上網頁的 Markdown、符合查詢的段落、網頁中繼資料和狀態。使用結果的內容前,請先檢查每個結果的狀態。

請閱讀 Context API 說明文件,或參閱 API 參考資料。

  1. Orchestrator:一個 API,實現可靠推論開發者2026年11月17日
  2. 隆重推出 Perplexity 的 Monitor API開發者2026年11月16日