Скилл ask-perplexity для вашей IDE

Скилл для получения консолидированных ответов из множества веб-источников через Perplexity AI прямо из чата с AI-агентом.

Поддерживает Claude Code, Codex и Cursor.

Что это

Добавляет команду /ask-perplexity в ваш AI-агент. Вопрос отправляется в Perplexity API, ответ выводится прямо в чат. Исключение: sonar-deep-research сохраняет результат в файл (объём может превышать 30 КБ), агент читает файл и даёт краткое резюме. Полезно когда нужно:

• Провести ревью плана или архитектурного решения с внешней точкой зрения
• Получить консолидированный ответ из десятков источников — в отличие от обычного поиска, Perplexity сразу даёт осмысленный вывод со ссылками
• Уточнить незнакомый API, библиотеку или формат
• Проверить поведение платформы или граничные случаи перед принятием решения

Использование

Пример: просто попросите агента "спросить у Perplexity"

Можно и через:

'/ask-perplexity помоги решить проблему'

Вопрос и дополнительные материалы хранятся отдельно от исполняемых скриптов. Агент создаёт временные question.md и request.json, проверяет манифест и запускает неизменяемый run-perplexity.ps1. Поэтому многострочный вопрос, кавычки и фрагменты исходников не приходится экранировать внутри команды.

⚠️ Галлюцинации — проверяйте каждое фактическое утверждение

Perplexity собирает ответ из источников и LLM поверх них и регулярно галлюцинирует. Типичные сбои:

• Придуманные CVE-номера, названия продуктов, версии, заголовки статей — выглядят правдоподобно, но не существуют
• Неправильная атрибуция цитат — реальное утверждение приписано не тому источнику
• Закрытые уязвимости как актуальные — пофикшенный баг описан как всё ещё опасный
• Неверные API, флаги, коды выхода — «используй exit 2 чтобы заблокировать», когда документация говорит «exit 0 + JSON»
• Гибриды — два реальных факта склеены в утверждение, ложное в целом

Правила работы:

1. Любое фактическое утверждение — гипотеза, не истина. Особенно если от него зависят план, код, архитектурное решение
2. Проверять любой именованный объект до действия: CVE — в NVD или у первоисточника, продукт — на сайте вендора, API — в официальной документации, версия — в changelog
3. Первоисточники из блока Sources: важнее пересказа Perplexity. Если Perplexity цитирует документ — открыть документ и перечитать
4. Не копировать утверждения в код, план или отчёт без независимого подтверждения
5. Если критичное утверждение нельзя проверить — либо явно помечать как неподтверждённое при передаче, либо отбрасывать

Perplexity полезен как внешний синтезатор и указатель на источники. Его резюме — не доказательство.

Получение API-ключа и пополнение баланса

Perplexity имеет два отдельных баланса: для веб-сайта и для API. Подписка Pro и баланс веб-интерфейса не дают доступа к API — нужно отдельно пополнить баланс API-платформы.

Шаг 1. Создайте API-ключ

1. В perplexity.ai откройте Аккаунт → API-платформа

   

2. Создайте ключ API (начинается с pplx-) и скопируйте его

Шаг 2. Пополните баланс API

Перейдите в API-платформу и пополните баланс. Sonar API оплачивается по фактическому использованию: учитываются токены и поисковые запросы. Актуальная формула приведена ниже.

Шаг 3. Добавьте ключ в настройки вашей IDE

Инструкции — в разделе Установка ниже.

Стоимость и лимиты API

Для Sonar API итоговая стоимость складывается из стоимости токенов и платы за поисковый запрос. Ставки ниже проверены 28 августа 2026 года по официальной таблице тарифов.

Модель	Вход, за 1 млн токенов	Выход, за 1 млн токенов	Запросы low / medium / high, за 1000
sonar	$1	$1	$5 / $8 / $12
sonar-pro	$3	$15	$6 / $10 / $14
sonar-reasoning-pro	$2	$8	$6 / $10 / $14
sonar-deep-research	$2	$8	отдельная составная тарификация

