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

Когда пользователь задаёт чат-боту вопрос, ИИ-агенту может понадобиться прочитать несколько веб-страниц, чтобы на него ответить. Стандартные результаты поиска часто содержат лишь фрагменты. Прямая загрузка страницы может вернуть необработанный 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-адреса, загрузка которых завершилась сбоем, плата не взимается.
Начало работы
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.