Perplexity Search

该工具调用Perplexity的四个Sonar系列模型，提供分层搜索服务：sonar用于快速带引用轻量问答，sonar-pro适用于内容合成与对比，sonar-reasoning-pro处理多步推理分析，sonar-deep-research生成详尽调研报告。需配置AISA_API_KEY，支持Python客户端或Curl调用，输入查询语句，输出带引用的专业回答、分析或长报告，满足从快速查询到深度调研的需求。

bowen-dotcom

热度 49.22

最近更新 2026-05-11 17:32:20

分类：搜索依赖：代码执行 / 第三方 API应用场景：研究 / 报告撰写

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add aisa-perplexity-search-skill

Metadata

name: perplexity-search
description: Perplexity Sonar search and answer generation through AIsa. Use when the task is specifically to call Perplexity Sonar, Sonar Pro, Sonar Reasoning Pro, or Sonar Deep Research for citation-backed web answers, analytical reasoning, or long-form research reports.
homepage: https://openclaw.ai
metadata: {"openclaw":{"emoji":"🔎","requires":{"bins":["curl","python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}

Perplexity-Search

Use this skill when the user specifically wants Perplexity-powered search answers instead of structured scholar/web retrieval.

This skill covers four AIsa endpoints:

/perplexity/sonar
/perplexity/sonar-pro
/perplexity/sonar-reasoning-pro
/perplexity/sonar-deep-research

Requirements

Set AISA_API_KEY
Use the bundled client at {baseDir}/scripts/perplexity_search_client.py

Model Selection

Use sonar for fast, lightweight answers with citations
Use sonar-pro for stronger synthesis and comparison tasks
Use sonar-reasoning-pro for analytical or multi-step reasoning questions
Use sonar-deep-research for exhaustive reports; expect slower responses and occasional timeouts

Python Client

python3 {baseDir}/scripts/perplexity_search_client.py sonar --query "What changed in AI this week?"
python3 {baseDir}/scripts/perplexity_search_client.py sonar-pro --query "Compare coding agents with citations"
python3 {baseDir}/scripts/perplexity_search_client.py sonar-reasoning-pro --query "Analyze whether vertical AI agents can defend against general copilots"
python3 {baseDir}/scripts/perplexity_search_client.py sonar-deep-research --query "Create a deep research report on AI coding agents in 2026"

Add a system message when you want a more specific output format:

python3 {baseDir}/scripts/perplexity_search_client.py sonar-pro \
  --query "Map the top coding agent products" \
  --system "Respond in markdown with an executive summary first."

Curl Examples

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 changed in the AI agent ecosystem this week?"}
    ]
  }'

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 top coding agents and cite the key differences."}
    ]
  }'

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 whether vertical AI agents can defend against general copilots."}
    ]
  }'

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 deep research report on AI coding agents in 2026."}
    ]
  }'

Timeout Behavior

sonar-deep-research uses a longer timeout and automatic retries in the bundled client
If it still times out, narrow the query or retry later
If the user wants a faster answer, fall back to sonar-pro or sonar-reasoning-pro