From 139e504d6ccfd7da88de3f397e4347b7de87d239 Mon Sep 17 00:00:00 2001
From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com>
Date: Mon, 8 Dec 2025 13:19:50 -0800
Subject: [PATCH] add info about the agent panel

---
 ai/agent.mdx | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/ai/agent.mdx b/ai/agent.mdx
index 5a5a4f0da..133972e1c 100644
--- a/ai/agent.mdx
+++ b/ai/agent.mdx
@@ -17,9 +17,19 @@ Use the agent to:
 - Search and update existing content
 - Answer questions about your docs and technical writing topics
 
+## Use the agent in the dashboard
+
+Access the agent in a from your dashboard using the keyboard shortcut <kbd>⌘</kbd>+<kbd>I</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>I</kbd> (Windows/Linux), or by clicking the **Ask agent** button. The agent panel is resizable on desktop. On mobile devices, the agent opens in full-screen.
+
+The agent panel has three views.
+
+- **Chat**: Send prompts to the agent to update your documentation. The agent creates pull requests based on your instructions and displays links to view the pull requests or open the changes in the web editor.
+- **History**: Browse past conversations and continue working on previous requests. Click any conversation to load it in the chat view.
+- **Settings**: Configure the agent's integrations and repository access.
+
 ## Add the agent to your Slack workspace
 
-You can also use the agent in Slack to collaborate with your team on documentation updates.
+Use the agent in Slack to collaborate with your team on documentation updates.
 
 <Note>
   If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the Mintlify app before you connect it.
@@ -31,7 +41,7 @@ You can also use the agent in Slack to collaborate with your team on documentati
     <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.
+2. In the Slack integration section, click **Connect**.
 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: