Context API 可从任意网页提取完整上下文

使用 Perplexity Context API,从缓存或实时网页中为 AI 智能体提供干净的 Markdown、链接和相关段落。

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

当有人向聊天机器人提问时,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 通知、导航或广告)的比例,按所有 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日