Для sonar-deep-research дополнительно оплачиваются токены цитат — $2 за 1 млн, поисковые запросы — $5 за 1000 и токены рассуждения — $3 за 1 млн. Размер поискового контекста (low, medium, high) — это объём найденных веб-материалов, а не размер контекстного окна модели.

Лимиты запросов зависят от уровня аккаунта, который определяется общей суммой купленных API-кредитов. Для sonar, sonar-pro и sonar-reasoning-pro это 50 / 150 / 500 / 1000 / 4000 / 4000 запросов в минуту на уровнях 0–5. Для sonar-deep-research — 5 / 10 / 20 / 40 / 60 / 100 запросов в минуту. Актуальные пороги уровней и остальные ограничения приведены в официальной таблице лимитов.

Модели Sonar API (проверено 28 августа 2026)

Model ID	Контекст	Что делает	Когда полезна
sonar	128k	Быстрый поиск с актуальными веб-источниками	Короткие фактические вопросы, уточнения API
sonar-pro	200k	Углублённый поиск с увеличенным числом результатов	Анализ, сравнение и подробный синтез источников
sonar-reasoning-pro	128k	Многошаговое рассуждение с поиском	Сложный анализ и обоснованные решения
sonar-deep-research	128k	Исчерпывающий поиск по сотням источников	Большие исследовательские отчёты

Список моделей может измениться. Актуальный перечень находится в каталоге моделей Sonar.

Как агент выбирает модель

Агент (Claude Code, Codex или Cursor) выбирает модель автоматически — не нужно указывать её вручную.

Тип задачи	Модель	Что получишь
Быстрый факт, уточнение API, короткий вопрос	sonar	Краткий точный ответ
Ревью плана, архитектурное решение, исследование вопроса	sonar-pro	Развёрнутый анализ с источниками
Многошаговое рассуждение, сложный анализ	sonar-reasoning-pro	Структурированный вывод с цепочкой аргументов
Нужен полный отчёт по теме из сотен источников	sonar-deep-research	Большой итоговый документ (сохраняется в файл)

Результаты тестирования на вопросе «Какая последняя версия .NET SDK вышла в 2025 году?» показали ожидаемое поведение: sonar ответил коротко и точно (.NET 10.0.1, декабрь 2025), sonar-pro дал более развёрнутый ответ с контекстом по версиям, sonar-reasoning-pro выдал структурированный вывод с пошаговым рассуждением, а sonar-deep-research сгенерировал аналитический отчёт объёмом больше 30 КБ — полезно для глубоких исследований, но избыточно для фактических вопросов.

Что будет установлено

Для каждого выбранного агента устанавливается один и тот же комплект:

• SKILL.md;
• run-perplexity.ps1 — безопасный вход через request.json в Windows;
• run-perplexity.sh — транспорт к Perplexity API;
• assets/request.example.json и assets/question.example.md — шаблоны данных.

Установка

• Инструкция для Claude Code
• Инструкция для Codex
• Инструкция для Cursor

Troubleshooting

Проблема	Решение
PERPLEXITY_API_KEY not set	Настройте ключ (см. инструкцию для вашей IDE)
HTTP 401	Проверьте что ключ начинается с pplx- и не истёк
HTTP 429	Превышен лимит запросов, подождите 60 секунд
python3: command not found	Установите Python 3
Пустой ответ	Проверьте интернет-соединение
Argument list too long / «Имя файла или его расширение имеет слишком большую длину»	Для длинных prompt используйте файловый режим: run-perplexity.sh --file /path/to/prompt.md sonar-pro. Скрипт отправляет JSON через curl -d @file, поэтому тело запроса не попадает в командную строку
ERROR: Perplexity transport failed	curl не смог выполнить HTTP-запрос: проверьте интернет, прокси, TLS и доступность https://api.perplexity.ai
curl: (35) / HTTP 000 на Windows	schannel не может проверить CRL/OCSP. В скрипте уже есть --ssl-no-revoke. Если проблема всё равно есть — обновите curl или проверьте корпоративный MITM-proxy