| 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. |
| license | MIT |
| compatibility | Works with any agentskills.io-compatible harness — Claude Code, Claude, OpenCode, Cursor, Codex, Gemini CLI, OpenClaw, Hermes, Goose, and others. Requires Python 3, a POSIX shell, and AISA_API_KEY. |
| metadata | {"aisa":{"emoji":"🔎","homepage":"https://aisa.one","requires":{"bins":["curl","python3"],"env":["AISA_API_KEY"]},"primaryEnv":"AISA_API_KEY","harnesses":["claude-code","claude","opencode","cursor","codex","gemini-cli","openclaw","hermes","goose"]}} |
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
Compatibility
Works with any agentskills.io-compatible
harness, including:
- Claude Code and Claude (Anthropic)
- OpenAI Codex
- Cursor
- Gemini CLI (Google)
- OpenCode, Goose, OpenClaw, Hermes
- and any other harness that implements the Agent Skills
specification
Requires Python 3, a POSIX shell, and AISA_API_KEY (get one at
aisa.one).
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
