Perplexity AI

9 tools available

Perplexity AI provides conversational AI models for generating human-like text responses

Connect Perplexity AI Visit Perplexity AI ↗

Connect Perplexity AI to Definable to route to the best model per task, mix providers in one workflow, fall back on rate-limits. Personas call Perplexity AI's 9 tools directly from chat or scheduled flows. Add it to your persona's available models and route requests to it where it fits best.

Common workflows with Perplexity AI

Multi-provider routing

Persona decides which model fits
Calls this provider when its strengths apply
Falls back to alternatives on rate-limits

Specialised pipeline

Use this provider for one stage
Pipe to a different model for the next
Combine outputs in the response

Perplexity AI actions 9

Every Perplexity AI action below is a callable tool any Definable persona can invoke.

Create Async Chat Completion

Create Async Chat Completion (POST /v1/async/sonar). Submits an asynchronous chat completion request for long-running tasks. Returns immediately with a request ID that can be polled using the Get Async Chat Completion action. Only the 'sonar-deep-research' model is supported for async processing. Async jobs have a 7-day TTL. Deep research generates very long responses (10K-100K+ words) with exhaustive multi-source analysis. Use the idempotency_key to prevent duplicate submissions. Poll with Get Async Chat Completion using the returned request ID to retrieve results when status is COMPLETED.

Create Chat Completion

Perplexity Sonar Chat Completions (POST /v1/sonar). Generates web-grounded conversational AI responses with citations. Supports multiple Sonar models optimized for different use cases: - sonar: Fast, cost-effective for simple queries - sonar-pro: Enhanced quality for complex questions - sonar-reasoning-pro: Chain-of-thought reasoning with <think> blocks - sonar-deep-research: Exhaustive multi-source research (generates very long responses, 10K+ words; prefer the async endpoint for this model) Features: web search grounding, citations, images, structured JSON output, search filtering by domain/date/language/recency, and streaming. Important constraints: - search_recency_filter and date filters (search_after_date_filter, search_before_date_filter, etc.) are mutually exclusive. Use one or the other, not both. - Messages with the 'tool' role must alternate with 'assistant' messages. A valid pattern is: system -> user -> assistant -> tool -> user. - The 'stop' parameter is not currently supported by the API.

Create Contextualized Embeddings

Create Contextualized Embeddings (POST /v1/contextualizedembeddings). Generates document-aware embeddings where chunks from the same document share context. Unlike standard embeddings, these recognize sequential relationships within documents, improving retrieval quality. Models: pplx-embed-context-v1-0.6b (1024 dims) and pplx-embed-context-v1-4b (2560 dims). Both support Matryoshka dimension reduction and INT8/binary quantization.

CreateEmbeddings

Generate vector embeddings for independent texts (queries, sentences, documents). This action takes one or more input texts and generates vector embeddings using Perplexity AI's embedding models. Embeddings are useful for semantic search, similarity matching, and machine learning downstream tasks. Supported models: - pplx-embed-v1-0.6b: Smaller, faster model (1024 dimensions) - pplx-embed-v1-4b: Larger, more accurate model (2560 dimensions) The output embeddings are base64-encoded for efficient transmission. Use the dimensions parameter to reduce embedding size for faster processing when full precision is not required (Matryoshka representation).

Execute Agent

Create Agent Response (POST /v1/agent). Orchestrates multi-step agentic workflows with built-in tools (web search, URL fetching, function calling), reasoning, and multi-model support. Streaming is not supported by this action. At least one of 'model', 'models', or 'preset' must be provided. Available presets: 'fast-search', 'pro-search', 'deep-research'. The 'deep-research' preset generates very long responses (10K-100K+ words) with exhaustive multi-source analysis. Available models include Perplexity Sonar, OpenAI, Anthropic, Google, xAI, and NVIDIA models at direct provider rates. Use the List Models action to see available model identifiers.

Get Async Chat Completion

Get Async Chat Completion (GET /v1/async/sonar/{id}). Retrieves the result of an asynchronous chat completion request by its ID. Use this to poll for the result after creating an async job. The response includes the status and, when completed, the full completion.

List Async Chat Completions

List Async Chat Completions (GET /v1/async/sonar). Retrieves a list of all asynchronous chat completion requests for the authenticated user. Use this to see the status of all your pending, completed, and failed async jobs.

List Models

List Models (GET /v1/models). Lists models available for the Agent API. Returns model identifiers that can be used with the Agent endpoint. The response follows the OpenAI List Models format for compatibility. This is a public endpoint that does not require authentication.

Perplexity Search (Raw Results)

Search the Web (POST /search). Returns raw, ranked web search results directly from Perplexity's index without LLM processing. Faster and cheaper than chat completions when you need raw results. Supports filtering by domain, date, language, country, and recency. Max 20 results per request. Important: search_recency_filter and date filters (search_after_date_filter, search_before_date_filter, last_updated_after_filter, last_updated_before_filter) are mutually exclusive. Use one or the other, not both.

Frequently asked questions

What can I automate with Perplexity AI on Definable?

Anything Perplexity AI exposes through its API. Common artificial intelligence workflows on Definable include route to the best model per task, mix providers in one workflow, fall back on rate-limits. Personas can call any of the 9 Perplexity AI tools directly, then chain the result into another integration without you writing code.

How does Perplexity AI authentication work?

Perplexity AI uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Perplexity AI integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 9 Perplexity AI tools. You only need a separate Perplexity AI subscription if Perplexity AI itself charges per seat or per API call.

Is using Perplexity AI through Definable secure?

Every call from a persona to Perplexity AI is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Perplexity AI on Definable?

Sign up for Definable, open the integrations page, find Perplexity AI, and connect via OAuth or API key. You can immediately attach Perplexity AI to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Perplexity AI actions does Definable expose?

Definable exposes all 9 Perplexity AI actions as callable tools — including `Create Async Chat Completion`, `Create Chat Completion`, `Create Contextualized Embeddings`, plus 6 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Perplexity AI?

Wire it up in minutes. No coding required.

Start for free Schedule a demo

← All integrations