Perplexity Sonar 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 environment requirements align with its stated purpose (calling AIsa Perplexity Sonar endpoints) and request only the expected API key and standard binaries.

Purpose & Capability

Name/description describe calling AIsa Perplexity Sonar endpoints; required binaries (curl, python3) and the single env var AISA_API_KEY directly match that purpose.

Instruction Scope

SKILL.md and the included python client only instruct the agent to call the documented AIsa endpoints, use the bundled client, and read AISA_API_KEY. There are no instructions to read unrelated files, other env vars, or to transmit data to unexpected endpoints.

Install Mechanism

No install spec (instruction-only) and an included Python client file. No network downloads or archive extraction occur during install; nothing writes outside the skill bundle.

Credentials

Only AISA_API_KEY is required/declared (primary credential) which is appropriate for a skill that authenticates to api.aisa.one. No unrelated secrets or config paths are requested.

Persistence & Privilege

Skill is not always-enabled and does not request elevated persistence or modify other skills/configs. It can be invoked autonomously (platform default), which is expected for this type of integration.

Assessment

This skill will send your queries (and any optional system instruction) to https://api.aisa.one and requires you to provide AISA_API_KEY. Only provide an API key you trust for that service. The bundled Python client is simple and only reads AISA_API_KEY and posts to the documented endpoints; there are no other credential requests or hidden endpoints. Note that the agent can call this skill autonomously by default (normal for skills); if you prefer manual use, adjust agent/skill invocation settings. If you have concerns, verify the legitimacy of the AISA API key you intend to use and the api.aisa.one domain before installing.

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

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