diff --git a/ai/agent.mdx b/ai/agent.mdx
index 0b51d12c3..4b05ee447 100644
--- a/ai/agent.mdx
+++ b/ai/agent.mdx
@@ -19,20 +19,22 @@ Use the agent to:
 
 ## Use the agent in the dashboard
 
-Access the agent panel directly from your dashboard using the keyboard shortcut <kbd>⌘</kbd>+<kbd>I</kbd> (Mac) or <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux), or by clicking the **Ask agent** button.
+Access the agent in a resizable panel directly from your dashboard using the keyboard shortcut <kbd>⌘</kbd>+<kbd>I</kbd> (Mac) or <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux), or by clicking the agent button in the top navigation.
 
-The agent panel includes:
+The agent panel includes three views:
 
-- **Chat**: Send prompts and receive responses with proposed documentation changes.
-- **History**: View and continue previous conversations.
-- **Settings**: Configure GitHub App permissions and Slack integration.
+- **Chat**: Send prompts and receive responses with proposed documentation changes. The agent streams responses in real-time and displays tool invocations as it works.
+- **History**: View and continue previous conversations. Click any conversation to resume where you left off.
+- **Settings**: Configure GitHub App permissions for external repositories and manage your Slack integration.
 
 <Frame>
 <img src="/images/agent/dashboard-light.png" alt="The agent panel in light mode." className="block dark:hidden" style={{ maxHeight: '500px' }} />
 <img src="/images/agent/dashboard-dark.png" alt="The agent panel in dark mode." className="hidden dark:block" style={{ maxHeight: '500px' }} />
 </Frame>
 
-When the agent makes changes, you can view the pull request directly from the chat or open the changes in the web editor.
+When the agent makes changes, you can view the pull request directly from the chat or open the changes in the web editor. On mobile devices, the agent opens in a full-screen modal for an optimized experience.
+
+You can resize the panel by dragging the left edge to adjust the width to your preference. Your panel size preference is saved automatically.
 
 ## Add the agent to your Slack workspace
 
@@ -42,22 +44,22 @@ You can also use the agent in Slack to collaborate with your team on documentati
   If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the Mintlify app before you connect it.
 </Note>
 
-1. Open the agent panel in your dashboard. 
-2. Click the **Settings** button.
+1. Open the agent panel in your dashboard using <kbd>⌘</kbd>+<kbd>I</kbd> (Mac) or <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux).
+2. Click the **Settings** icon (gear icon) in the panel header to open the Settings view.
     <Frame>
     <img src="/images/agent/dashboard-settings-light.png" alt="The settings button in light mode." className="block dark:hidden" />
     <img src="/images/agent/dashboard-settings-dark.png" alt="The settings button in dark mode." className="hidden dark:block" />
     </Frame>
-2. Select the **Connect** button in the Slack integration section.
-3. Follow the Slack prompts to add the `mintlify` app to your workspace.
-4. Follow the Slack prompts to link your Mintlify account to your Slack workspace.
-5. Test that the agent is working and responds when you:
+3. In the Integrations section, select the **Connect** button next to Slack.
+4. Follow the Slack prompts to add the `mintlify` app to your workspace.
+5. Follow the Slack prompts to link your Mintlify account to your Slack workspace.
+6. Test that the agent is working and responds when you:
    - Send a direct message to it.
    - Mention it with `@mintlify` in a channel.
 
 ## Connect repositories as context
 
-The agent can only access repositories that you connect through the Mintlify GitHub App. Configure which repositories the agent can access in the agent panel **Settings** or in the [GitHub App settings](https://github.com/apps/mintlify/installations/new).
+The agent can only access repositories that you connect through the Mintlify GitHub App. Configure which repositories the agent can access in the agent panel **Settings** view (click the gear icon in the panel header) or in the [GitHub App settings](https://github.com/apps/mintlify/installations/new).
 
 ## Embed the agent via API