Perplexity

Run AI agents with Perplexity

Actions

Run Agent Run a Perplexity AI agent with web search and URL fetching capabilities

Run Agent

Component key: perplexity.runAgent

The Run Agent component uses Perplexity’s Agent API to run AI agents that can search the web and fetch URLs.

Use Cases

• Research and synthesis: Ask complex questions that require gathering and synthesizing information from multiple sources
• Automated analysis: Run AI-powered analysis on web content
• Content generation with citations: Generate text grounded in real-time web sources

Configuration

• Preset: Agent preset to use (fast-search, pro-search, deep-research, advanced-deep-research). When set, model is ignored.
• Model: Model to use when no preset is specified
• Input: The prompt or question for the agent (supports expressions)
• Instructions: Optional system-level instructions
• Web Search: Enable the web_search tool (default: true)
• Fetch URL: Enable the fetch_url tool (default: true)

Output

Returns the agent response including:

• text: The generated text response
• citations: Source citations from web results
• model: The model used
• usage: Token and cost usage information

Example Output

{
  "data": {
    "citations": [
      {
        "type": "citation",
        "url": "https://example.com/ai-news"
      },
      {
        "type": "citation",
        "url": "https://example.com/research"
      }
    ],
    "id": "resp_1234567890",
    "model": "openai/gpt-5.2",
    "status": "completed",
    "text": "Recent developments in AI include significant advances in reasoning capabilities and safety research...",
    "usage": {
      "cost": {
        "total_cost": 0.05
      },
      "input_tokens": 3681,
      "output_tokens": 780,
      "total_tokens": 4461
    }
  },
  "timestamp": "2026-01-19T12:00:00Z",
  "type": "perplexity.agent.response"
}