Skip to main content
A Slack channel lets people invoke a managed deep agent through app mentions, direct messages, and replies in an active Slack thread. Managed Deep Agents verifies Slack events, maps each conversation to a thread, runs the agent as the resolved caller, and posts the response back to Slack. Managed Deep Agents creates and configures the resources that connect Slack to the deployed agent. Add a channel declaration to the agent project, then deploy.
Managed Deep Agents is in public beta and available on LangSmith Cloud in the US region only.

​
Project structure

​
Add a Slack channel

A managed deep agent deployment supports one Slack channel. The channel declaration lives at channels/slack.ts. To include Slack when you create a project, pass --channel slack:
To add Slack to an existing project, run the channel initialization command from the project root:
channels/slack.ts

​
Configure your agent’s appearance in Slack

Edit the channel declaration to control how the agent appears in Slack.
​
string
The agent name in Slack. The name must contain 1–35 characters and can contain letters, numbers, spaces, underscores, dashes, and periods. It cannot start or end with a space or dash.
​
string
A description of what the agent does. The description can contain up to 139 characters.
​
string
A path to the agent icon shown in Slack, relative to the channels/ directory. The icon must be a 512 by 512 pixel PNG file no larger than 1 MB. If you omit this parameter, Managed Deep Agents will generate an icon for you.
​
string
The background color behind the agent icon as a six-digit hexadecimal color, such as #1d4ed8.
For example, put an icon next to the channel declaration:
channels/slack.ts

​
Configure which messages start runs

​
boolean
default:"false"
Whether every new channel message can start an agent run. When false, channel messages start runs only when they mention the agent; direct messages still start runs.
​
boolean
default:"false"
Whether messages from other Slack bots can start agent runs.

​
Deploy the agent

During deployment, Managed Deep Agents provisions your agent in Slack from the channel declaration.
1

Deploy your agent

Run the deployment command from the project root:
Managed Deep Agents deploys the agent and sets up the resources it needs to appear in Slack.
2

Authorize Slack if prompted

If you haven’t authorized LangSmith before, the CLI displays an HTTPS authorization link. Open the link, select the Slack workspace, and approve the requested access.Return to the terminal and press Enter. The CLI checks the authorization again and continues provisioning. If the Slack workspace requires admin approval, complete that approval before continuing.
3

Use the agent in Slack

After the first deployment, your agent sends you a direct message in Slack. Reply to the message to start an agent run. The final response appears in the Slack conversation.
Human-in-the-loop requests in Slack support only the approve and reject decision types.
If Slack is already authorized, deployment completes without an authorization prompt. After you change the agent’s name, description, icon, or background color in the Slack channel declaration, redeploy the agent to apply the changes in Slack.

​
See also

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.
Edit this page on GitHub or file an issue.