Perplexity API: дай агенту поиск и покажи источники

Опубликовано 14.11.20267 мин чтенияСредний
Артемий Миллер в кепке с логотипом Perplexity рядом с надписью «ПОИСК ДЛЯ АГЕНТА» и логотипами сервиса.
Что узнаешь
  • Как выбрать Search API или Agent API под задачу своего агента
  • Как подготовить ключ и выполнить первый запрос
  • Как принять ответ по фрагментам открытых источников
Средний
12просмотров

Perplexity - это поисковой движок. Для поиска через Perplexity API выбирайте Search API, если агенту нужны найденные страницы, или Agent API, если нужен готовый ответ со ссылками. Потом откройте страницы и проверьте, подтверждает ли их текст вывод агента.

До подключения поиска определите, какую работу поручаете агенту и где он должен остановиться. Попросите показать расходы и ограничения API. Пока ничего не устанавливайте и не меняйте настройки: сначала подтвердите запуск.

Search или Agent: что нужно вашему агенту?

Агент сначала выясняет, какая работа нужна, а только потом ищет способ. Это защитит от лишних подключений.

ЗадачаЧто отправляемЧто получаемКто сверяет выводы
Найти страницы через SearchПоисковую строку queryЗаголовки, адреса, фрагменты выдачиВаш агент или вы открываете страницы и сверяете тезисы
Получить ответ через AgentПоручение inputТекст с цитатамиВаш агент или вы открываете страницы и сверяете тезисы

Например, нужно сравнить Search и Agent по инструкциям Perplexity. Если ваш агент уже умеет читать страницы и готовить ответ, ему достаточно Search. Если подготовку ответа тоже поручаете Perplexity, выбирайте Agent.

Попросите агента предложить самый простой, достаточный способ. Пока ничего не устанавливайте и не меняйте настройки. Выбирать модель до этого рано.

У Perplexity есть и другие API. Здесь разбираем только поиск и ответ по найденным страницам. Чем протокол MCP отличается от подключения к API, разбираю в отдельной статье.

Если хотите обсудить, как подключить поиск к своему агенту, заходите в канал:

Свой ключ и расходы до запуска

А для регулярной работы понадобится свой ключ. Начните с Quickstart Perplexity. Условия и примеры сверены 14.11.2026.

Там указано: Pay-as-you-go pricing for all APIs. No subscription required. Обязательная подписка не нужна, вызовы оплачиваются. Условия Pro и баланс API проверяйте отдельно.

Нужно рассчитывать себестоимость, смотреть её адекватно. До платного запуска попросите агента показать:

  • условия выбранного API на сайте Perplexity;
  • единицу тарификации и ограничения;
  • предполагаемый объём работы и расходы.

После расчёта подтвердите бюджет и число попыток. При достижении любого предела агент останавливается и возвращает отчёт.

Задайте предел действий самому агенту, отдельно проверьте платёжные ограничения в консоли Perplexity. Не разрешайте ему увеличивать объём работы без вашего подтверждения.

Как посчитать расход токенов на API и соотнести его с бюджетом, разбираю в отдельной статье.

Куда положить ключ, чтобы он не попал в чат?

Ключ вставляем в поле секретов, а не в чат: всё, что вы в чат скидываете, попадает в контекст модели и сохраняется в истории.

Подготовка:

  • Из Quickstart перейдите в API Console и выпустите ключ через API Keys.
  • Задайте PERPLEXITY_API_KEY в защищённых настройках секретов или окружения своей среды. Передайте переменную процессу проекта.
  • Проверьте её наличие без вывода значения.
  • Установите Python SDK Perplexity в окружение проекта.

Проверка переменной:

python
import os

if os.environ.get("PERPLEXITY_API_KEY"):
    print("PERPLEXITY_API_KEY: задан")
else:
    print("PERPLEXITY_API_KEY: не задан")

Код проверяет наличие переменной. Действительность ключа и баланс проверяйте отдельно. Платный запрос требует вашего разрешения.

Команда установки из Quickstart:

bash
pip install perplexityai

Общее начало для Search и Agent:

python
from perplexity import Perplexity

client = Perplexity()

SDK читает ключ из PERPLEXITY_API_KEY. Запускайте проект в окружении, которому передали переменную; в код секрет не подставляйте.

Не просите агента извлекать cookie/session. Не выводите окружение целиком, значение ключа, его часть или длину. Не записывайте секрет в журналы, отчёт проверки и историю изменений проекта. Устанавливать нужно только из официальных источников. И что попалось, с интернета не хватать.

Первый вызов: отдельно Search, отдельно Agent

После согласования расходов запустите выбранный API. В примерах из Quickstart используем общий клиент, а запросы заменяем на сравнение Search и Agent.

