Context API извлекает полный контекст из любой веб-страницы

Используйте Perplexity Context API, чтобы предоставлять ИИ-агентам чистый Markdown, ссылки и релевантные отрывки из кешированных или загружаемых в реальном времени веб-страниц.

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

Когда пользователь задаёт чат-боту вопрос, ИИ-агенту может понадобиться прочитать несколько веб-страниц, чтобы на него ответить. Стандартные результаты поиска часто содержат лишь фрагменты. Прямая загрузка страницы может вернуть необработанный HTML, полный навигационных элементов, баннеров о файлах cookie и рекламы. Агентам нужен контекст страницы в формате, с которым может работать модель, а разработчикам — способ управлять тем, насколько свежим должен быть этот контекст.

Сегодня мы запускаем Perplexity Context API: он считывает до 10 URL-адресов и возвращает для каждой страницы чистый Markdown, HTML, ссылки и фрагменты по запросу. Данные берутся из обширного веб-индекса Perplexity или загружаются в реальном времени. Агенты могут задавать требуемую свежесть данных для каждого запроса и проверять источник каждого результата.

Context API поддерживает множество форматов

Агенты могут отправить запрос, передав список URL-адресов и указав форматы вывода. API возвращает результат для каждого URL-адреса в том же порядке.

Context API поддерживает различные форматы ответа:

  • Markdown: Содержимое страницы в виде чистого Markdown, готового к добавлению в контекст модели.
  • HTML: HTML-код страницы для приложений, которые выполняют синтаксический анализ самостоятельно.
  • Ссылки: Ссылки на странице в виде абсолютных URL-адресов — без дубликатов и в порядке их следования на странице, чтобы агент мог решить, куда перейти дальше.
  • Фрагменты: Отрывки страницы, наиболее релевантные заданному запросу, в пределах лимита токенов, который разработчик устанавливает для каждой страницы.

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-адресом, поэтому агент может повторить запрос только для страниц, загрузка которых превысила время ожидания, и сохранить остальные.

Context API возвращает полный и пригодный к использованию контент

Мы сравнили Context API с Firecrawl, Exa, Parallel, Keenable и Context.dev на 1000 URL-адресов, отобранных из реальных запросов агентов на загрузку страниц. Выборка охватывает 715 сайтов и включает государственные и академические источники, а также страницы не на английском языке. Затем отдельная модель-судья оценила результаты, не зная, какой провайдер выдал каждый из них.

На диаграмме показана производительность по трём критериям:

  • Пригодность: Доля URL-адресов, для которых было возвращено реальное содержимое страницы, а не страница ошибки или пустой результат.
  • Полнота фактов: Судья собирает ключевые факты со страницы из результатов всех провайдеров, а затем проверяет, какие из них содержатся в выводе каждого. Неудачная загрузка оценивается в ноль баллов.
  • Точность контента: доля возвращённого текста, которая приходится на содержимое страницы, а не на уведомления о файлах cookie, навигацию или рекламу, усреднённая по всем URL-адресам. Неудачная загрузка получает ноль баллов.

В этой оценке Context API вернул пригодный для использования контент для 92,3 % URL-адресов, извлёк 87,9 % ключевых фактов и показал точность контента 80,3 %.

Цены

Context API стоит 1 доллар США за 1000 загруженных URL-адресов. Разработчики платят за каждый URL-адрес, возвращающий статус ok. За 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 для надёжного инференсаРазработчики17 нояб. 2026 г.
  2. Представляем Monitor API от PerplexityРазработчики16 нояб. 2026 г.