diff --git a/ai/agent.mdx b/ai/agent.mdx
index 631824cc6..e1e76623f 100644
--- a/ai/agent.mdx
+++ b/ai/agent.mdx
@@ -8,7 +8,7 @@ keywords: ["automation", "automate", "Slack integration", "maintenance"]
The agent is available on [Pro and Custom plans](https://mintlify.com/pricing?ref=agent) for anyone with access to your dashboard.
-The agent creates pull requests with proposed changes to your documentation based on your prompts. When you send a request to the agent, it references your documentation, connected repositories, and Slack messages to create content that follows technical writing best practices and adheres to the Mintlify schema. Access the agent in your Slack workspace or embed it in custom applications with the API.
+The agent creates pull requests with proposed changes to your documentation based on your prompts. When you send a request to the agent, it references your documentation, connected repositories, and Slack messages to create content that follows technical writing best practices and adheres to the Mintlify schema. Access the agent directly in your dashboard, in your Slack workspace, or embed it in custom applications with the API.
Use the agent to:
@@ -17,16 +17,28 @@ Use the agent to:
- Search and update existing content
- Answer questions about your docs and technical writing topics
-To get started, add the agent to your Slack workspace and mention it with `@mintlify` in a channel.
+## Use the agent in the dashboard
+
+Access the agent panel directly from your dashboard using the keyboard shortcut ⌘+I (Mac) or Ctrl+I (Windows/Linux), or by clicking the **Ask agent** button.
+
+The agent panel includes:
+
+- **Chat**: Send prompts and receive responses with proposed documentation changes.
+- **History**: View and continue previous conversations.
+- **Settings**: Configure GitHub App permissions and Slack integration.
+
+When the agent makes changes, you can view the pull request directly from the chat or open the changes in the web editor.
## Add the agent to your Slack workspace
+You can also use the agent in Slack to collaborate with your team on documentation updates.
+
If your Slack Workspace Owner requires admin approval to install apps, ask them to approve the Mintlify app before you connect it.
-1. Navigate to the [agent](https://dashboard.mintlify.com/products/agent) page of your dashboard.
-2. Select the **Connect** button.
+1. Open the agent panel in your dashboard and navigate to **Settings**.
+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:
@@ -35,7 +47,7 @@ To get started, add the agent to your Slack workspace and mention it with `@mint
## Connect repositories as context
-The agent can only access repositories that you connect through the Mintlify GitHub App. Modify which repositories the agent can access 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** or in the [GitHub App settings](https://github.com/apps/mintlify/installations/new).
## Embed the agent via API