Perplexity AI

Perplexity AI is a web search engine that uses a large language model to process queries and synthesize responses based on web search results. With a conversational approach, Perplexity AI allows users to ask follow-up questions and receive answers with citations to its sources from the internet.

Utilities · Perplexity AI

Details

IDPerplexity AI
ProviderPerplexity AI Inc
CategoryUtilities
From Version6.0.0
Docker Imagedemisto/python3:3.12.8.3296088

README

Perplexity AI is a web search engine that uses a large language model to process queries and synthesize responses based on web search results. With a conversational approach, Perplexity AI allows users to ask follow-up questions and receive answers with citations to its sources from the internet.

Configure Perplexity AI on Cortex XSOAR

  1. Navigate to Settings > Integrations > Servers & Services.
  2. Search for Perplexity AI.
  3. Click Add instance to create and configure a new integration instance.

    Parameter Description Required
    URL for Perplexity AI   True
    Perplexity AI API Key   True
    Cloudflare Access Client Id   False
    Cloudflare Access Client Secret   False
    Perplexity AI Model Available models are: sonar,sonar-pro,sonar-deep-research,sonar-reasoning,sonar-reasoning-pro,r1-1776 True
  4. Click Test to validate the URLs, token, and connection.

Commands

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

deepresearch-chat


Send a chat message. You may need to increase the command timeout in “advanced settings” from the default 5 minutes.

Base Command

deepresearch-chat

Input

Argument Name Description Required
systemmessage The system message to influence how the user message is handled - used in the “system” role. Default is Be precise and concise. Optional
usermessage The user’s question - used in the “users” role. Required
recentfilter Limit search to recent hour, day, week, month. Possible values are: hour, day, week, month. Optional
domainfilter Limit search to these domains. CSV list of domains of up to 3 domains. A ‘-‘ in front of the domain excludes it. Optional
jsonout Include JSON output in context if yes, with markdown in war room. Possible values are: yes, no. Default is no. Optional
citations Include research citations in the output. Possible values are: yes, no. Default is no. Optional
thinking Include thinking in the output. Possible values are: yes, no. Default is no. Optional
contextsize How much context is returned as results. Possible values are: low, medium, high. Default is medium. Optional

Context Output

There is no context output for this command.

Configuration parameters

  • url — URL for Perplexity AI (required)
  • apikey — Perplexity AI API Key (required)
  • cf_auth — Cloudflare Access Client Id
  • model — Perplexity AI Model (required)
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings

Commands (1)

  • deepresearch-chat

    Send a chat message. You may need to increase the command timeout in "advanced settings" from the default 5 minutes.

An API key is required for the XSOAR integration. To create your API Key:

- Create your account at Perplexity AI
- Once the account is created, select the settings gear icon by your account name
- Select the **API** option
- Select the **+Generate** link to create the API key
- Copy the API key and use it in the XSOAR Perplexity AI integration configuration
- The free tier allows 5 deep research reports per day
- Setting up payment options and funding the Pro option allows full use
- Higher tiers also enable chat completion parameters such as **search-domain-filters**