From 8155849e8b720dd318bb9afb85179396c4384885 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 11 Dec 2025 22:20:50 +0000
Subject: [PATCH 1/3] Update ai/agent.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
ai/agent.mdx | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/ai/agent.mdx b/ai/agent.mdx
index a2f607bca..a4833f51b 100644
--- a/ai/agent.mdx
+++ b/ai/agent.mdx
@@ -21,9 +21,10 @@ Use the agent to:
Access the agent in a from your dashboard using the keyboard shortcut ⌘+I (macOS) or Ctrl+I (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.
+The agent panel has four 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.
+- **Suggestions**: View documentation update suggestions based on changes in your monitored Git repositories. A notification badge displays the number of open suggestions. Learn more about [agent suggestions](/ai/suggestions).
- **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.
From f23943aa90670a4b62b73c279083360673b4b8a0 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 11 Dec 2025 22:20:57 +0000
Subject: [PATCH 2/3] Update ai/suggestions.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
ai/suggestions.mdx | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/ai/suggestions.mdx b/ai/suggestions.mdx
index 45b6acb5e..f00a0fb75 100644
--- a/ai/suggestions.mdx
+++ b/ai/suggestions.mdx
@@ -18,9 +18,9 @@ Before using suggestions, you must install the [Mintlify GitHub App](/deploy/git
## Configure suggestions
-Configure which repositories the agent makes suggestions for in the agent settings.
+Configure which repositories the agent makes suggestions for in the Agent panel Settings view.
-The configuration page displays all GitHub organizations where you've installed the Mintlify GitHub App and which repositories the agent is monitoring.
+The Settings view displays all GitHub organizations where you've installed the Mintlify GitHub App and which repositories the agent is monitoring.
### Select repositories to monitor
From 414b723430321b119d3833a1fc4c87591cb4323a Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 11 Dec 2025 22:21:12 +0000
Subject: [PATCH 3/3] Update ai/suggestions.mdx
Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
ai/suggestions.mdx | 16 +++++++++-------
1 file changed, 9 insertions(+), 7 deletions(-)
diff --git a/ai/suggestions.mdx b/ai/suggestions.mdx
index f00a0fb75..0081bb38f 100644
--- a/ai/suggestions.mdx
+++ b/ai/suggestions.mdx
@@ -52,9 +52,9 @@ The agent immediately stops monitoring the repository. Any existing suggestions
## Review suggestions
-When the agent detects user-facing changes in your monitored repositories, it creates suggestions that appear in your dashboard. Each suggestion displays the pull request title, repository name, when the suggestion was created, and proposed documentation updates.
+When the agent detects user-facing changes in your monitored repositories, it creates suggestions that appear in the Agent panel's Suggestions tab. Each suggestion displays the pull request title, repository name, when the suggestion was created, and proposed documentation updates.
-The **Ask agent** button in your dashboard displays the number of suggestions waiting for your review.
+The **Ask agent** button and the **Suggestions** button in the agent panel header display notification badges showing the number of open suggestions waiting for your review.
@@ -66,14 +66,16 @@ The **Ask agent** button in your dashboard displays the number of suggestions wa
Add suggestions as context for the agent to create pull requests.
1. Click the **Ask agent** button in your dashboard to open the agent panel.
-1. Click **Add to chat**.
-1. Submit the prompt to the agent to open a pull request.
+1. Click the **Suggestions** button in the agent panel header to view all suggestions.
+1. Click **Add to chat** on any suggestion you want to address.
+1. The agent switches to the Chat view with the suggestion context loaded. Submit the prompt to create a pull request.
### Dismiss suggestions
-If a suggestion doesn't require documentation updates or you've already addressed the changes, dismiss it to remove it from your dashboard.
+If a suggestion doesn't require documentation updates or you've already addressed the changes, dismiss it to remove it from the Suggestions tab.
1. Click the **Ask agent** button in your dashboard to open the agent panel.
-1. Click the **Dismiss** button next any suggestions that you want to dismiss.
+1. Click the **Suggestions** button in the agent panel header to view all suggestions.
+1. Click the **Dismiss** button next to any suggestions that you want to dismiss.
-The suggestion is immediately removed from your dashboard. You cannot retrieve dismissed suggestions.
+The suggestion is immediately removed from the Suggestions tab. You cannot retrieve dismissed suggestions.