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 bundled client align with its stated purpose of calling AIsa Perplexity Sonar endpoints and the required access (AISA_API_KEY, curl, python3) is proportional.

Purpose & Capability

Name/description promise Perplexity/Sonar queries and the skill only requires an AISA API key, Python, and curl for examples; these map to that purpose. Requiring curl is reasonable given the curl examples, though the bundled Python client does not need curl to run.

Instruction Scope

SKILL.md instructs the agent to call the documented AIsa endpoints using either the bundled Python client or curl and only references the declared env var AISA_API_KEY and the local script. There are no instructions to read unrelated files, system state, or other credentials.

Install Mechanism

There is no install step (instruction-only with a bundled client file). The included Python client is small, readable, and sends requests only to https://api.aisa.one. No downloads from untrusted URLs or archive extraction are present.

Credentials

Only AISA_API_KEY is required (declared as primaryEnv) which is appropriate for a client that calls a hosted API. The script only reads that env var and no other secrets or unrelated credentials are requested.

Persistence & Privilege

always is false and the skill does not request persistent system-wide changes or access to other skills' configs. It merely runs a client that contacts the AIsa API.

Assessment

This skill will send your queries and the AISA_API_KEY to api.aisa.one. Only install if you trust the AIsa service and are comfortable exposing that API key to the skill. Limit the key's scope if possible, rotate it periodically, and avoid sending highly sensitive or private data through it. You can review the bundled Python script (scripts/perplexity_search_client.py) yourself — it is small and transparent — and run it in a sandbox before allowing autonomous use. Note: curl is listed because SKILL.md includes curl examples; the Python client does not require curl to operate.

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