Pull request for mintlify/agent-suggestions-notifications-docs-99280

ai/suggestions.mdx

@@ -8,7 +8,7 @@
   Agent suggestions are available on [Custom plans](https://mintlify.com/pricing?ref=autopilot). To enable suggestions for your organization, [contact our sales team](mailto:gtm@mintlify.com). 
 </Note>
 
 You can allow the [agent](/ai/agent) to monitor your selected Git repositories and suggest documentation updates. When the agent identifies potential user-facing changes in your application, it prepares context for you to create a pull request to update your documentation with one click.
 
 Use suggestions to proactively keep your documentation up to date when new features or updates ship.
 
@@ -35,12 +35,32 @@
 1. In the **Monitor Repositories** section, click the organization name that contains the repositories you want to monitor.
 1. Click the toggle on next to each repository you want to monitor, or click **Enable all** to monitor all repositories in the organization.
 
 The agent monitors the default branch (typically `main`) for each repository. A GitHub check named **Mintlify Autopilot** runs on pull requests in monitored repositories to analyze them for potential documentation updates. When you merge a pull request that requires documentation updates, the agent creates a suggestion in your dashboard.
 
 <Note>
   When you first enable monitoring for a repository, the agent creates suggestions for pull requests merged in the last seven days. This backfill only occurs if no suggestions already exist for that repository. You may see multiple suggestions appear immediately after enabling monitoring.
 </Note>
 
+### Subscribe to notifications
+
+You can receive notifications when the agent creates new suggestions. Configure your notification preferences to receive updates via email or Slack.
+
+1. Click the **Ask agent** button in your dashboard to open the agent panel.
+1. 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>
+1. In the **Notifications** section, select your preferred notification frequency for email and Slack:
+   - **Per merge**: Receive a notification each time the agent creates a new suggestion
+   - **Daily**: Receive a daily digest of all new suggestions
+   - **Weekly**: Receive a weekly digest of all new suggestions
+   - **Disabled**: Don't receive notifications
+
+<Note>
+  To receive Slack notifications, you must first [connect the Slack app](/ai/agent#add-the-agent-to-your-slack-workspace) to your workspace.
+</Note>
+
 ### Stop monitoring a repository
 
 1. Click the **Ask agent** button in your dashboard to open the agent panel.
@@ -80,4 +100,4 @@
 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.
 
 The suggestion is immediately removed from your dashboard. You cannot retrieve dismissed suggestions.