> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Perplexity

> Connect Perplexity to your Atako agents — 2 read and 0 write actions.

Let your agents ask questions with web-grounded answers and search the web via the Perplexity API.

## Connection

* **Authentication**: API key.

<Note>
  Sign in at docs.perplexity.ai → Settings → API Keys → Generate. Copy the key (starts with pplx-). Keys grant full API access (no scopes to configure).

  See [Perplexity's documentation](https://docs.perplexity.ai/docs/getting-started/quickstart).
</Note>

## Read actions (2)

| Action   | Description                                                                                                                                                                                                                                                                                                                                                  |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ask`    | Ask a question and get a web-grounded answer with citations. The body is: model (string, one of "sonar", "sonar-pro", "sonar-reasoning-pro", "sonar-deep-research"), messages (array of \{role:"user", content:"\<question>"}), max\_tokens (integer, optional). Returns choices\[0].message.content (the answer text) and citations (array of source URLs). |
| `search` | Search the web and retrieve ranked results. The body is: query (string), max\_results (integer, 1-20, default 10), search\_domain\_filter (array of strings, optional), search\_recency\_filter (one of "hour","day","week","month","year", optional). Returns results\[] with title, url, snippet, date, and last\_updated.                                 |

## Write actions (0)

This connector is read-only — it exposes no write actions.

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.