在 GitHub 上查看 ->
为自治 Agent 提供带引用的网页答案与深度研究。 使用一个 AISA_API_KEY 访问完整 Perplexity Sonar 系列能力，从秒级查询到详尽研究报告都可覆盖。
如果还没有安装 AIsa CLI，请先安装：
npm install -g @aisa-one/cli
aisa skills install perplexity-search
Agent 可以用它做什么？
快速事实回答
“OpenAI 最新版本发布了什么？”——几秒内返回带引用的答案。
对比分析
“按价格和功能比较 2026 年排名前三的 AI coding agents。”
多步推理
“分析采用 x402 与传统 API key 计费的取舍。”
深度研究报告
“生成一篇 2,000 字的 agentic browser frameworks 结构化报告。”
决策支持
“我们是否应该采用这个库？请引用采用情况、issue 和替代方案。”
模型档位
| Model | 适合场景 |
|---|
sonar | 快速回答简单问题，并附带引用（秒级） |
sonar-pro | 综合、对比、更长答案和更多来源 |
sonar-reasoning-pro | 多步分析推理、取舍分析、技术深挖 |
sonar-deep-research | 详尽长文报告；可接受数分钟处理时间 |
快速开始
export AISA_API_KEY="your-key"
Sonar（快速答案）
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar",
"messages": [{"role": "user", "content": "What is the Model Context Protocol?"}]
}'
Sonar Pro（综合分析）
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-pro" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar-pro",
"messages": [{"role": "user", "content": "Compare the performance of top AI coding agents in 2026."}]
}'
Sonar Reasoning Pro（分析推理）
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-reasoning-pro" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar-reasoning-pro",
"messages": [{"role": "user", "content": "Analyze the tradeoffs of adopting x402 vs. traditional billing."}]
}'
Sonar Deep Research
curl -X POST "https://api.aisa.one/apis/v1/perplexity/sonar-deep-research" \
-H "Authorization: Bearer $AISA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sonar-deep-research",
"messages": [{"role": "user", "content": "Create a 2,000-word deep research report on autonomous browser agents."}]
}'
Deep research 可以接受更长处理时间，Python 客户端也实现了自动重试。对时效敏感的请求，建议降级使用 sonar-pro 或 sonar-reasoning-pro，不要长时间等待。
Python 客户端
# 快速答案
python3 scripts/perplexity_search_client.py sonar --query "What is MCP?"
# 综合分析
python3 scripts/perplexity_search_client.py sonar-pro --query "Compare AI coding agents 2026"
# 分析推理
python3 scripts/perplexity_search_client.py sonar-reasoning-pro --query "x402 tradeoffs"
# 深度研究（允许较长处理时间）
python3 scripts/perplexity_search_client.py sonar-deep-research --query "Agentic payments landscape"
# 可选 system message，用于控制输出格式
python3 scripts/perplexity_search_client.py sonar-pro \
--query "Explain RAG" \
--system "Answer in bullet points with citations inline as [1], [2]..."
端点参考
| Endpoint | Method | 用途 |
|---|
/perplexity/sonar | POST | Sonar — 快速答案 |
/perplexity/sonar-pro | POST | Sonar Pro — 综合分析 |
/perplexity/sonar-reasoning-pro | POST | Sonar Reasoning Pro |
/perplexity/sonar-deep-research | POST | Sonar Deep Research |
开始使用
- 在 aisa.one 注册（新账户有 $2 免费额度）。
- 从控制台生成 API key。
export AISA_API_KEY="your-key" 并安装技能：
npm install -g @aisa-one/cli
aisa skills install perplexity-search
Perplexity API reference
四个 Sonar 端点及交互式 Playground。
Pricing
各 Sonar 变体的 token 价格。
