diff --git a/ai/agent.mdx b/ai/agent.mdx
index 5a5a4f0da..8ad3f5a24 100644
--- a/ai/agent.mdx
+++ b/ai/agent.mdx
@@ -17,6 +17,23 @@ Use the agent to:
 - Search and update existing content
 - Answer questions about your docs and technical writing topics
 
+## Access the agent in your dashboard
+
+The agent is available as a resizable panel in your dashboard. Open it by:
+
+- Pressing **Cmd+I** (Mac) or **Ctrl+I** (Windows/Linux)
+- Clicking the agent icon in the dashboard header
+
+The agent panel includes three views:
+
+- **Chat**: Send prompts and view responses with pull request links
+- **History**: Access previous conversations and continue where you left off
+- **Settings**: Configure Slack integration and connected repositories
+
+<Note>
+  Screenshots showing the agent panel interface will be updated in a future release.
+</Note>
+
 ## Add the agent to your Slack workspace
 
 You can also use the agent in Slack to collaborate with your team on documentation updates.
@@ -25,22 +42,24 @@ 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.
-    <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:
+1. Open the agent panel in your dashboard by pressing **Cmd+I** (Mac) or **Ctrl+I** (Windows/Linux).
+2. Click the **Settings** icon (gear icon) in the panel header.
+3. Select the **Connect** button in the Slack integration section.
+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:
+
+1. Open the agent panel by pressing **Cmd+I** (Mac) or **Ctrl+I** (Windows/Linux).
+2. Click the **Settings** icon (gear icon) in the panel header.
+3. Configure repository access in the **Set up external sources** section.
+
+You can also manage repository access in the [GitHub App settings](https://github.com/apps/mintlify/installations/new).
 
 ## Embed the agent via API