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 р.