AgentOne Docs

Chatting with AgentOne

Send messages, attach files, mention files and skills, and stop or redirect AgentOne while it works.

Every conversation with AgentOne happens in a chat. Within a chat, AgentOne remembers everything you've talked about. Start a new chat whenever you move on to a different topic or task.

Start a Chat

Click New Chat at the top of the sidebar, or press Cmd + N on macOS or Ctrl + N on Windows and Linux. Type your message in the message box and press Enter.

Write the way you'd ask a person. The more context you give, the better the result:

Find three highly rated Thai restaurants near downtown Portland that are open
after 9pm, and put them in a table with the address and price range.

AgentOne shows its answer as it's written. If it needs to look something up, read a file, or run a command, you'll see each step appear in the chat as it happens. Some steps need your approval first.

Attach Files

To give AgentOne a file to work with, attach it to your message:

  • Click the paperclip button in the message box, or
  • Drag files anywhere onto the chat, or
  • Paste a file or image into the message box.

The message box with a PDF and an image attached as chips inside the message text.

  1. The paperclip button adds files.
  2. Attached files appear as chips right where you put them in your message. Click a chip to preview the file, and open it in its default app from there. To remove a file, delete its chip like any other text.

AgentOne doesn't send a copy of each file to the model. Instead, it gives the model the file's location on your computer, so AgentOne can open it with its tools. That means you can attach any kind of file, including large ones. Because AgentOne needs tools to open the files, attaching files needs tools to be turned on. If Tool Behavior is set to No tools, the paperclip button is turned off.

Files you pick with the paperclip button stay where they are, and AgentOne works on a copy if it needs to change one. Files you drag or paste are copied into your system's temporary folder first. Your system may clear that folder later, so if you'll need one of those files after the chat, ask AgentOne to save it somewhere else.

Images, PDFs, and Other Files AgentOne Can't Read

AgentOne reads text, code, and data files itself. When it needs to know what's in a file it can't read, like an image, video, audio file, or PDF, it uses the Analyze file tool to send the file to a model and ask about it. You'll see Analyzing and the file's name in the chat while it works.

By default, the chat's own model analyzes the file, so pick a model that can read that type of file. To find one, use the filters in the model selector. You can choose a different model for each type of file, or turn this off, in Attachments settings.

Mention Files and Skills

The message box understands what you're pointing at. Mentions show up as chips in your message, both while you type and in the chat afterward.

The message box in a project with a folder, with "Summarize @read" typed and a list of matching project files, like readTime.ts, README.md, and ReadingList.tsx.

  • Type @ to mention a file. In a project with a folder, type @ and start typing a name to search the project's files and folders. Pick one with the arrow keys and Enter, or click it. AgentOne gets the file's path and opens it with its tools when it needs to.
  • Type / to use a skill. Type / to search your skills, and pick one for AgentOne to follow.

Turn off either kind of suggestion with @ Mention Suggestions and / Skill Suggestions in Appearance settings.

Mention a past chat

Drag a chat from the sidebar into the message box to add it as a chip. Instead of pasting the whole conversation, AgentOne reads only the parts it needs with the Chat History tools, which keeps room in the context window for your actual work.

Stop or Interrupt a Response

While AgentOne is responding, you have two options:

The message box during a response, with a red Stop button and the Send button turned into Interrupt.

  1. Stop ends the response right away. You can also press Shift + Esc.
  2. Interrupt appears in place of Send when you type a new message while AgentOne is still working. It stops the current response and sends your new message, so you can change direction without waiting. You can also press Cmd + Enter on macOS or Ctrl + Enter on Windows and Linux. Change this key in Settings -> Chats -> Interrupt Key.

When Something Goes Wrong

If a response fails, for example because of a network problem or a provider error, AgentOne shows the error above the message box with a Resume button. Resume picks up right where the response left off, so you don't lose what was already written. Errors from your own providers include the provider's name, so you can tell where the problem came from.

If AgentOne closed or stopped before replying, you'll see Incomplete Chat with a Resume button.

For help with specific errors, see Troubleshooting Models & Providers.

Notifications

AgentOne can notify you when a response is ready, when it needs your approval to continue, or when it stops because of an error. Click a notification to jump straight to that chat. By default, notifications appear only when the AgentOne window isn't focused. Change this in Settings -> Chats -> Agent Notifications.

More About Chats

On this page