Perplexity with SuperPlane
Overview
Section titled “Overview”SuperPlane is an open-source DevOps control plane for long-lived, event-driven workflows. It exposes Perplexity as a native component on the canvas — drop a Perplexity node into any workflow and it runs a Perplexity agent with web search and URL fetching, then emits the response and source citations as a payload for downstream nodes.
Component: Perplexity
Section titled “Component: Perplexity”The Perplexity component runs a Perplexity AI agent as a workflow step. Use it for research, synthesis, automated analysis, and content generation grounded in real-time web sources.
Action
Section titled “Action”| Action | Description |
|---|---|
| Run Agent | Run a Perplexity AI agent with web search and URL fetching capabilities. |
Configuration
Section titled “Configuration”| Parameter | Description |
|---|---|
| Preset | Agent preset to use: fast-search, pro-search, deep-research, or advanced-deep-research. These map to the Agent API tiers fast / low / medium / high. When set, Model is ignored. |
| Model | Agent API model identifier to use when no preset is specified (e.g., perplexity/sonar). |
| Input | The prompt or question for the agent. Supports SuperPlane expressions. |
| Instructions | Optional system-level instructions for the agent. |
| Web Search | Enable the web_search tool (default: true). |
| Fetch URL | Enable the fetch_url tool (default: true). |
Output Payload
Section titled “Output Payload”The component emits a payload with these fields downstream nodes can access via expressions:
| Field | Description |
|---|---|
text |
The generated text response. |
citations |
Source citations from web results. |
model |
The specific model used for this run. |
usage |
Token and cost usage information. |
API Key Setup
Section titled “API Key Setup”Configure the Perplexity integration in SuperPlane with your API key. Open your canvas's Integrations settings, add a Perplexity integration, and paste your key.
Get API Key
Generate your Perplexity API key from the API portal.
Quick Start
Section titled “Quick Start”A minimal workflow that asks Perplexity a question whenever a manual run is triggered:
Add a Manual Run trigger
Drop a Manual Run node onto the canvas — this is the workflow's entry point.
Add a Perplexity node
Click + Components, choose Perplexity → Run Agent, and drag it onto the canvas. Connect Manual Run → Perplexity.
Configure the agent
In the Perplexity node:
- Preset:
pro-search - Input:
What is the latest news on nuclear fusion? - Web Search: enabled
- Fetch URL: enabled
- Preset:
Run
Click Run on the Manual Run node. The Perplexity node emits a payload with
text,citations,model, andusage.
Reading the Response Downstream
Section titled “Reading the Response Downstream”Use SuperPlane expressions to pipe the Perplexity output into the next node — for example, a Slack message or a database write:
Research result: {{ $['Perplexity'].data.text }}
Sources:
{{ $['Perplexity'].data.citations }}In condition fields (If / Filter), write expressions without {{ }}:
$['Perplexity'].data.usage.total_tokens > 1000Use Cases
Section titled “Use Cases”- Incident triage — when an alert fires, run a Perplexity research step to gather background on a vendor, library, or CVE before paging on-call.
- Release notes synthesis — turn raw GitHub commit diffs into customer-facing release notes with citations.
- Competitive monitoring — schedule a daily canvas that queries Perplexity for industry news and posts a summary to a Slack channel.
- Document grounding — feed a Perplexity run's output into a downstream component that updates a Notion page or knowledge base.
Links & Resources
Section titled “Links & Resources”SuperPlane Perplexity Component
Official component documentation.
SuperPlane Docs
Full SuperPlane documentation.
Perplexity Agent API
How the Perplexity agent layer works.
Agent API Models
Available models and pricing.
Support
Section titled “Support”Need help with the integration?
- Browse the SuperPlane documentation
- Review our FAQ