360 Secure SkillHub
360 安全技能中心

Perplexity Search

通过 AIsa 端点调用 Perplexity Sonar、Sonar Pro、Sonar Reasoning Pro 与 Sonar Deep Research,使用捆绑 Python 客户端或 curl 提交查询,返回带引用的检索问答、分析推理与长篇研究报告;需设置 AISA_API_KEY,并可用 system 指令控制输出格式。

baofeng-tech
baofeng-tech
热度 28.58
最近更新 2026-05-23 05:10:53
分类:搜索依赖:代码执行 / 第三方 API应用场景:研究 / 报告撰写 / 摘要总结 / API 集成

安装技能

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

执行命令安装此 skill: npx secure-skills-cli add perplexity-search-aisa
Metadata
name
perplexity-search-aisa
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.
author
AIsa
version
1.0.1
license
MIT
homepage
https://aisa.one
source
https://github.com/baofeng-tech/agent-skills-io/tree/main/targetSkills/perplexity-search
user-invocable
true
primaryEnv
AISA_API_KEY
requires
{"bins":["python3"],"env":["AISA_API_KEY"]}
metadata
{"aisa":{"emoji":"🔎","requires":{"bins":["python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","compatibility":["openclaw","claude-code","hermes"]},"openclaw":{"emoji":"🔎","requires":{"bins":["python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY"}}

Perplexity Search

Use this skill when the user specifically wants Perplexity-powered search and answer generation through AIsa, especially for citation-backed web answers, analytical reasoning, or long-form research reports.

This skill covers four AIsa endpoints:

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

Compatibility

Works with any agentskills.io-compatible harness, including:

  • Claude Code and Claude
  • OpenAI Codex
  • Cursor
  • Gemini CLI
  • OpenCode, Goose, OpenClaw, Hermes
  • and other harnesses that implement the Agent Skills specification

Requires Python 3, a POSIX shell, and AISA_API_KEY (available from aisa.one).

Requirements

  • Set AISA_API_KEY
  • Use the bundled client at 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 scripts/perplexity_search_client.py sonar --query "What changed in AI this week?"
python3 scripts/perplexity_search_client.py sonar-pro --query "Compare coding agents with citations"
python3 scripts/perplexity_search_client.py sonar-reasoning-pro --query "Analyze whether vertical AI agents can defend against general copilots"
python3 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 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