Perplexity Pro Search

Используй этот skill, когда пользователю явно нужен Perplexity Pro Search mode или когда задаче нужен короткий sourced answer по текущим источникам, а не просто список ссылок.

Skill вызывается явно, потому что Pro Search дороже Search only mode.

Preconditions

• PERPLEXITY_API_KEY доступен в окружении shell, в CODEX_HOME/config.toml / ~/.codex/config.toml или в ~/.codeium/windsurf/mcp_config.json.
• Разрешен доступ к https://api.perplexity.ai.
• Если песочница блокирует сеть, повтори тот же скрипт с повышенным доступом. Не заменяй режим другим поиском.

Non-Negotiable Rules

• Используй local script scripts/pro_search.py.
• Сохраняй stream=true и web_search_options.search_type="pro".
• Не переходи незаметно на Search only mode, perplexity_ask, perplexity_reason или обычный Sonar Pro без потока.
• Используй --json, когда Codex должен обработать результат дальше.
• Держи вопрос узким. Pro Search нужен для сравнений, сложных или зависящих от времени вопросов, а не для простых поисков.

Lean Execution Rules

• Обычно делай один вызов Pro Search API.
• Не читай scripts/pro_search.py при обычном использовании. Открывай его только при ошибке, правке или явном вопросе пользователя.
• Не добавляй лишнюю проверку через веб, GitHub или другой API после успешного Pro Search, кроме случаев:
  • пользователь явно просит независимую проверку;
  • источники недостаточно официальные;
  • ответ противоречив или конфликтует с официальным источником.
• Если сеть в песочнице недоступна, один раз повтори ту же команду с повышенным доступом.
• Пиши коротко: одна заметка перед запуском и одна заметка при необходимости повышенного доступа.

Default Flow

1. Преврати запрос пользователя в точный вопрос.
2. Добавляй фильтры только когда они реально улучшают результат:
   • --context-size medium|high для более широкого разбора;
   • --recency для свежих событий;
   • --domain для ограничения источников.
3. Один раз запусти scripts/pro_search.py, обычно с --json.
4. Верни короткий ответ и лучшие источники.
5. Показывай расход только когда это полезно или пользователь просит.
6. Если ответ выглядит противоречивым или недостаточно официальным, сделай одну точечную проверку по лучшему официальному источнику.
7. Если пользователю нужны только ссылки, предложи Search only mode через $perplexity_search_only.

Recommended Commands

python3 scripts/pro_search.py "Compare the latest AI browser agent launches and explain the differences." --context-size medium --json
python3 scripts/pro_search.py "Summarize this week's official Perplexity API documentation changes." --recency week --domain docs.perplexity.ai --json
python3 scripts/pro_search.py "Which open-source MCP servers added Perplexity support in 2026?" --context-size high --json

Output Shape

• Обычный вывод: ответ, источники, расход.
• --json возвращает content, search_results, usage и шаги рассуждения, если они есть.
• Если вызов API не удался, покажи ошибку напрямую. Не додумывай результат.

References

• references/prompt_recipes.md