用途
该技能提供对 Perplexity API 的访问,用于基于网络检索的 AI 搜索与研究。它把大语言模型与实时网络搜索结合,给出准确、最新且带来源引用的答案。
何时使用 Perplexity 与内置搜索
适合使用 Perplexity 的情况:
- 需要当前信息(新闻、价格、事件、近期进展)
- 用户要求来源引用或参考
- 需要复杂多步推理
- 用户明确提到 Perplexity 或想要研究式答案
- 需要跨多个来源的详尽分析
适合使用内置网络搜索的情况:
- 简单事实查询
- 快速信息查找
- 用户不需要 AI 生成的综合结论
- 基础 URL 或内容获取已足够
模型选择指南
按任务复杂度选择模型:
搜索模型(快速事实):
- sonar:默认搜索模型,具备网络访问,适合大多数查询。
- sonar-pro:更深入理解的进阶搜索。
推理模型(复杂分析):
- sonar-reasoning:带网络搜索的复杂推理。
- sonar-reasoning-pro:具备更深内容理解的进阶推理。
研究模型(详尽分析):
- sonar-research:跨多来源的综合研究,含深入分析。
- sonar-research-pro:进阶研究,含详尽分析与详细报告。
快速开始
基础搜索:
# 简单查询(默认使用 sonar)
scripts/perplexity_search.sh "What is the capital of Germany?"
# 指定模型
scripts/perplexity_search.sh "Latest AI developments" -m sonar-pro
# Markdown 格式并带引用
scripts/perplexity_search.sh "Tesla stock analysis" -f markdown
进阶研究:
# 深度研究,含综合分析
scripts/perplexity_search.sh "Market analysis for electric vehicles in 2025" \
-m sonar-research-pro -c high -f markdown
# Pro 搜索模式(多步推理)
scripts/perplexity_search.sh "Compare AI models performance benchmarks" \
-m sonar-reasoning-pro -p pro -f markdown
# 自定义系统提示词
scripts/perplexity_search.sh "Analyze tech trends" \
-s "You are a technology analyst. Focus on business implications and market trends."
搜索上下文大小
控制检索多少网络信息:
- low:更快、来源更少,适合简单查询。
- medium(默认):均衡,适合大多数场景。
- high:最全面,适合研究与详细分析。
Pro 搜索模式
适用于 sonar-pro 与推理模型,控制多步工具使用:
- fast(默认):标准单步搜索。
- pro:自动多步推理,执行多次网络搜索。
- auto:根据查询复杂度自动分类。
安装与配置要求
API 密钥配置:该技能需要通过环境变量提供 Perplexity API 密钥:
export PERPLEXITY_API_KEY="your-key-here"
永久设置(添加到 ~/.bashrc 或 ~/.zshrc):
echo 'export PERPLEXITY_API_KEY="your-key-here"' >> ~/.bashrc
source ~/.bashrc
注意:不要把 API 密钥存入 Clawdbot 配置。该技能只从环境变量读取,以避免配置冲突。
依赖:脚本使用 bash 与 curl,二者在 Linux 系统上通常已预装。
使用模式示例
新闻与当前事件:
scripts/perplexity_search.sh "Latest news about AI regulation in Europe" -m sonar
竞品分析:
scripts/perplexity_search.sh "Compare iPhone 15 vs Samsung Galaxy S24 features" \
-m sonar-reasoning-pro -c high -f markdown
市场研究:
scripts/perplexity_search.sh "Electric vehicle market forecast 2025-2030" \
-m sonar-research-pro -c high -p pro -f markdown
结合当前数据的技术问题:
scripts/perplexity_search.sh "Latest Python frameworks for web development 2025" \
-m sonar-reasoning -c medium
输出格式
- text(默认):纯文本,带引用标记 [1]、[2] 等。
- markdown:Markdown 格式响应,含来源链接。
- json:原始 API 响应的 JSON 格式。
成本提示
Perplexity API 并非免费,请注意使用成本:
- 简单查询:约 $0.005–$0.015 每次查询
- 深度研究:约 $0.015–$0.03+ 每次查询
- Pro 用户在 Perplexity Pro 订阅中每月获得 $5 额度
请谨慎使用推理/研究模型,大多数查询默认使用 sonar。
列出可用模型
scripts/perplexity_search.sh --list-models
故障排查
错误:PERPLEXITY_API_KEY 环境变量未设置
- 按上文“安装与配置要求”设置 API 密钥。
错误:curl 命令未找到
- 安装 curl:apt install curl 或对应系统的等效命令。
错误:意外的 API 响应
- 检查 API 密钥是否有效且未被撤销。
- 确认你的 Perplexity 账户具备 API 访问权限。
资源
scripts/ 目录:
- perplexity_search.sh:Perplexity API 交互的主脚本。
- 支持所有 Perplexity 模型。
- 从环境或配置中发现 API 密钥。
- 提供多种输出格式。
- 使用 curl 进行 API 调用(无 Python 依赖)。
注意:该技能使用外部 API 调用,请注意速率限制与成本。API 密钥不应提交到版本控制或公开分享。