Context API 可從任何網頁擷取完整上下文
使用 Perplexity Context API,從快取或即時網頁中為 AI 代理程式提供整潔的 Markdown、連結和相關段落。

當有人向聊天機械人提問時,AI 代理程式可能需要閱讀多個網頁才能作答。標準搜尋結果通常只會傳回片段。直接擷取網頁則可能傳回原始 HTML,當中充斥導覽列、Cookie 橫額和廣告。代理程式需要以模型可用的格式取得網頁的上下文,而開發人員則需要一種方法來控制這些上下文必須有多新。
今天,我們推出 Perplexity Context API,可讀取最多 10 個 URL,並為每個網頁傳回整潔的 Markdown、HTML、連結,以及基於查詢的片段。資料來自 Perplexity 龐大的網絡索引或即時擷取。代理程式可以為每個請求指定內容的新鮮度,並驗證每項結果的來源。
Context API 支援多種格式
代理程式只需提供 URL 清單並指定輸出格式,即可發出請求。API 會按相同次序為每個 URL 傳回一項結果。
Context API 支援多種回應格式:
- Markdown:以整潔 Markdown 呈現的網頁內容,可直接放入模型的上下文。
- HTML:網頁的 HTML,適用於自行執行解析的應用程式。
- 連結:網頁上的連結,以絕對 URL 呈現,已移除重複項目並按網頁中的次序排列,方便代理程式決定下一步前往哪裏。
- 片段:網頁中與所提供查詢最相關的段落,長度以開發人員為每個網頁設定的 token 上限為準。
Context API 會從每個網頁中選取與查詢相關的段落,而不是生成摘要。因此,模型收到的是網頁的原文措辭,但只限於所選段落,需要處理的文字因而較少。
每項成功的結果亦包含標題、描述、語言、作者和發佈日期等元數據,以及網頁的 Open Graph 標籤。為了建立 Markdown,Context API 會將網頁拆分成多個區塊,再由模型將每個區塊評定為主要內容或樣板內容。只有內容區塊會被保留。
對需要掌握全貌的任務至關重要
找到相關網頁未必足以完成工作。透過 Context API,代理程式可以從選定的 URL 擷取所需內容,以完成複雜任務。
- 實作 API 整合:搜尋結果或許能找到正確的文件,卻未必包含所需的參數、身份驗證說明或錯誤情況。Context API 可協助編程代理程式擷取相關文件和 API 參考資料,以根據這些細節編寫整合程式。
- 比較現行價格:標示的價格可能取決於搜尋摘錄中沒有提及的使用上限、計費條款或資格條件。代理程式可以要求即時擷取選定的定價頁面,並在作比較前先閱讀這些條件。
- 解答政策問題:退貨政策摘錄可能只列明標準退貨期限,卻遺漏了特定產品或地區的例外情況。客戶支援代理程式可以擷取政策頁面,讓答案顧及這些例外情況。
- 跨多個來源進行研究:搜尋摘錄或會呈現某項研究發現,卻沒有附上研究方法、限定條件或相關論證。研究代理程式可以擷取選定的文章和報告,然後比較當中的證據,而不是單靠摘錄。
控制新鮮度,可靠地處理 URL
根據預設,Context API 會先在 Perplexity 的網絡索引中查找過去兩天內擷取的網頁副本。如果沒有,便會即時擷取該網頁。如需取得價格、比分和突發新聞,開發人員可將 max_age_seconds 設為 0,以便一律讀取即時網頁。至於甚少變動的參考資料,則可以調高此值。對於絕不應觸發即時請求的工作負載,可將 cache_only 設為 true。
每項結果都會記錄內容來自已儲存的副本還是即時擷取,以及擷取的時間。
請求中的 URL 會並行擷取,每個 URL 都有各自的時間預算和狀態。即使某個網頁載入緩慢或無法使用,也不會導致其他網頁失敗。狀態會顯示每個 URL 的處理情況,因此代理程式可以只重試逾時的網頁,並保留其餘結果。
Context API 傳回可用且完整的內容
我們以 1,000 個從真實代理程式擷取請求中抽樣的 URL,將 Context API 與 Firecrawl、Exa、Parallel、Keenable 和 Context.dev 進行比較測試。這組樣本涵蓋 715 個網站,包括政府和學術來源,以及非英文網頁。其後,由另一個獨立的評審模型在不知道每項輸出由哪個供應商產生的情況下為輸出評分。
圖表按三項準則衡量表現:
- 可用性:傳回網頁真實內容(而非錯誤頁面或空白結果)的 URL 所佔比例。
- 事實召回率:評審模型會彙集所有供應商在某網頁上找到的關鍵事實,然後檢查每項輸出包含其中哪些事實。擷取失敗計零分。
- 內容精確度:傳回的文字中屬於頁面內容(而非 Cookie 通知、導航或廣告)的比例,按所有網址計算平均值。擷取失敗的網址計為零分。
在今次評估中,Context API 為 92.3% 的網址傳回可用內容,取回 87.9% 的關鍵事實,內容精確度得分為 80.3%。
定價
Context API 的收費為每擷取 1,000 個 URL 1 美元。開發人員只需為每個傳回 ok 的 URL 付費。擷取失敗的 URL 不會收費。
開始使用
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 參考資料。