Search: получить страницы

HTTP-маршрут: POST https://api.perplexity.ai/search.

python
search = client.search.create(
    query="Perplexity Search API Agent API official documentation",
    max_results=5,
)

for result in search.results:
    print(result.title, result.url, sep=" | ")

query задаёт поисковую строку, max_results - количество результатов. Значение 5 взято из Quickstart. Для пробного запроса оставьте его, а фактическое количество страниц проверьте в ответе.

Из search.results код выводит заголовки title и адреса url. Поле snippet содержит фрагмент выдачи. По ссылкам ещё нужно перейти и прочитать страницы.

Agent: получить ответ

Канонический HTTP-маршрут: POST https://api.perplexity.ai/v1/agent.

python
response = client.responses.create(
    effort="low",
    input=(
        "По официальной документации Perplexity объясните, "
        "когда выбирать Search API, а когда Agent API. "
        "Приложите ссылки на источники."
    ),
)

print(response.output_text)

input содержит поручение. Для первого вызова оставьте effort="low" из стартового примера Quickstart. Текст ответа читается через response.output_text.

Agent использует формат OpenAI Responses. POST /v1/responses - поддерживаемый псевдоним /v1/agent, а не другой способ поиска.

В иллюстрации ответа из Quickstart ссылки расположены так:

output[] → content[] → annotations[]
  type: citation
  url: адрес источника

Извлеките url из элементов с цитатами и откройте страницы. Отдельно от текста ответа сохраните проверку: какой тезис подтверждает каждый прочитанный фрагмент.

Сохраните ссылку рядом с каждым тезисом, чтобы проверяющий не сопоставлял их заново. Если в предложении несколько утверждений, проверяйте каждое отдельно.

«Покажи источники»: поручение агенту и приёмка ответа

Укажите свою задачу, допустимые расходы и число попыток, затем скопируйте поручение агенту. До вашего подтверждения он должен только предложить способ и показать условия.

Задача: выбрать Search API или Agent API для продукта.

Уточните нужные действия: страницы или готовый ответ.
Предложите самый простой, достаточный способ.
Откройте https://docs.perplexity.ai/docs/getting-started/quickstart
Покажите источники, способ входа, единицу тарификации,
ограничения, объём работы и расходы. Пока ничего не устанавливайте
и не меняйте. Дождитесь моего подтверждения.

Ключ из чата не запрашивайте. После подтверждения используйте
PERPLEXITY_API_KEY из окружения, без вывода и записи в отчёт.
Выполните только согласованную ветку. При достижении согласованного
бюджета или числа попыток остановитесь и верните отчёт.
Бесконечный повтор запрещён.

Сохраните отдельно ответ API и проверку источников. Извлеките
адреса результатов Search или цитат Agent. Откройте страницы:
фрагменты выдачи и текст модели не заменяют чтение источника.
Для каждого тезиса найдите дословный подтверждающий фрагмент,
сверьте предмет, условия и актуальность. Запишите дату проверки.
Недоступную страницу не додумывайте.

Верните таблицу:
Тезис | URL | Фрагмент открытой страницы | Дата проверки | Решение
Решения: подтверждено / не подтверждено / страница недоступна.

В итог включите только подтверждённые формулировки. Остальное
оставьте в отчёте с причинами. Проверяющему агенту передайте тезисы,
адреса и фрагменты для сверки с оригиналом. Не пишите «готово»,
пока согласованная приёмка не пройдена.

Кстати, я снял полный гайд про связку инструментов и навыков для первого агента Hermes Agent, обязательно посмотрите.

Видео загрузится при скролле
Полный гайд - Связка для первого агента Hermes Agent

В нём показываю подключение рабочих сервисов через MCP и API и сохранение проверенного способа работы в навык. Посмотрите, чтобы оформить согласованные шаги для своего агента.

Вот 2 решения по одной странице Quickstart Perplexity. Это разбор текста документации, не ответы поискового API.

ТезисURLФрагмент открытой страницыДата проверкиРешение
Обязательная подписка для вызовов API не нужнаhttps://docs.perplexity.ai/docs/getting-started/quickstartPay-as-you-go pricing for all APIs. No subscription required14.11.2026подтверждено
Отклонённый тезис: все вызовы API бесплатныhttps://docs.perplexity.ai/docs/getting-started/quickstartPay-as-you-go pricing for all APIs. No subscription required14.11.2026не подтверждено: указана оплата по использованию

Адрес и фрагмент совпадают, а решения разные: подписка не нужна, но вызовы оплачиваются. По одному списку ссылок эту ошибку не увидеть.

Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.

Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Что считать доказательством, а что вернуть на проверку?

