用途
Perplexity Search 是一个使用 Perplexity API 执行实时网络搜索与研究的技能，主要面向需要获取实时网络信息、进行深度研究分析以及复杂推理的场景。
主要能力
该技能提供以下四项能力：
- perplexity_ask：回答一般性问题，使用 sonar-pro 模型。
- perplexity_research：深度研究与综合报告，使用 sonar-deep-research 模型。
- perplexity_reason：高级推理与分析，使用 sonar-reasoning-pro 模型。
- perplexity_search：检索网络搜索结果。
使用方式
前置条件
- 必须设置 PERPLEXITY_API_KEY 环境变量。
- 必须可访问互联网。
基本用法
通过 scripts/perplexity_api.py 脚本调用 API：
# 一般问题（ask）
python3 scripts/perplexity_api.py ask "your question"
# 深度研究（research）
python3 scripts/perplexity_api.py research "research topic"
# 高级推理（reason）
python3 scripts/perplexity_api.py reason "reasoning task"
# 网络搜索（search）
python3 scripts/perplexity_api.py search "search query" [--max-results 10] [--country JP]
命令选项
ask / research / reason
- 第一个参数：问题、研究主题或推理任务。
--strip-thinking：移除thinking...</think>标签以节省上下文 token（仅 research/reason 可用）。
search
- 第一个参数：搜索查询。
--max-results：返回结果的最大数量（1-20，默认 10）。--max-tokens-per-page：每页最大 token 数（256-2048，默认 1024）。--country：用于区域结果的 ISO 代码（例如 JP、US、GB）。
工作流程
标准搜索流程：
- 分析用户问题并选择合适的工具：
- 简单问题 → ask
- 深度研究 → research
- 复杂分析 → reason
- 信息收集 → search
- 执行脚本调用 API。
- 向用户呈现结果，并在可用时引用来源。
工具选择指南
| 使用场景 | 工具 | 说明 |
|---|---|---|
| 当前天气、新闻 | ask | 需要快速回答时 |
| 技术主题研究 | research | 需要综合分析时 |
| 复杂问题分析 | reason | 需要逻辑推理时 |
| 收集来源 | search | 需要 URL 或摘要片段时 |
适用场景
在以下情况使用该技能：
- 用户需要最新信息。
- 收到需要网络搜索的问题。
- 被要求执行深度研究或调查。
- 需要复杂分析或推理。
- 包含“查一下”“搜索”“最新的……”等关键词。
限制与故障排查
- API 密钥错误：检查 PERPLEXITY_API_KEY 环境变量。
- 超时：增大 PERPLEXITY_TIMEOUT_MS（默认 300000ms）。
- 代理问题：设置 PERPLEXITY_PROXY 或 HTTPS_PROXY。
详细 API 规范请参见 references/api_reference.md。