From 726e427b998df0df7784a51a95158be5be1246f3 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 5 Dec 2025 18:55:56 +0000 Subject: [PATCH 1/4] Update ai/agent.mdx --- ai/agent.mdx | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/ai/agent.mdx b/ai/agent.mdx index 0b51d12c3..0d266a7b4 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 ⌘+I (Mac) or Ctrl+I (Windows/Linux), or by clicking the **Ask agent** button. +Access the agent in a resizable panel directly from your dashboard using the keyboard shortcut ⌘+I (Mac) or Ctrl+I (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. The agent panel in light mode. The agent panel in dark mode. -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 From da938ddce081694c7afa5453cf3e34020c82e96a Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 5 Dec 2025 18:56:07 +0000 Subject: [PATCH 2/4] Update ai/agent.mdx --- ai/agent.mdx | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/ai/agent.mdx b/ai/agent.mdx index 0d266a7b4..03c56b98c 100644 --- a/ai/agent.mdx +++ b/ai/agent.mdx @@ -44,16 +44,16 @@ 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. -1. Open the agent panel in your dashboard. -2. Click the **Settings** button. +1. Open the agent panel in your dashboard using ⌘+I (Mac) or Ctrl+I (Windows/Linux). +2. Click the **Settings** icon (gear icon) in the panel header to open the Settings view. The settings button in light mode. The settings button in dark mode. -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. From 450997f8495b7c708bf020b88373375c24546542 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 5 Dec 2025 18:56:14 +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 03c56b98c..4b05ee447 100644 --- a/ai/agent.mdx +++ b/ai/agent.mdx @@ -59,7 +59,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. 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 From 3ab3eb65e84f104d73b04b4ea755e3fac6371c76 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 8 Dec 2025 16:26:32 +0000 Subject: [PATCH 4/4] Update deploy/docs-subpath.mdx --- deploy/docs-subpath.mdx | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/deploy/docs-subpath.mdx b/deploy/docs-subpath.mdx index 9061abdd2..f7f5511cc 100644 --- a/deploy/docs-subpath.mdx +++ b/deploy/docs-subpath.mdx @@ -21,4 +21,12 @@ If you proxy all traffic on your custom domain, you may need to configure [heade ## Custom subpaths -If you need your documentation at a subpath other than `/docs` (for example, `/help` or `/guides`), contact the [Mintlify team](mailto:support@mintlify.com) with details about your desired path and hosting setup. +You can host your documentation at any custom subpath (for example, `/help` or `/guides`) using the `basePath` configuration in your `mint.json` file: + +```json mint.json +{ + "basePath": "/help" +} +``` + +After configuring your `basePath`, follow the setup instructions for your hosting provider above to route traffic from your custom subpath to your Mintlify documentation.