[Help](https://revise.io/help)›AI Agent

# AI Agent

Last updated September 26, 2026

The AI agent is a chat assistant built into the Revise editor. Ask it to brainstorm, draft, edit, or review the document you have open. It writes into the document as suggestions, and nothing changes until you accept them. This page covers how to use the chat. For what the agent can do, see [Agent Capabilities](https://revise.io/articles/agent-capabilities). To rewrite a short text without opening a document, use the [AI Rewriter](https://revise.io/articles/ai-rewriter).

## Open the chat panel

The chat panel sits to the right of the document. How it opens depends on the width of the browser window.

| Window width | Chat panel |
| --- | --- |
| 1196px and wider | Always open beside the document. |
| 1000px to 1195px | Mostly hidden past the right edge. Click the visible strip to slide the panel out. Click the document to hide it again. |
| Narrower than 1000px | Click AI Agent at the bottom of the window. Below 890px, the panel opens over the document. |

The panel is 450px wide. It can't be resized or closed. Press ⌘L to put the cursor in the chat input from anywhere in the editor. See [agent chat shortcuts](https://revise.io/articles/keyboard-shortcuts#agent-chat).

![The AI Agent panel. The header has the conversation list and a plus button. The chat input has the model picker and the attach, saved prompts, and voice buttons](https://revise.io/articles/ai-agent/chat-panel-light.png)

The chat panel with an empty conversation

| Control | Location | Use |
| --- | --- | --- |
| Conversation list | Panel header | Switch to another conversation on this document. Appears once there are two or more. |
| New Conversation (+) | Panel header | Start a new conversation. |
| Model picker | Below the input, left | Choose the AI model. Shows the current model. |
| Attach File (paperclip) | Below the input | Attach files to your next message. |
| Saved Prompts (cube) | Below the input | Insert a prompt you saved. See [Saved Prompts](https://revise.io/articles/saved-prompts#use-a-saved-prompt). |
| Send, voice, or stop | Below the input, right | Sends the message. With an empty input, starts voice mode. During a request, stops it. |

## Send a request

1. Click the chat input, or press ⌘L.
2. Type what you want, such as "Draft an introduction for this report". Press ⇧Enter for a new line.
3. Press Enter or click the send button.

To work on one passage, select it in the document first. The selection attaches to your message as a chip, and the input reads Get help with this selection. Click × on the chip to remove it. See [Giving the Agent Context](https://revise.io/articles/ai-context#selected-text).

![The chat input with a selected sentence attached as a chip and the prompt Shorten this and keep the numbers](https://revise.io/articles/ai-agent/selection-request-light.png)

A request about a selected sentence

On an empty document, the panel offers starter prompts such as Brainstorm ideas and Write a first draft. Click one to send it. Import Document opens a .docx, .pdf, .md, or .txt file into the document.

While the agent works, a status line shows the current step. You can stop the request or send more instructions. See [Follow and steer a request](https://revise.io/articles/agent-capabilities#follow-and-steer-a-request). If you try to leave the page during a request, the browser asks you to confirm.

## Choose a model

Click the model picker below the chat input and choose a model. Hover over a model to see its description, features, and how much of your usage limit it uses compared with GPT-6 Luna.

![The open model picker listing GPT, Gemini, Grok, and Claude models, with a details card for Claude Sonnet 5](https://revise.io/articles/ai-agent/model-picker-light.png)

The model picker with the details card for one model

- The default model is GPT-6 Luna. The picker remembers your last choice in this browser for new conversations.
- A new choice applies from your next message. You can switch models within a conversation.
- Models your plan doesn't include show the plan name. Choosing one opens an upgrade offer, or account creation if you aren't signed in.

For the full model list and plans, see [Supported AI Models](https://revise.io/articles/supported-ai-models#models-by-plan). For how models count toward your limit, see [AI Usage and Limits](https://revise.io/articles/ai-usage-limits).

## Attach files

1. Click Attach File (the paperclip) below the chat input, or drag files onto the chat panel.
2. Each file appears above the input as a chip with its name and size. Click × on a chip to remove it.
3. Type your request and send it.

![The chat input with a text file attached and a request to compare two carriers](https://revise.io/articles/ai-agent/attached-file-light.png)

A text file attached to a message

The agent reads text, Markdown, HTML, code, DOCX, PDF, and image files. Grok models can't read PDFs (see [features by model](https://revise.io/articles/supported-ai-models#features-by-model)). Pasting 500 or more characters into the input creates an attachment instead of a long message. You can't attach files while a request is running. File types and size limits are in [Giving the Agent Context](https://revise.io/articles/ai-context#attached-files).

## When a request finishes

The chat shows how long the agent worked and a short reply. If the agent proposed edits, Suggested N changes appears with Review Changes, Accept All, and Reject All. The edits are already in the document as suggestions: added text in green, removed text in red.

![A sent prompt with its attached selection, the work duration, and the agent's reply. Below it, the suggested changes summary with Review Changes, Accept All, and Reject All](https://revise.io/articles/ai-agent/finished-request-light.png)

A finished request that proposed edits

To accept or reject changes one at a time, see [Reviewing AI Changes](https://revise.io/articles/ai-reviewing-changes). A reply can also include follow-up prompts or a button that opens a feature. See [Replies and next steps](https://revise.io/articles/agent-capabilities#replies-and-next-steps).

## Copy, save, or resend a prompt

Right-click a message you sent to open its menu.

![A sent prompt with a menu showing Copy Prompt, Save Prompt, and Edit & Resend](https://revise.io/articles/ai-agent/message-menu-light.png)

The menu for a sent prompt

| Item | Action |
| --- | --- |
| Copy Prompt | Copies the message text. |
| Save Prompt | Adds the message to [Saved Prompts](https://revise.io/articles/saved-prompts#save-a-prompt). |
| Edit & Resend | Removes the message and the reply after it from the conversation. The text goes back into the input to edit. Only for your latest message, and not during a request. Suggestions from the removed reply stay in the document. |

## Start a new conversation

Click + (New Conversation) in the panel header. The button does nothing while the current conversation is empty. A new conversation starts without the earlier messages. The agent still reads the document.

Once a document has two or more conversations, a list appears in the header, [labeled with the time each was last opened](https://revise.io/articles/ai-prompts#conversation-names). Choose one to switch to it.

![The panel header with the conversation list open, showing conversations labeled by date and time](https://revise.io/articles/ai-agent/conversations-light.png)

The conversation list in the panel header

Conversations belong to the document and are saved automatically. They are private to you: collaborators on a [shared document](https://revise.io/articles/sharing) have their own. Suggestions from any conversation stay in the document until someone accepts or rejects them. See [Conversations](https://revise.io/articles/ai-prompts).

## Voice mode

In voice mode you talk to the agent and it answers aloud. Voice mode requires a Pro or Max plan. On other plans, the voice button opens an upgrade offer.

1. Clear the chat input. The voice button replaces the send button. Its tooltip reads Edit this document by voice.
2. Click it and allow microphone access. The panel shows Connecting, then a waveform in place of the input.
3. Speak your request. The agent replies aloud, and both sides appear in the chat as text. Edits arrive as suggestions, as with typed requests.
4. To end voice mode, click the stop button (Turn off voice mode).

![The empty chat input with the voice button highlighted and the tooltip Edit this document by voice](https://revise.io/articles/ai-agent/voice-button-light.png)

The voice button on an empty chat input

- Choose the agent's voice from the menu beside the stop button. The default is Marin.
- After 2 minutes without speech, the session pauses with the message We paused your voice session because it was idle. Click Resume to continue.
- You can't attach files or change the model during voice mode. Stop any running request before you start it.
- Voice mode counts toward your AI usage.

To type by speaking instead, use [Voice Dictation](https://revise.io/articles/dictation).

## Requirements and limits

| Item | Limit |
| --- | --- |
| No account | One message. Your next message waits in the chat while you create a free account, then sends. See [accounts and anonymous use](https://revise.io/articles/intro-to-revise#accounts-and-anonymous-use). |
| Free plan models | GPT-6 Luna and Claude Haiku 4.5. |
| Voice mode | Pro or Max. |
| Usage | Every plan has a usage limit. See [what happens when you reach it](https://revise.io/articles/ai-usage-limits#limit-reached). |
| View-only documents | The agent answers questions but can't edit. Voice mode is off. |
| Pasted text | 500 characters or more becomes an attachment, up to 250,000 characters. |
| PDF attachments | Up to 20 pages per message on Free, 100 pages on paid plans. Importing a PDF into a document has separate [PDF import limits](https://revise.io/articles/import-export#pdf-import-limits). |

Note: The agent edits only the open document. To have it edit another document, open that document and use its chat panel.