用途:该技能用于执行 Perplexity 的核心工作流 A——单次查询搜索并返回带引用的答案,适用于搜索组件、事实核查工具和实时信息检索。
主要能力:通过 OpenAI SDK 连接 Perplexity API(baseURL 为 https://api.perplexity.ai),调用 sonar 模型发送查询,获得带内联引用的联网回答;支持 search_recency_filter(hour/day/week/month)控制时效,支持 search_domain_filter 限定最多 20 个域名;可解析出 answer、citations、search_results、tokensUsed 并格式化为 Markdown 展示。
使用方式:前提是完成 perplexity-install-auth 设置、安装 openai 包并设置 PERPLEXITY_API_KEY。用 process.env.PERPLEXITY_API_KEY 初始化客户端,调用 chat.completions.create,传入 model 与 messages,按需附加 Perplexity 专用参数。示例代码同时提供 TypeScript 与 Python 版本,流程为发送查询、解析响应、格式化引用、输出结果。
适用场景:需要基于网络来源生成可验证回答的搜索界面、事实核查与实时信息查询。
限制与注意:需处理 401(密钥无效)、429(限流,应指数退避)、引用为空(查询过泛)、信息陈旧(加时效过滤)和响应慢(改用 sonar)等情况。回答与引用来源需区分模型综合与来源内容,发布前应核验高影响引用,来源冲突时说明不确定性;只缓存脱敏查询文本,不向研究 API 发送私有客户数据或凭据。多查询研究见 perplexity-core-workflow-b。