Perplexity Search

Perplexity Sonar search and answer generation through AIsa. Use when the task is specifically to call Perplexity Sonar, Sonar Pro, Sonar Reasoning Pro, or So...

Security Scan

The skill's requests, instructions, and included code are consistent with its stated purpose (calling AIsa Perplexity Sonar endpoints) and do not request unrelated privileges or surprising installs.

Purpose & Capability

Name/description, required binaries (curl, python3), and required environment variable (AISA_API_KEY) align with making HTTP requests to AIsa Perplexity Sonar endpoints; nothing requested appears unrelated to the stated function.

Instruction Scope

SKILL.md instructs use of the bundled Python client or curl to call api.aisa.one and only requires the AISA_API_KEY; it does not direct reading unrelated files, other env vars, or sending data to unexpected endpoints.

Install Mechanism

No install spec is provided (instruction-only workflow with a bundled script). The included Python client is plain, unobfuscated code that performs network requests to the documented API—no archive downloads or external installers.

Credentials

Only AISA_API_KEY is required and is used directly by the bundled client and curl examples. No other credentials or config paths are requested or accessed.

Persistence & Privilege

Skill is not forced-always (always: false), and does not request to modify other skills or system-wide settings. It can be invoked by the agent (normal) but does not request elevated persistent privileges.

Assessment

This skill is internally consistent: it simply calls AIsa's Perplexity (api.aisa.one) using your AISA_API_KEY via curl or a small Python client included with the skill. Before installing, verify you trust the AIsa endpoint and are comfortable granting the skill access to the AISA_API_KEY (anyone with that key can use the API). Keep the following in mind: (1) store the API key in a secure environment variable and avoid sharing it; (2) confirm the key's permissions and rotate/revoke it if you later stop using the skill; (3) review the AIsa documentation linked in SKILL.md to confirm expected behavior and billing; (4) because the skill makes network calls, ensure sending queries to the external service is acceptable for any sensitive data you might query.

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

• Sonar
• Sonar Pro
• Sonar Reasoning Pro
• Sonar Deep Research