AIsa Perplexity Deep Research

View on GitHub -> Citation-backed research answers. Use Perplexity Sonar through AIsa when an agent needs synthesized answers, not just links.

Install

First, install the AIsa CLI if you have not already:

npm install -g @aisa-one/cli

Then install the skill:

aisa skills install perplexity-research

What can agents do with it?

Deep research

Generate longer answers with cited sources.

Fast answers

Use Sonar for concise grounded responses.

Reasoning research

Route complex questions to reasoning-capable Sonar models.

Source-backed summaries

Keep links and citations attached to claims.

Setup

This skill requires the AISA_API_KEY environment variable. When installed as a Claude plugin, the key is configured via the plugin’s userConfig.

Usage

Run the search client with the sonar subcommand:

python3 ${CLAUDE_PLUGIN_ROOT}/skills/perplexity-research/scripts/search_client.py sonar --query "<research question>" --model <model_name>

Arguments

Argument	Required	Default	Description
`--query` / `-q`	Yes	—	Research question or query
`--model` / `-m`	No	sonar	Model to use (see below)

Available Models

Model	Speed	Depth	Best For
`sonar`	Fast	Standard	Quick factual lookups
`sonar-pro`	Medium	Detailed	In-depth topic exploration
`sonar-reasoning-pro`	Slower	Deep	Complex reasoning and analysis
`sonar-deep-research`	Slowest	Exhaustive	Comprehensive research reports

Examples

# Quick factual lookup
python3 ${CLAUDE_PLUGIN_ROOT}/skills/perplexity-research/scripts/search_client.py sonar --query "What is the current state of quantum computing?"

# Detailed research
python3 ${CLAUDE_PLUGIN_ROOT}/skills/perplexity-research/scripts/search_client.py sonar --query "Compare transformer and state-space model architectures" --model sonar-pro

# Complex reasoning
python3 ${CLAUDE_PLUGIN_ROOT}/skills/perplexity-research/scripts/search_client.py sonar --query "Will AGI be achieved by 2030? Analyze arguments for and against." --model sonar-reasoning-pro

# Exhaustive deep research
python3 ${CLAUDE_PLUGIN_ROOT}/skills/perplexity-research/scripts/search_client.py sonar --query "Comprehensive analysis of AI regulation frameworks worldwide" --model sonar-deep-research

Output

The script prints:

Synthesized answer — A coherent, well-structured response
Citations — Source URLs backing the answer
Cost — API usage cost (when available)

When to Use

Use this skill when the user needs a synthesized, well-researched answer rather than raw search results. Best for complex questions, comparative analyses, trend reports, and any query where a thoughtful, citation-backed response is more valuable than a list of links.

Get started

Sign up at aisa.one (new accounts start with $2 free credit).
Generate an API key from the console.

Set your key and install the skill:

export AISA_API_KEY="your-key"
npm install -g @aisa-one/cli
aisa skills install perplexity-research

Start a new agent session so the runtime loads the updated skill instructions.

Perplexity Search

Existing Perplexity Sonar skill.

Perplexity API reference

Sonar endpoint documentation.

Multi-source Search

Combine Perplexity with other search sources.

Getting Started

Marketing

AI Model Gateway

Creative AI

Data & Finance

Search & Research

Social Media

AIsa Perplexity Deep Research

Install

What can agents do with it?

Deep research

Fast answers

Reasoning research

Source-backed summaries

Setup

Usage

Arguments

Available Models

Examples

Output

When to Use

Get started

Perplexity Search

Perplexity API reference

Multi-source Search

​Install

​What can agents do with it?

Deep research

Fast answers

Reasoning research

Source-backed summaries

​Setup

​Usage

​Arguments

​Available Models

​Examples

​Output

​When to Use

​Get started

​Related

Perplexity Search

Perplexity API reference

Multi-source Search

Install

What can agents do with it?

Setup

Usage

Arguments

Available Models

Examples

Output

When to Use

Get started

Related