docs: document beta content tools for AI agents

Author: mintlify[bot]

docs.json

@@ -154,6 +154,7 @@
                   "guides/ai-agents/data-access",
                   "guides/ai-agents/best-practices",
                   "guides/ai-agents/self-improvement",
+                  "guides/ai-agents/content-tools",
                   "guides/ai-agents/mcp-servers",
                   "guides/ai-agents/autopilot"
                 ]

guides/ai-agents.mdx

@@ -42,6 +42,9 @@ This guide covers everything you need to know about AI agents in Lightdash:
   </Card>
   <Card title="Self-improvement (Beta)" icon="sparkles" horizontal href="/guides/ai-agents/self-improvement">
 
+  </Card>
+  <Card title="Manage content (Beta)" icon="pen-to-square" horizontal href="/guides/ai-agents/content-tools">
+
   </Card>
 </CardGroup>
 

guides/ai-agents/content-tools.mdx

@@ -0,0 +1,59 @@
+---
+title: Manage content with AI agents (Beta)
+description: Let AI agents build and update Lightdash dashboards and charts during a conversation.
+---
+
+<Warning>
+  This feature is currently in Beta. Enable it in your agent settings to start
+  testing with your team.
+</Warning>
+
+When content tools are enabled, AI agents can build new dashboards and charts and update existing ones — adding or rearranging tiles, organizing tabs, changing filters, and more — directly from a conversation.
+
+## How it works
+
+With content tools enabled, your agent can:
+
+- **Create dashboards and charts** based on your prompt
+- **Edit existing content** — add, remove, or rearrange tiles and tabs
+- **Update filters** on dashboards and charts
+- **Reorganize layouts** without leaving the chat
+
+Content tool calls run as the user chatting with the agent, so the agent can only create or edit content that the user is allowed to manage.
+
+## Who can use content tools
+
+Content tools are only exposed when **all** of the following are true:
+
+- The agent's "Allow agent to manage Lightdash content" setting is on
+- The user chatting with the agent has **manage Content-as-Code** permission (admins and developers)
+- For Slack, the workspace has trusted user identity enabled (OAuth) so Lightdash can evaluate the real sender's permissions
+
+If any condition is not met, the agent falls back to read-only behavior and won't attempt to create or edit content.
+
+## Enabling content tools
+
+To enable content tools for an agent:
+
+1. Go to your agent settings
+2. Toggle the **Allow agent to manage Lightdash content** switch
+3. Save your changes
+
+Once enabled, admins and developers chatting with the agent can ask it to build or modify content:
+
+```
+Create a dashboard tracking weekly active users, signups, and churn for the last 90 days.
+```
+
+```
+Add a filter for account_tier to every chart on the Revenue Overview dashboard.
+```
+
+```
+Rearrange the Marketing dashboard so funnel charts come before the channel breakdown.
+```
+
+## Related
+
+- [Editing dashboards with coding agents](/guides/developer/editing-dashboards-with-agents) — Use Cursor, Claude Code, or Codex for bulk edits via the CLI
+- [Self-improvement](/guides/ai-agents/self-improvement) — Let agents propose changes to your semantic layer