From 34ff97a3c5d97fd55111eb51b97749c7cdfe4787 Mon Sep 17 00:00:00 2001 From: Tatiana Inama Date: Fri, 17 Apr 2026 11:31:11 +0200 Subject: [PATCH 1/3] docs: document SLACK_MULTI_AGENT_CHANNEL_ENABLED for self-hosted Self-hosted instances can't use the PostHog-gated multi-agent Slack feature flag, so document the SLACK_MULTI_AGENT_CHANNEL_ENABLED env var that enables it instance-wide. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../configure-a-slack-app-for-lightdash.mdx | 8 ++++++++ self-host/customize-deployment/environment-variables.mdx | 1 + 2 files changed, 9 insertions(+) diff --git a/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx b/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx index dc45f326..1d1b1049 100644 --- a/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx +++ b/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx @@ -146,3 +146,11 @@ Add the following environment variables to your Lightdash server configuration: #### Step 3: Re-install the Slack Integration After updating your environment variables, restart your Lightdash service, then re-install the Slack integration in your Lightdash instance to complete the Socket Mode setup. Your Slack integration will now use Socket Mode to communicate with Slack instead of HTTP webhooks. + +## Enable multi-agent Slack channels + +By default, each AI agent can only be connected to one Slack channel. To allow multiple agents to share the same Slack channel, enable the [multi-agent Slack channel](/guides/ai-agents/getting-started#setting-up-a-multi-agent-slack-channel) feature by setting the following environment variable on your Lightdash instance: + +* `SLACK_MULTI_AGENT_CHANNEL_ENABLED`: Set to `"true"` to enable multi-agent Slack channels for the whole instance (default=false) + +Restart your Lightdash service after updating the variable. Once enabled, configure the designated channel from **Organization Settings → Integrations → Slack**. diff --git a/self-host/customize-deployment/environment-variables.mdx b/self-host/customize-deployment/environment-variables.mdx index 1f981f89..a718f954 100644 --- a/self-host/customize-deployment/environment-variables.mdx +++ b/self-host/customize-deployment/environment-variables.mdx @@ -341,6 +341,7 @@ These variables enable you to configure the [Slack integration](/guides/using-sl | `SLACK_SOCKET_MODE` | Enable socket mode for Slack (default=false) | | `SLACK_CHANNELS_CACHED_TIME` | Time in milliseconds to cache Slack channels (default=600000, 10 minutes) | | `SLACK_SUPPORT_URL` | URL for Slack support | +| `SLACK_MULTI_AGENT_CHANNEL_ENABLED` | Enables the [multi-agent Slack channel](/guides/ai-agents/getting-started#setting-up-a-multi-agent-slack-channel) feature for the whole instance (default=false) | ## GitHub Integration From f546d66ad5e289ea55444770f1c5dc6e0a99ab40 Mon Sep 17 00:00:00 2001 From: Tatiana Inama Date: Fri, 17 Apr 2026 11:32:57 +0200 Subject: [PATCH 2/3] docs: tag multi-agent Slack channels as Beta Matches the existing '(Beta)' convention used in the AI agents guide. Co-Authored-By: Claude Opus 4.7 (1M context) --- .../configure-a-slack-app-for-lightdash.mdx | 4 ++-- self-host/customize-deployment/environment-variables.mdx | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx b/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx index 1d1b1049..17a9cc08 100644 --- a/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx +++ b/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx @@ -147,9 +147,9 @@ Add the following environment variables to your Lightdash server configuration: After updating your environment variables, restart your Lightdash service, then re-install the Slack integration in your Lightdash instance to complete the Socket Mode setup. Your Slack integration will now use Socket Mode to communicate with Slack instead of HTTP webhooks. -## Enable multi-agent Slack channels +## Enable multi-agent Slack channels (Beta) -By default, each AI agent can only be connected to one Slack channel. To allow multiple agents to share the same Slack channel, enable the [multi-agent Slack channel](/guides/ai-agents/getting-started#setting-up-a-multi-agent-slack-channel) feature by setting the following environment variable on your Lightdash instance: +By default, each AI agent can only be connected to one Slack channel. To allow multiple agents to share the same Slack channel, enable the [multi-agent Slack channel (Beta)](/guides/ai-agents/getting-started#setting-up-a-multi-agent-slack-channel) feature by setting the following environment variable on your Lightdash instance: * `SLACK_MULTI_AGENT_CHANNEL_ENABLED`: Set to `"true"` to enable multi-agent Slack channels for the whole instance (default=false) diff --git a/self-host/customize-deployment/environment-variables.mdx b/self-host/customize-deployment/environment-variables.mdx index a718f954..64c96e34 100644 --- a/self-host/customize-deployment/environment-variables.mdx +++ b/self-host/customize-deployment/environment-variables.mdx @@ -341,7 +341,7 @@ These variables enable you to configure the [Slack integration](/guides/using-sl | `SLACK_SOCKET_MODE` | Enable socket mode for Slack (default=false) | | `SLACK_CHANNELS_CACHED_TIME` | Time in milliseconds to cache Slack channels (default=600000, 10 minutes) | | `SLACK_SUPPORT_URL` | URL for Slack support | -| `SLACK_MULTI_AGENT_CHANNEL_ENABLED` | Enables the [multi-agent Slack channel](/guides/ai-agents/getting-started#setting-up-a-multi-agent-slack-channel) feature for the whole instance (default=false) | +| `SLACK_MULTI_AGENT_CHANNEL_ENABLED` | Enables the [multi-agent Slack channel (Beta)](/guides/ai-agents/getting-started#setting-up-a-multi-agent-slack-channel) feature for the whole instance (default=false) | ## GitHub Integration From e6656077cd90f42061eb5c8096446bd7f5266674 Mon Sep 17 00:00:00 2001 From: Tatiana Inama Date: Fri, 17 Apr 2026 11:39:30 +0200 Subject: [PATCH 3/3] docs: move multi-agent Slack channel note to enterprise on-prem Multi-agent Slack channels are an Enterprise AI agents sub-feature, so group the env var alongside AI_AGENTS_ENABLED in the on-prem feature-gating table rather than tacking a section onto the basic Slack app setup guide. --- .../configure-a-slack-app-for-lightdash.mdx | 8 -------- self-host/enterprise-on-prem.mdx | 1 + 2 files changed, 1 insertion(+), 8 deletions(-) diff --git a/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx b/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx index 17a9cc08..dc45f326 100644 --- a/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx +++ b/self-host/customize-deployment/configure-a-slack-app-for-lightdash.mdx @@ -146,11 +146,3 @@ Add the following environment variables to your Lightdash server configuration: #### Step 3: Re-install the Slack Integration After updating your environment variables, restart your Lightdash service, then re-install the Slack integration in your Lightdash instance to complete the Socket Mode setup. Your Slack integration will now use Socket Mode to communicate with Slack instead of HTTP webhooks. - -## Enable multi-agent Slack channels (Beta) - -By default, each AI agent can only be connected to one Slack channel. To allow multiple agents to share the same Slack channel, enable the [multi-agent Slack channel (Beta)](/guides/ai-agents/getting-started#setting-up-a-multi-agent-slack-channel) feature by setting the following environment variable on your Lightdash instance: - -* `SLACK_MULTI_AGENT_CHANNEL_ENABLED`: Set to `"true"` to enable multi-agent Slack channels for the whole instance (default=false) - -Restart your Lightdash service after updating the variable. Once enabled, configure the designated channel from **Organization Settings → Integrations → Slack**. diff --git a/self-host/enterprise-on-prem.mdx b/self-host/enterprise-on-prem.mdx index 90cd4694..2909f9df 100644 --- a/self-host/enterprise-on-prem.mdx +++ b/self-host/enterprise-on-prem.mdx @@ -51,6 +51,7 @@ Once your license key is active, most Enterprise features are controlled by envi |---------|---------------------|---------------| | Custom roles | `CUSTOM_ROLES_ENABLED=true` | [Custom roles](/references/workspace/custom-roles#custom-roles) | | AI agents | `AI_AGENTS_ENABLED=true` | [AI agents](/guides/ai-agents) | +| Multi-agent Slack channels (Beta) | `SLACK_MULTI_AGENT_CHANNEL_ENABLED=true` | [Multi-agent Slack channels](/guides/ai-agents/getting-started#setting-up-a-multi-agent-slack-channel) | | Caching | `RESULTS_CACHE_ENABLED=true` | [Caching](/guides/developer/caching) | | Embedding | `EMBEDDING_ENABLED=true` | [Embedding](/references/embedding) | | MCP | `MCP_ENABLED=true` | [MCP integration](/self-host/customize-deployment/configure-mcp-for-lightdash) |