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

# Agent Mode

> Tell Periskope what you need in plain words. It works across your chats, tickets, rules, bulk messages and settings, shows each step, and asks before changing anything.

[YouTube video player](https://www.youtube.com/embed/Gv841mJNOv4)

Agent Mode is a full-screen workspace where you tell Periskope what you need, and it does the work. Ask a question about your chats, pull a report, draft an automation rule, or tidy up a hundred chats at once: the agent finds the data, shows each step it takes, and stops to ask you before it changes anything.

It works with **the same access you have**. A member only sees the chats and tickets they can see on the dashboard, and the agent can't do anything their permissions don't allow.

> [!NOTE]
>
> Agent Mode is different from the [AI Agent](https://docs.periskope.app/ai/agent/overview.md), which replies to your customers on WhatsApp, and from the [Org & Chat Assistant](https://docs.periskope.app/ai/agent/ai-assistant.md), which sit in a side panel. Agent Mode works for your team, in its own screen, and handles bigger jobs from start to finish.

***

## Open Agent Mode

Click **Agent** in the left sidebar.

![Agent Mode home](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/home.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=2b2f865d508587034d3d6fb8c8ac044b)

Agent Mode

Agent Mode is available on the **Pro** plan. Admins always have it. Members have it unless an admin turns it off under **Settings** > **Permissions** > **Main Screens** > **Agent**.

***

## Ask in Plain Words

Type what you need and press **Enter** to send (**Shift + Enter** adds a new line). Be as specific as you'd be with a teammate: dates, labels, people and numbers all help.

```text theme={null}
Which chats have been waiting longest for our reply?
```

```text theme={null}
Show open tickets that are past their due date, grouped by assignee.
```

### Tag the exact chat or ticket

Type **@** to pick a chat or **#** to pick a ticket, or use the **@** and **#** buttons under the message box. The agent then works on exactly that chat or ticket instead of guessing from a name.

```text theme={null}
Summarize @Acme Corp and list anything we promised them this month.
```

### Start from an example

The home screen shows a few examples to start from, and a different set each time you open it. Click one to put it in the message box, change anything you like, then send.

For the full list, click the **bulb** under the message box or type **/** at the start of the box. Examples are grouped by area (chats, tickets, tasks, analytics, rules, team and more). Keep typing after the **/** to filter them, for example `/ticket`. You only see examples you have permission to run.

![Examples menu](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/examples-menu.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=b273ba65ca50f004828cc50666dfef87)

Examples, grouped by area

> [!NOTE]
>
> Picking an example never sends it. It goes into the message box so you can edit it first.

### Talk instead of typing

Press and hold the **mic** button (or hold **Alt** / **⌥ Option**) and speak; let go when you're done. You can also click the mic once to start and again to stop. What you said appears in the message box, ready to edit and send.

### Attach files

Click the **paperclip** or drag files onto the screen. You can attach up to 10 files at a time, 30 MB each:

* **Sheets** (`.csv`, `.xlsx`), for example a list of numbers for a bulk message
* **Images, video and audio**, for example media to send in a bulk message
* **PDF and Word documents**

### Steer it while it works

You don't have to wait for an answer. Send another message while the agent is working and it reads it at its next step. For example, "only the ones labelled VIP" or "skip the group chats". To stop it, click **Stop** (the square button that replaces Send).

***

## Follow the Work

While the agent works, you see each step it takes: which tools it opened and what it looked up. When it's done, the steps fold into one line, such as **Worked for 1min 1s**. Click it to see the steps again.

![Agent Mode conversation](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/conversation.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=e53630aa7a806c9b1824003187247ab1)

An answer, with the chats it found as links

Answers can include:

* **Links to chats and tickets.** Click one to open it beside the conversation.
* **Tables.** Click **Open as table** to sort columns, copy the table, or download it as a CSV.
* **Charts.** Click **Expand** to see a chart larger, with its numbers as a table.

![Chart in an answer](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/chart.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=23377c5ec856c0724b96400e03a17647)

A chart in an answer

Phone numbers follow your workspace's [number masking](https://docs.periskope.app/features/number-masking-privacy.md) settings, here as everywhere else in Periskope.

### Open chats and tickets beside the conversation

Click a chat or ticket link and it opens in a panel on the right. You can read the messages and reply without leaving Agent Mode.

![Chat in the side panel](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/side-panel-chat.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=4b0cb55e963857b641273fd6d70424b5)

A chat opened beside the conversation

While a chat or ticket is open beside the conversation, your next message tells the agent you're looking at it. You can just say "this":

```text theme={null}
Summarize this chat and draft a reply to the last question.
```

***

## Approve Changes

The agent looks things up on its own, but anything that **changes** your workspace waits for you: labelling or assigning chats, creating tasks or tickets, sending messages, saving rules and changing settings. It shows exactly what it's about to do and asks you to choose.

![Approval card](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/approval.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=6afe544b4665c095d4ef101620ba3766)

The agent asking before it creates a task

| Choice | What it means |
| :- | :- |
| **Allow once** | Do this one action |
| **Allow for this session** | Do this kind of action without asking again, for the rest of this session |
| **Always allow** | Do this kind of action without asking again, in every session |
| **Deny…** | Don't do it. You can add a note telling the agent what to do instead |

Some actions offer fewer choices, because a mistake costs more:

| Kind of action | You'll see | Choices |
| :- | :- | :- |
| Changes inside Periskope (labels, tasks, tickets, settings) | — | Once, this session, or always |
| Messages your customers will see | **Customers will see this** | Once or this session |
| Deleting, or anything else that can't be reversed | **Can't be undone** | Once only |
| Bulk messages | A preview of the message and recipients | Once only, with a click |

When an action covers many chats, the card shows how many, for example **Confirm 24 chats**, so you know the scale before you approve.

> [!TIP]
>
> Use **Always allow** only for actions you're happy for the agent to take without asking, every time.

### Deny with a note

Click **Deny…** and tell the agent what to do instead. It changes its plan and asks again.

![Deny with a note](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/approval-deny.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=bfe8bc69040e662a8b9e387743a741c0)

Denying with a note

![The agent's new proposal after a denial](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/approval-after-deny.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=6b52f1fe274f3bda8c8e44659a7d3965)

The agent asks again with the change

### Keyboard shortcuts

With an approval waiting, press **1**, **2** or **3** to pick a choice, or **Esc** to open **Deny**. Bulk messages always take a click.

***

## Answer the Agent's Questions

When something is unclear, such as which phone, which date or which of two chats, the agent asks and gives you options to pick from, just above the message box.

![Question from the agent](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/question.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=954c0744e648750299faff59d96da62d)

A question with options

Click an option, or use the keyboard: **↑** and **↓** to move, a number or **Enter** to choose, **←** and **→** to switch between questions when there are several, and **Esc** to skip. Choose **Type something else…** to answer in your own words.

***

## What You Can Ask For

The agent can work across most of Periskope. Here's what you can ask for in each area, with example prompts.

| Area | What you can ask for |
| :- | :- |
| Chats & inbox | Find and count chats, summarise conversations, label, assign, archive or snooze chats, add private notes, schedule messages |
| Tickets & tasks | Find, create and update tickets and tasks, read a ticket's history |
| Analytics & exports | Response times, message volumes, ticket metrics, charts, and exports of chats, messages, tickets and more |
| Bulk messages | Send one message to many chats from a sheet, a list of numbers, a chat filter or a saved chat list, then follow delivery |
| Automation rules | Draft, change, pause and review rules |
| Team & settings | Team members and working hours, labels, quick replies, custom properties, webhooks and integrations |
| AI Agent | Why the AI Agent did or didn't reply, its logs, settings and knowledge base |
| Contacts, groups & phones | Find and update contacts, manage WhatsApp groups, check your phones and their message queues |

**Example prompts:**

```text theme={null}
Summarize what customers asked about yesterday.
```

```text theme={null}
How fast did each teammate reply this week?
```

```text theme={null}
Snooze chats waiting on customers until Monday 10am.
```

```text theme={null}
Why didn't the AI agent reply in yesterday's chats?
```

### Build automation rules

Describe the rule you want and the agent drafts it. The draft opens beside the conversation in the same layout as the rule editor, so you can check the trigger, conditions and actions. If something needs fixing, the draft says so.

![Rule drafted by the agent](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/rule-draft.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=82e780dff9afeeeb134dc2e2252eb201)

A drafted rule, with the agent asking how to save it

Saving needs your approval. You can save the rule paused or turn it on straight away, and open it in the full [rule editor](https://docs.periskope.app/integrations/automation-rules/overview.md) anytime.

```text theme={null}
Make a rule: when a new chat mentions price, add a private note asking the sales team to reply within an hour.
```

### Send bulk messages

Tell the agent who to message and what to say, or attach a sheet of numbers. It builds the recipient list, flags numbers that are invalid or missing a country code so you can fix them, and shows a preview before anything is sent. You can send now, schedule it, or set it to repeat. After sending, the same panel shows delivered, read and failed counts.

```text theme={null}
Send a bulk message to chats labelled Leads saying our new pricing is live.
```

A bulk message always needs your approval, given with a click. Members need the **Bulk Messages** permission. See [Sending a Bulk Message](https://docs.periskope.app/features/bulk-message.md) for how bulk messages work.

### Exports and background tasks

Exports of chats, messages, tickets, contacts or the knowledge base can take a while, so the agent runs them as **background tasks**. You can keep working while they run:

* A **task running** pill shows at the top right of the conversation. Click it to see the task's steps, how long it has been running, and a **Stop** button.
* When the task finishes, the agent replies with the file to download.

Background tasks only read data. They never change anything.

### Remember things across sessions

Ask the agent to remember something, such as how your team names labels or which reports you like, and it keeps a note for future sessions. Saving or changing a note needs your approval, and your notes are private to you.

```text theme={null}
Remember that "VIP" means chats with the Priority label.
```

***

## Sessions

Each conversation is a **session**, listed on the left. A dot next to a session shows when the agent is working, waiting for your approval, or has a new reply. Use **Search** to find an older session.

![Session options menu](https://mintcdn.com/bharatkumarramesh/khlmqmi7h0U8j6q2/ai/images/agent-mode/session-options.png?fit=max\&auto=format\&n=khlmqmi7h0U8j6q2\&q=85\&s=fb7b7ad4b9f4b6fca6a93ee445c4157a)

Session options

Click **⋯** next to a session to:

* **Rename** it
* **Pin** it to the top of the list
* **Copy session ID**, to share with our support team if something goes wrong
* **Delete** it, with its history

The agent keeps working if you switch sessions or close the tab. Open the session again to see where it got to. Start a **New session** for each new topic, so the agent isn't distracted by an earlier conversation.

***

## Tips

* **Be specific.** "Chats from this week labelled VIP with no reply" works better than "VIP chats".
* **Tag what you mean.** Use **@** for chats and **#** for tickets instead of typing names.
* **Read the approval card.** It shows exactly what will change; deny with a note if anything is off.
* **Check big jobs first.** Ask "how many chats would that be?" before "archive them".


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.