360 Secure SkillHub
360 安全技能中心

Perplexity Sonar

这是一款基于Perplexity的搜索技能，通过AIsa接口调用4款Sonar系列模型：sonar用于快速轻量带引用问答，sonar-pro适配综合对比任务，sonar-reasoning-pro处理多步推理分析，sonar-deep-research生成深度研究报告。典型场景含AI资讯查询、竞品对比、逻辑论证、行业深度调研。需配置AISA_API_KEY，支持Python客户端与Curl调用，输入查询可附加系统消息指定输出格式，输出为带引用的文本内容。

aisadocs
aisadocs
热度 39.48
最近更新 2026-05-11 17:39:59
分类：搜索依赖：代码执行 / 第三方 API应用场景：研究 / 报告撰写

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add perplexity-sonar-search
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

References