diff --git a/aria/chat.mdx b/aria/chat.mdx
index 128d6d4ac6..7e18c338e9 100644
--- a/aria/chat.mdx
+++ b/aria/chat.mdx
@@ -1,8 +1,9 @@
---
title: "Chat with ARIA"
---
+import { AriaChatBubbles } from '/snippets/AriaChatBubbles.jsx';
-The following page describes how to start a new chat, view your chat history, delete previous conversations, undock the chat window, reference a specific run in your prompt, add an image to a conversation, and provide feedback on ARIA's responses.
+This page describes how to manage your conversations with ARIA: starting and resuming chats, queueing follow-up messages, adding context such as runs and images, and giving feedback on responses.
## Start a new chat
@@ -12,6 +13,47 @@ You can run multiple chats in parallel at a time. ARIA will notify you when it r
Starting a new chat does not delete your previous conversations. To [view previous conversations](/aria/chat#view-chat-history), open the chat history by clicking the three horizontal lines in the upper left corner of the chat window.
+## Send a message
+
+Type a message and press **Enter** to send it.
+- Press **Shift+Enter** to add new lines.
+- Click **+** to add images.
+- To add a run reference, type `@` and select a run from the list. Type to filter and fuzzy-search the list.
+- For more flexibility, compose a more complex message in a text editor and paste it. Plain text is supported, and pasted `@` characters are not resolved to run references.
+
+To cancel the current operation and _immediately_ send the next [queued message](#queue-messages), press the stop icon to the right of the text input.
+
+## Queue messages
+
+The message queue holds the follow-ups you send while ARIA is still working. Instead of waiting for a response, send your next message and it joins a queue above the message box. ARIA runs each queued message in order, with the full conversation as context, as soon as it finishes the message before it.
+
+Use the queue to line up several steps at once and step away, rather than returning to the chat to send each one. For example, you might start with a comparison:
+
+
+
+While that response streams in, queue the next two steps:
+
+```text title="Queued messages"
+Chart validation loss against learning rate for those runs.
+
+Write up the comparison as a report I can share with my team.
+```
+
+The queue header shows how many messages are waiting. Each queued message has three controls:
+
+* **Pencil icon**: Edit the message before ARIA runs it. ARIA moves the message into the message box and removes it from the queue, so send it again to requeue it. This control is unavailable while the message box already holds a draft.
+* **Up arrow icon**: Run the message now instead of waiting its turn. ARIA stops what it's working on and runs this message next. The other queued messages keep their order.
+* **Trash can icon**: Delete the message from the queue.
+
+Queued messages keep the context you attached to them, including [run mentions](/aria/chat#add-context-to-a-conversation) and [images](/aria/chat#add-an-image-to-a-conversation).
+
+Queueing begins after your first message in a chat, because a queue needs a conversation to run against. The first message you send, and any message you send to an idle chat with an empty queue, goes to ARIA immediately. Each chat keeps its own queue, and the queues in chats you close keep running.
+
+If ARIA needs a clarifying answer or your permission before it continues, the queue pauses until you respond. To run a queued message without responding first, click the up arrow icon next to it.
+
## View chat history
To view previous conversation:
diff --git a/aria/overview.mdx b/aria/overview.mdx
index 6d6f047a9c..77696f7f61 100644
--- a/aria/overview.mdx
+++ b/aria/overview.mdx
@@ -1,9 +1,14 @@
---
title: "Overview"
---
+import MultiTenantCloudOnly from "/snippets/_includes/multi-tenant-cloud-only.mdx";
ARIA, W&B's AI Research and Iteration Agent, is your personalized research assistant that helps you analyze and run experiments, explain results, identify patterns across runs, recommend next steps, build visualizations and reports, and more in W&B.
+
+ ARIA works in team projects, not in your personal entity. Your organization admin must also enable **Smart features**. See [Governance and security](/aria/governance).
+
+
@@ -25,7 +30,7 @@ To [chat with ARIA](/aria/chat):
2. In the chat window, type your question or request. If you are unsure what to ask, select a suggested prompt.
3. Click the **Send** button, the upward-pointing arrow in the lower-right corner of the chat window.
-Depending on the complexity of your question, ARIA might take a few moments to respond. You can close the chat window while ARIA works and return to check the response later. If ARIA needs more information, it asks you for clarification.
+ARIA streams its response as it works, so you can follow its progress step by step rather than waiting for a finished answer. Depending on the complexity of your question, ARIA might take a few moments to finish. You can close the chat window while ARIA works and return to check the response later, or [queue your next message](/aria/chat#queue-messages) without waiting. If ARIA needs more information, it asks you for clarification.
While ARIA works, you might see **Thinking** and **shell** steps: