From 29532d742e12ed76023814ca58223329ed55cf4b Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sun, 30 Nov 2025 22:01:19 +0000 Subject: [PATCH 1/4] Update ai/agent.mdx --- ai/agent.mdx | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/ai/agent.mdx b/ai/agent.mdx index 631824cc6..01cec06d1 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,7 +17,17 @@ 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 panel icon in the sidebar. + +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 From e178aada5257f80a1af55852f545a07fac99559a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sun, 30 Nov 2025 22:01:29 +0000 Subject: [PATCH 2/4] Update ai/agent.mdx --- ai/agent.mdx | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/ai/agent.mdx b/ai/agent.mdx index 01cec06d1..9f31a4a51 100644 --- a/ai/agent.mdx +++ b/ai/agent.mdx @@ -31,12 +31,14 @@ When the agent makes changes, you can view the pull request directly from the ch ## 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: From 67e4a15143de216178419a2ca18f9d61af614bd5 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Sun, 30 Nov 2025 22:01:36 +0000 Subject: [PATCH 3/4] Update ai/agent.mdx --- ai/agent.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/ai/agent.mdx b/ai/agent.mdx index 9f31a4a51..bbb98559c 100644 --- a/ai/agent.mdx +++ b/ai/agent.mdx @@ -47,7 +47,7 @@ You can also use the agent in Slack to collaborate with your team on documentati ## 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 From 1a839bdbb21e235dcd3610e4cc74894eac7d0683 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Mon, 1 Dec 2025 09:10:57 -0800 Subject: [PATCH 4/4] Apply suggestions from code review --- ai/agent.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/ai/agent.mdx b/ai/agent.mdx index bbb98559c..e1e76623f 100644 --- a/ai/agent.mdx +++ b/ai/agent.mdx @@ -19,13 +19,13 @@ Use the agent to: ## 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 panel icon in the sidebar. +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 +- **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.