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 code, instructions, and requested credential (AISA_API_KEY) align with its stated purpose of calling AIsa Perplexity/Sonar endpoints; nothing in the bundle appears disproportionate or unrelated.

Purpose & Capability

Name/description, SKILL.md, and the included Python client all target AIsa Perplexity Sonar endpoints. Required binaries (curl, python3) and the single env var (AISA_API_KEY) are consistent with making HTTP API calls to api.aisa.one.

Instruction Scope

Runtime instructions only describe calling the AIsa endpoints via the bundled Python client or curl; they do not instruct the agent to read unrelated files, search the host, or exfiltrate data beyond the API calls needed for queries.

Install Mechanism

No install spec; this is instruction-only plus a small included client script. Nothing is downloaded from arbitrary URLs and no archive extraction or third-party package installs are specified.

Credentials

Only AISA_API_KEY is required and used by the client. No unrelated credentials, config paths, or broad secrets are requested.

Persistence & Privilege

Skill is not always-enabled and does not request elevated persistence or modify other skills or system-wide settings. Autonomous model invocation remains the platform default but is not combined with other red flags here.

Assessment

This skill appears coherent and limited to calling AIsa Perplexity (api.aisa.one). Before installing, confirm you trust the AIsa service and the skill owner, and only provide an API key with appropriate scope/limits. Avoid sending secrets or highly sensitive data in queries since they are transmitted to an external API. If you need stricter control, rotate/revoke the AISA_API_KEY after use and review AIsa's privacy and retention policies. Finally, note that the agent may call the skill autonomously (platform default); if you want to restrict automatic use, control invocation via your agent's skill permissions.

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