diff --git a/guides/ai-agents/getting-started.mdx b/guides/ai-agents/getting-started.mdx
index 62714e65..5eed3b7c 100644
--- a/guides/ai-agents/getting-started.mdx
+++ b/guides/ai-agents/getting-started.mdx
@@ -174,6 +174,10 @@ models:
 ### Enable Self-Improvement (optional, Beta)
 Allow your agent to propose changes to your semantic layer, including updating descriptions and creating new metrics. Changes are tracked in changesets for review. Read more on [self-improvement (beta)](/guides/ai-agents/self-improvement) feature.
 
+## Setting up multiple agents
+
+You can create multiple AI agents, each configured for different tasks, tones, languages, or teams. Each agent can have access to different datasets to focus results and give more accurate answers.
+
 ## Slack Integration
 Connect your agent to Slack channels so users can interact directly from Slack. Check out all the cool ways to integrate your agent into slack [here](/guides/using-slack-integration#using-the-slack-integration)
 1. Add Slack to your organization in organization settings. An admin needs to complete this step. See the [how-to guide](/references/workspace/adding-slack-integration).
@@ -218,6 +222,18 @@ By default, each AI agent can only be connected to one Slack channel. If you try
 
 With multi-agent Slack enabled, multiple AI agents can be used in the same Slack channel. When you mention the Lightdash app in Slack, you don't need to specify which agent you want to talk to - there's only one Lightdash Slack app name to mention. Lightdash automatically routes your question to the most appropriate agent based on your question. If it's unclear which agent should respond, you'll be prompted to choose which agent you'd like to answer.
 
-## Setting up multiple agents
+#### Setting up a multi-agent Slack channel
+
+Multi-agent channels are configured at the **organization level**, not per-agent. Once the feature flag is enabled, follow these steps:
+
+1. Go to **Organization Settings → Integrations → Slack**
+2. Find the **Multi-agent channel** setting in the AI Agents configuration panel
+3. Select the Slack channel you want to designate as the multi-agent channel
+4. Click **Save**
+
+Once a channel is designated as the multi-agent channel, all eligible agents in your organization are automatically available in that channel. You do **not** need to add each agent individually via its own **AI Agent → Integrations → Slack** settings.
+
+<Warning>
+If you see the error **"This Slack channel is already assigned to another AI agent"** while trying to attach a second agent via the per-agent integration path, that path only supports single-agent channels. Switch to the org-level multi-agent channel setup described above instead.
+</Warning>
 
-You can create multiple AI agents, each configured for different tasks, tones, languages, or teams. Each agent can have access to different datasets to focus results and give more accurate answers.
\ No newline at end of file