Мне нужно доказательство того, что вышло. В поисковом ответе каждый вывод должен подтверждаться текстом открытой страницы.

Заголовок и фрагмент выдачи помогают выбрать страницу. Но в них может не быть условий, от которых зависит вывод: о каком продукте речь, к кому относится правило, когда оно действует. Поэтому для приёмки читайте саму страницу.

Например, в строке про подписку речь именно об API. Сверьте продукт и условие в тезисе с текстом страницы. Условия пользовательского Pro и другие способы оплаты проверяйте отдельно.

Дату результата поиска отделяйте от даты своей проверки. date и last_updated относятся к найденному результату. В таблицу ставьте дату, когда прочитали страницу и сверили тезис.

Возвращайте работу по конкретной причине:

  • Фрагмент относится к другому продукту или другим условиям: «не подтверждено».
  • Текст не содержит заявленного вывода: «не подтверждено».
  • Прочитать страницу не удалось: «страница недоступна».

Выстраиваем проверку. Агент сверяет свой результат, а лучше, когда его проверяет другой агент. Передайте ему те же тезисы, адреса и фрагменты. Пусть сам откроет страницы и проверит выводы по тексту. Согласия моделей между собой для приёмки недостаточно.

При возврате укажите, какую формулировку исправить. Попросите дословный фрагмент к исправленному тезису. Принимайте новый тезис после сверки с текстом страницы, в пределах согласованных попыток.

Если страницу не удалось открыть, агент пока не может судить о её содержании. Повторить чтение можно только в пределах согласованных расходов и попыток.

Как сохранить проверенный способ и не словить цикл?

После приёмки пробного запуска сохраните выбранный API, поручение, формат таблицы, адреса страниц Perplexity и дату сверки условий. В настройках оставьте имя PERPLEXITY_API_KEY, сам секрет храните в защищённом окружении.

Оформите порядок работы как навык агента: что он должен вернуть и когда остановиться. Перед повторным запуском проверьте:

  • Выбран API под нужный результат.
  • Ключ не раскрыт в чате, исходниках и отчёте.
  • Расходы согласованы, пробный вызов разрешён и выполнен.
  • Каждый принятый тезис подтверждён фрагментом страницы.
  • Заданы бюджет, число попыток и остановка при их достижении.

Почему сообщение агента «готово» ещё не означает выполненную работу, разбираю в отдельной статье.

Для сметы регулярной работы возьмите расход своего пробного запуска и предполагаемый объём задач. Числа из демонстрационного ответа Quickstart показывают структуру ответа, не расходы вашего агента.

Перед следующим запуском заново сверьте условия на сохранённых страницах Perplexity. Старое согласование не разрешает увеличивать бюджет или число попыток. Если задача поменялась, агент должен снова дождаться вашего подтверждения.

Короче, агенту даёте поиск, а работу принимаете по подтверждённым выводам. Получить ответ API и доказать, что в нём написана правда, - разные задачи.

А у вас агент показывает фрагмент источника к каждому выводу или пока приносит список ссылок? Напишите в комментариях в канале, как принимаете такую работу.

Источники

  • Perplexity: Quickstart - выбор Search и Agent, выпуск ключа, оплата по использованию, установка SDK, параметры вызовов, поля результатов и цитат, безопасная проверка окружения. Сверено 14.11.2026.
Практикум по вайб-кодингу
+Твой второй мозг
3 вечера - инструменты, метод, первый проект
Старт 24–26 ноября  ·  2 000 ₽
Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Была инструкция полезна?
Артемий Миллер
Автор
Артемий Миллер
Предприниматель и вайб-кодер

Артемий Миллер - предприниматель и вайб-кодер. Бывший программист, собирает продукты исключительно вместе с ИИ-агентами, без найма разработчиков.

Связанные инструкции

ИИ для бухгалтера: собери первичку и проверь по документам

Начните с реестра обезличенных счетов и сверки каждого поля с документом. ИИ собирает черновик, бухгалтер принимает результат и разбирает нерешённые расхождения.

9 мин

ИИ для тестирования: после правки проверяем весь путь

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

8 мин

ИИ для HR: какие у человека результаты и чем они подтверждены

Поручите ИИ сводку по рабочим критериям вакансии и запросите исходный фрагмент для каждого вывода. Сверьте все выводы и все входные материалы; решение о найме оставьте человеку.

10 мин

Excel MCP: поручил правку файла - проверь формулы и данные

Excel MCP от haris-musa позволяет агенту менять локальную книгу без установленного Excel. Подключайте папку с копией, а перед приёмкой сверяйте данные, формулы и способ расчёта значений.

6 мин