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

# Perplexity AI

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

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

`perplexityai` · **9 tools** · no triggers

## Connect it

```bash theme={"theme":"github-dark"}
run auth perplexityai
run auth perplexityai --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run perplexityai          # common commands
run perplexityai --all    # every command
```

```ts theme={"theme":"github-dark"}
import { perplexityai } from "@boxd/run";
```

## Common tools

| Tool                               | What it does                                                                                                                                          |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create-async-chat-completion`     | Create Async Chat Completion (POST /v1/async/sonar). Submits an asynchronous chat completion request for long-running tasks.                          |
| `create-chat-completion`           | Perplexity Sonar Chat Completions (POST /v1/sonar). Generates web-grounded conversational AI responses with citations.                                |
| `create-contextualized-embeddings` | Create Contextualized Embeddings (POST /v1/contextualizedembeddings).                                                                                 |
| `create-embeddings`                | Generate vector embeddings for independent texts (queries, sentences, documents).                                                                     |
| `execute-agent`                    | Create Agent Response (POST /v1/agent). Orchestrates multi-step agentic workflows with built-in tools (web search, URL fetching, function calling)... |

<Accordion title="All 9 tools" icon="list">
  | Tool                               | What it does                                                                                                                                          |
  | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `create-async-chat-completion`     | Create Async Chat Completion (POST /v1/async/sonar). Submits an asynchronous chat completion request for long-running tasks.                          |
  | `create-chat-completion`           | Perplexity Sonar Chat Completions (POST /v1/sonar). Generates web-grounded conversational AI responses with citations.                                |
  | `create-contextualized-embeddings` | Create Contextualized Embeddings (POST /v1/contextualizedembeddings).                                                                                 |
  | `create-embeddings`                | Generate vector embeddings for independent texts (queries, sentences, documents).                                                                     |
  | `execute-agent`                    | Create Agent Response (POST /v1/agent). Orchestrates multi-step agentic workflows with built-in tools (web search, URL fetching, function calling)... |
  | `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.                     |
  | `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.          |
  | `list-models`                      | List Models (GET /v1/models). Lists models available for the Agent API.                                                                               |
  | `search`                           | Search the Web (POST /search). Returns raw, ranked web search results directly from Perplexity's index without LLM processing.                        |
</Accordion>

[Open Perplexity AI in the console →](https://app.boxd.sh/integrations/detail/perplexityai)