docs: Document PostHog AI alerts feature

contents/docs/alerts/index.mdx

@@ -100,6 +100,26 @@ To view all the alerts set, click [Product analytics](https://app.posthog.com/in
 />
 
 
+## Create alerts with PostHog AI
+
+You can also create and manage alerts using [PostHog AI](/docs/posthog-ai/overview) with natural language commands. Open [PostHog AI](https://app.posthog.com/#panel=max) from anywhere in the app and describe the alert you want.
+
+**Example commands:**
+
+- "Alert me when daily signups drop below 100"
+- "Create an alert when pageviews increase by more than 50%"
+- "Notify me if revenue drops more than 20% week over week"
+- "Change my alert threshold to 200"
+- "Disable the signups alert"
+
+PostHog AI can create alerts on existing insights or generate new trend insights and set up alerts on them automatically. To update existing alerts, PostHog AI finds the alert by name and applies your changes.
+
+<CalloutBox icon="IconInfo" title="Note" type="fyi">
+
+PostHog AI can only create alerts on [trends](/docs/product-analytics/trends). Other insight types like funnels and retention don't support alerts.
+
+</CalloutBox>
+
 ## Relative alerts
 Relative alerts check for change in the value of an insight.
 For example, if a value increases by 5% in a week.

contents/docs/posthog-ai/modes.mdx

@@ -41,6 +41,7 @@ The default mode for creating insights and dashboards.
 **Mode-specific tools:**
 - `create_insight` - Create or edit insights
 - `create_dashboard` / `upsert_dashboard` - Create and manage dashboards
+- `upsert_alert` - Create and edit [alerts](/docs/alerts) on trend insights
 
 ### SQL
 

contents/docs/posthog-ai/overview.mdx

@@ -46,6 +46,7 @@ Unlike other agents, PostHog AI can:
 - Generate complex [HogQL](/docs/sql) (our version of SQL) queries.
 - Answer questions from PostHog's documentation.
 - Create [surveys](/docs/surveys/creating-surveys) using natural language.
+- Create [alerts](/docs/alerts) to monitor insight metrics and get notified when thresholds are breached.
 - Write [Hog](/docs/hog) functions to power your realtime destinations.