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

npx skills add AIsa-team/agent-skills --skill perplexity-research

npm install -g @aisa-one/cli
aisa skills install perplexity-research

Start a new agent session after installing so the skill loads.

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 and create an API key in the console.
Set it in your shell: export AISA_API_KEY="your-key".
Install the skill with one of the commands under Install, then start a new agent session.

Perplexity Search

Existing Perplexity Sonar skill.

Perplexity API reference

Sonar endpoint documentation.

Multi-source Search

Combine Perplexity with other search sources.

Overview

Financial & Markets

Search & Research

Social Media

AI Models

Marketing

Creative

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