SuperAPI AI 工具集

perplexity-4

写作与研究

查看项目

更新于 10-16 07:11

技能介绍

用途

该技能提供对 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 密钥不应提交到版本控制或公开分享。