Skip to content

Chatting with an agent

The chat is where you actually talk to an agent — type a message, watch it reason and act, attach files it can work on, and steer a turn with slash commands. This page covers the composer and the controls that live around it. Open a chat from an agent’s left navigation or at /work/agents/<agentId>/chat.

Type in the composer (the placeholder reads Send a message…) and press Enter to send. Shift+Enter inserts a newline instead of sending, so a message can span multiple lines.

Once you send, the agent’s reply streams back token by token in the thread as it thinks and works. While a turn is running, the send button becomes a stop control — click it to interrupt the agent mid-turn. When the turn finishes, the composer is ready for your next message.

The composer is disabled (with an explanatory placeholder) when the session can’t take input — for example a read-only view of a scheduled run, or an agent that isn’t running.

Click the + (Add) button on the left of the composer to open the attach menu, then choose Add local files to pick files from your computer. You can also drag and drop files straight onto the composer. (The menu also lists Add from OneDrive and Add from Google Drive, which are placeholders and currently disabled.)

Picked files appear as a preview strip above the input; remove one before sending if you change your mind. Send the message and the attachments go with it.

  • Images are sent inline to the agent on that turn, so a vision-capable model can actually see them. They are also saved into the session workspace alongside other uploads.
  • Other files (documents, spreadsheets, code, archives, audio, video) are written into the session workspace, where the agent can open and work on them. Text and document files additionally have their content inlined into your message so the model can read them immediately. Filenames are sanitized on the way in as a prompt-injection guard.

The composer rejects a pick that breaks any of these caps before uploading, and surfaces the reason as a toast:

Limit Value
Images per message 5
Max size per image 20 MB
Non-image attachments per message 10
Max size per attachment 50 MB
Total attachment bytes per message 200 MB
Accepted types Any type that matches the composer’s accept filter

When an agent has the Agent browser enabled, the composer shows a browser-profile selector (an ID-card icon). Use it to start the session with a saved, already-logged-in browser profile so the agent browses as you — signed in to the sites you captured — instead of starting from a blank browser.

A few rules, because a profile is bound to a session at creation:

  1. Pick the profile before you send the first message — click the ID-card icon and choose a profile from the list (or No profile to browse anonymously). The selected profile shows Active.
  2. Send your first message; the session is created with that profile attached.
  3. Once a session is active the picker locks — the icon is disabled with a tooltip explaining a profile must be chosen before the session starts. To use a different profile, start a new session.

The selector only appears for agents that support a live browser. See Browser profiles for how to create and manage the profiles it lists.

When the agent calls ask_user_question, a tabbed question widget appears in the thread. You can answer via the widget — or just type your reply in the composer: while the question is pending, a plain text message is consumed as the answer. Text that exactly matches a choice label (case-insensitive) selects that choice; anything else is recorded as a free-form “Other” answer; a multi-question prompt receives your whole reply against each question.

Exclusions worth knowing: a message with images or attachments is always an ordinary message, the shortcut stops working as the question’s 30-minute window closes, and once an answer exists (widget or typed) later messages are ordinary messages again.

A Simple / Advanced toggle sits in the composer footer. It changes how much of the agent’s work you see; it does not change what the agent is allowed to do.

View What it shows
Simple (default) The conversation, front and center. Infrastructure plumbing is hidden — file listing/search, skill bookkeeping, memory and process calls, shell commands, code execution, and browser steps are collapsed away, and the workspace pane is hidden so the reply stays the focus. You see what the agent accomplished, not how.
Advanced The full picture. Every tool call renders with its command and output, the workspace pane is shown, and a row of quick-launch buttons appears above the input — Commands, Skills, and Scheduled Tasks — that open the slash menu pre-scoped to that category.

Switching to Simple keeps the agent’s behaviour identical; it only trims the transcript. The quick-launch buttons are an Advanced-only convenience — the slash menu itself is always available by typing / (see below), in either view.

The composer supports slash commands. Type / as the first character of a message and a menu opens with the built-in commands and any skills attached to the agent; keep typing to filter. Everything after the command name is passed as its arguments.

See Slash commands for the full list (/clear, /compress, /goal, /mission, /code, /deep-research, and more) and the per-agent capability toggles that gate them.

Any /<skill-name> that isn’t a built-in command is resolved as a skill attached to the agent. Type / and the skill name (the slash menu lists the skills this agent actually has), then add your request after it:

/research vector databases

The agent inlines that skill’s instructions before acting on your message. See Skills for how to find, attach, and improve the skills that show up here.

Use /loop from the composer to schedule a prompt to run on a recurring interval — or self-paced when you give no interval:

/loop 15m triage new PRs assigned to me

The slash menu suggests ready-made examples and the /loop list and /loop cancel <id> management commands. Scheduled loops then show up on the agent’s Scheduled work page, which is also where you manage and inspect their runs.

  • Slash commands — every / command and its capability toggle.
  • Skills — find, attach, and improve the skills you invoke with /<skill-name>.
  • Scheduled work — where /loop schedules live.
  • Browser profiles — saved logins the profile picker offers.
  • Inbox — questions and approvals an agent raises back to you.