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 в окружение проекта.
Проверка переменной:
import os
if os.environ.get("PERPLEXITY_API_KEY"):
print("PERPLEXITY_API_KEY: задан")
else:
print("PERPLEXITY_API_KEY: не задан")Код проверяет наличие переменной. Действительность ключа и баланс проверяйте отдельно. Платный запрос требует вашего разрешения.
Команда установки из Quickstart:
pip install perplexityaiОбщее начало для Search и Agent:
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.
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.
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, обязательно посмотрите.
В нём показываю подключение рабочих сервисов через MCP и API и сохранение проверенного способа работы в навык. Посмотрите, чтобы оформить согласованные шаги для своего агента.
Вот 2 решения по одной странице Quickstart Perplexity. Это разбор текста документации, не ответы поискового API.
| Тезис | URL | Фрагмент открытой страницы | Дата проверки | Решение |
|---|---|---|---|---|
| Обязательная подписка для вызовов API не нужна | https://docs.perplexity.ai/docs/getting-started/quickstart | Pay-as-you-go pricing for all APIs. No subscription required | 14.11.2026 | подтверждено |
| Отклонённый тезис: все вызовы API бесплатны | https://docs.perplexity.ai/docs/getting-started/quickstart | Pay-as-you-go pricing for all APIs. No subscription required | 14.11.2026 | не подтверждено: указана оплата по использованию |
Адрес и фрагмент совпадают, а решения разные: подписка не нужна, но вызовы оплачиваются. По одному списку ссылок эту ошибку не увидеть.
Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.
Что считать доказательством, а что вернуть на проверку?
Мне нужно доказательство того, что вышло. В поисковом ответе каждый вывод должен подтверждаться текстом открытой страницы.
Заголовок и фрагмент выдачи помогают выбрать страницу. Но в них может не быть условий, от которых зависит вывод: о каком продукте речь, к кому относится правило, когда оно действует. Поэтому для приёмки читайте саму страницу.
Например, в строке про подписку речь именно об API. Сверьте продукт и условие в тезисе с текстом страницы. Условия пользовательского Pro и другие способы оплаты проверяйте отдельно.
Дату результата поиска отделяйте от даты своей проверки. date и last_updated относятся к найденному результату. В таблицу ставьте дату, когда прочитали страницу и сверили тезис.
Возвращайте работу по конкретной причине:
- Фрагмент относится к другому продукту или другим условиям: «не подтверждено».
- Текст не содержит заявленного вывода: «не подтверждено».
- Прочитать страницу не удалось: «страница недоступна».
Выстраиваем проверку. Агент сверяет свой результат, а лучше, когда его проверяет другой агент. Передайте ему те же тезисы, адреса и фрагменты. Пусть сам откроет страницы и проверит выводы по тексту. Согласия моделей между собой для приёмки недостаточно.
При возврате укажите, какую формулировку исправить. Попросите дословный фрагмент к исправленному тезису. Принимайте новый тезис после сверки с текстом страницы, в пределах согласованных попыток.
Если страницу не удалось открыть, агент пока не может судить о её содержании. Повторить чтение можно только в пределах согласованных расходов и попыток.
Как сохранить проверенный способ и не словить цикл?
После приёмки пробного запуска сохраните выбранный API, поручение, формат таблицы, адреса страниц Perplexity и дату сверки условий. В настройках оставьте имя PERPLEXITY_API_KEY, сам секрет храните в защищённом окружении.
Оформите порядок работы как навык агента: что он должен вернуть и когда остановиться. Перед повторным запуском проверьте:
- Выбран API под нужный результат.
- Ключ не раскрыт в чате, исходниках и отчёте.
- Расходы согласованы, пробный вызов разрешён и выполнен.
- Каждый принятый тезис подтверждён фрагментом страницы.
- Заданы бюджет, число попыток и остановка при их достижении.
Почему сообщение агента «готово» ещё не означает выполненную работу, разбираю в отдельной статье.
Для сметы регулярной работы возьмите расход своего пробного запуска и предполагаемый объём задач. Числа из демонстрационного ответа Quickstart показывают структуру ответа, не расходы вашего агента.
Перед следующим запуском заново сверьте условия на сохранённых страницах Perplexity. Старое согласование не разрешает увеличивать бюджет или число попыток. Если задача поменялась, агент должен снова дождаться вашего подтверждения.
Короче, агенту даёте поиск, а работу принимаете по подтверждённым выводам. Получить ответ API и доказать, что в нём написана правда, - разные задачи.
А у вас агент показывает фрагмент источника к каждому выводу или пока приносит список ссылок? Напишите в комментариях в канале, как принимаете такую работу.
Источники
- Perplexity: Quickstart - выбор Search и Agent, выпуск ключа, оплата по использованию, установка SDK, параметры вызовов, поля результатов и цитат, безопасная проверка окружения. Сверено 14.11.2026.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

