From e9ceb67f5b3e9e8eaac941486a5c4d72394282bf Mon Sep 17 00:00:00 2001 From: Sam Crowder Date: Mon, 3 Nov 2025 12:04:37 -0800 Subject: [PATCH 1/9] feat: add slack app install page for app verification --- src/docs.json | 3 +- src/langsmith/agent-builder-slack-install.mdx | 37 +++++++++++++++++++ 2 files changed, 39 insertions(+), 1 deletion(-) create mode 100644 src/langsmith/agent-builder-slack-install.mdx diff --git a/src/docs.json b/src/docs.json index 02ced8e1e0..a6da682225 100644 --- a/src/docs.json +++ b/src/docs.json @@ -1309,7 +1309,8 @@ "pages": [ "langsmith/agent-builder", "langsmith/agent-builder-setup", - "langsmith/agent-builder-tools" + "langsmith/agent-builder-tools", + "langsmith/agent-builder-slack-install" ] }, { diff --git a/src/langsmith/agent-builder-slack-install.mdx b/src/langsmith/agent-builder-slack-install.mdx new file mode 100644 index 0000000000..e29ff046b2 --- /dev/null +++ b/src/langsmith/agent-builder-slack-install.mdx @@ -0,0 +1,37 @@ +--- +title: Install LangSmith Agent Builder for Slack +description: Connect the LangSmith Agent Builder to your Slack workspace to power AI agents. +sidebarTitle: Slack installation +mode: wide +--- + +Install the LangSmith Agent Builder Slack app to enable your agents to interact with your Slack workspace. + +## Installation + +Click the button below to add the LangSmith Agent Builder to your Slack workspace: + + + Add to Slack + + +## What you can do + +Once installed, the LangSmith Agent Builder can: + +- Send direct messages to users +- Post messages to channels +- Reply in threads +- Read channel history +- Read thread messages + +## Getting started + +After installation, configure your agent in LangSmith: + +1. Navigate to Agent Builder in your [LangSmith workspace](https://smith.langchain.com) +2. Create or edit an agent +3. Add Slack as a trigger or enable Slack tools +4. Authorize the connection when prompted + +For full setup instructions, see the [Agent Builder documentation](/langsmith/agent-builder). From 1472966cba815b37def9ef96c39e5a377af6e8c7 Mon Sep 17 00:00:00 2001 From: Sam Crowder Date: Mon, 3 Nov 2025 12:44:09 -0800 Subject: [PATCH 2/9] ready for review --- src/langsmith/agent-builder-slack-install.mdx | 36 +++++++++++++------ 1 file changed, 25 insertions(+), 11 deletions(-) diff --git a/src/langsmith/agent-builder-slack-install.mdx b/src/langsmith/agent-builder-slack-install.mdx index e29ff046b2..d28e4fdb4a 100644 --- a/src/langsmith/agent-builder-slack-install.mdx +++ b/src/langsmith/agent-builder-slack-install.mdx @@ -5,15 +5,30 @@ sidebarTitle: Slack installation mode: wide --- -Install the LangSmith Agent Builder Slack app to enable your agents to interact with your Slack workspace. +The LangSmith Agent Builder Slack app enables your agents to interact with your Slack workspace. -## Installation +## How to install -Click the button below to add the LangSmith Agent Builder to your Slack workspace: +To install the LangSmith Agent Builder for Slack: - - Add to Slack - +1. Navigate to Agent Builder in your [LangSmith workspace](https://smith.langchain.com) +2. Create or edit an agent +3. Add Slack as a trigger or enable Slack tools +4. When prompted, authorize the Slack connection +5. Follow the OAuth flow to grant permissions to your Slack workspace + +The app will be installed automatically when you complete the authorization. + +## Permissions + +The LangSmith Agent Builder requires the following permissions: + +- **Send messages** - Send direct messages and post to channels +- **Read messages** - Read channel history and thread messages +- **View channels** - Access basic channel information +- **View users** - Look up user information for messaging + +These permissions enable agents to communicate effectively within your workspace. ## What you can do @@ -27,11 +42,10 @@ Once installed, the LangSmith Agent Builder can: ## Getting started -After installation, configure your agent in LangSmith: +After installation, configure your agent: -1. Navigate to Agent Builder in your [LangSmith workspace](https://smith.langchain.com) -2. Create or edit an agent -3. Add Slack as a trigger or enable Slack tools -4. Authorize the connection when prompted +1. Set up Slack as a trigger to activate your agent when messages are received +2. Enable Slack tools to allow your agent to send messages +3. Configure which channels or users your agent should monitor For full setup instructions, see the [Agent Builder documentation](/langsmith/agent-builder). From cb5154c57995c9d6ae1e125e70b1c3f0ae33ab3f Mon Sep 17 00:00:00 2001 From: Sam Crowder Date: Mon, 3 Nov 2025 13:22:20 -0800 Subject: [PATCH 3/9] Update src/langsmith/agent-builder-slack-install.mdx Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com> --- src/langsmith/agent-builder-slack-install.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/langsmith/agent-builder-slack-install.mdx b/src/langsmith/agent-builder-slack-install.mdx index d28e4fdb4a..5a270c5ab8 100644 --- a/src/langsmith/agent-builder-slack-install.mdx +++ b/src/langsmith/agent-builder-slack-install.mdx @@ -28,7 +28,7 @@ The LangSmith Agent Builder requires the following permissions: - **View channels** - Access basic channel information - **View users** - Look up user information for messaging -These permissions enable agents to communicate effectively within your workspace. +These permissions enable agents to communicate effectively within your Slack workspace. ## What you can do From 488373f7386f352cc32e0682adc21c411acd5a7f Mon Sep 17 00:00:00 2001 From: Sam Crowder Date: Mon, 3 Nov 2025 13:22:32 -0800 Subject: [PATCH 4/9] Update src/langsmith/agent-builder-slack-install.mdx Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com> --- src/langsmith/agent-builder-slack-install.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/langsmith/agent-builder-slack-install.mdx b/src/langsmith/agent-builder-slack-install.mdx index 5a270c5ab8..935c9fd986 100644 --- a/src/langsmith/agent-builder-slack-install.mdx +++ b/src/langsmith/agent-builder-slack-install.mdx @@ -21,7 +21,7 @@ The app will be installed automatically when you complete the authorization. ## Permissions -The LangSmith Agent Builder requires the following permissions: +The LangSmith Agent Builder requires the following permissions to your Slack workspace: - **Send messages** - Send direct messages and post to channels - **Read messages** - Read channel history and thread messages From 73c2be2131c613b3ef9285bc307d4c9e6029a913 Mon Sep 17 00:00:00 2001 From: Sam Crowder Date: Mon, 3 Nov 2025 13:23:07 -0800 Subject: [PATCH 5/9] Update src/langsmith/agent-builder-slack-install.mdx Co-authored-by: Kathryn May <44557882+katmayb@users.noreply.github.com> --- src/langsmith/agent-builder-slack-install.mdx | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/src/langsmith/agent-builder-slack-install.mdx b/src/langsmith/agent-builder-slack-install.mdx index 935c9fd986..1b94b1f76b 100644 --- a/src/langsmith/agent-builder-slack-install.mdx +++ b/src/langsmith/agent-builder-slack-install.mdx @@ -5,7 +5,17 @@ sidebarTitle: Slack installation mode: wide --- -The LangSmith Agent Builder Slack app enables your agents to interact with your Slack workspace. +Connect the LangSmith Agent Builder to your Slack workspace to enable AI agents that can interact directly with your team. + +After installation, your agents will be able to: + +- Send direct messages. +- Post to channels. +- Read thread messages. +- Reply in threads. +- Read conversation history. + +LangSmith Agent Builder integrates your agents with Slack for secure, context-aware communication inside your Slack workspace. ## How to install From 093334a26796ee63e293a0656a8cb357f453a6ea Mon Sep 17 00:00:00 2001 From: Sam Crowder Date: Mon, 3 Nov 2025 13:24:11 -0800 Subject: [PATCH 6/9] asdf --- src/langsmith/agent-builder-slack-install.mdx | 14 ++------------ 1 file changed, 2 insertions(+), 12 deletions(-) diff --git a/src/langsmith/agent-builder-slack-install.mdx b/src/langsmith/agent-builder-slack-install.mdx index 1b94b1f76b..f0636482c7 100644 --- a/src/langsmith/agent-builder-slack-install.mdx +++ b/src/langsmith/agent-builder-slack-install.mdx @@ -7,12 +7,12 @@ mode: wide Connect the LangSmith Agent Builder to your Slack workspace to enable AI agents that can interact directly with your team. -After installation, your agents will be able to: +After installation, your agents will be able to: - Send direct messages. - Post to channels. - Read thread messages. -- Reply in threads. +- Reply in threads. - Read conversation history. LangSmith Agent Builder integrates your agents with Slack for secure, context-aware communication inside your Slack workspace. @@ -40,16 +40,6 @@ The LangSmith Agent Builder requires the following permissions to your Slack wor These permissions enable agents to communicate effectively within your Slack workspace. -## What you can do - -Once installed, the LangSmith Agent Builder can: - -- Send direct messages to users -- Post messages to channels -- Reply in threads -- Read channel history -- Read thread messages - ## Getting started After installation, configure your agent: From 11ba9ef3e37fb9dcef9036995391ac4114d0b586 Mon Sep 17 00:00:00 2001 From: Sam Crowder Date: Mon, 3 Nov 2025 13:26:12 -0800 Subject: [PATCH 7/9] asdfgs --- src/langsmith/agent-builder-slack-install.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/src/langsmith/agent-builder-slack-install.mdx b/src/langsmith/agent-builder-slack-install.mdx index f0636482c7..b91dbd9871 100644 --- a/src/langsmith/agent-builder-slack-install.mdx +++ b/src/langsmith/agent-builder-slack-install.mdx @@ -21,11 +21,11 @@ LangSmith Agent Builder integrates your agents with Slack for secure, context-aw To install the LangSmith Agent Builder for Slack: -1. Navigate to Agent Builder in your [LangSmith workspace](https://smith.langchain.com) -2. Create or edit an agent -3. Add Slack as a trigger or enable Slack tools -4. When prompted, authorize the Slack connection -5. Follow the OAuth flow to grant permissions to your Slack workspace +1. Navigate to Agent Builder in your [LangSmith workspace](https://smith.langchain.com). +2. Create or edit an agent. +3. Add Slack as a trigger or enable Slack tools. +4. When prompted, authorize the Slack connection. +5. Follow the OAuth flow to grant permissions to your Slack workspace. The app will be installed automatically when you complete the authorization. From 30fde8013d26a6ea47fc1cb53fd1bd9f5a08ec04 Mon Sep 17 00:00:00 2001 From: Sam Crowder Date: Mon, 3 Nov 2025 13:27:28 -0800 Subject: [PATCH 8/9] asdf --- src/langsmith/agent-builder-slack-install.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/langsmith/agent-builder-slack-install.mdx b/src/langsmith/agent-builder-slack-install.mdx index b91dbd9871..1ca127e71f 100644 --- a/src/langsmith/agent-builder-slack-install.mdx +++ b/src/langsmith/agent-builder-slack-install.mdx @@ -44,8 +44,8 @@ These permissions enable agents to communicate effectively within your Slack wor After installation, configure your agent: -1. Set up Slack as a trigger to activate your agent when messages are received -2. Enable Slack tools to allow your agent to send messages -3. Configure which channels or users your agent should monitor +1. Set up Slack as a trigger to activate your agent when messages are received. +2. Enable Slack tools to allow your agent to send messages. +3. Configure which channels or users your agent should monitor. For full setup instructions, see the [Agent Builder documentation](/langsmith/agent-builder). From 242d0909914b22f171e9ce47bc7f36d580f23751 Mon Sep 17 00:00:00 2001 From: Sam Crowder Date: Mon, 3 Nov 2025 13:28:44 -0800 Subject: [PATCH 9/9] good enough --- src/langsmith/agent-builder-slack-install.mdx | 2 -- 1 file changed, 2 deletions(-) diff --git a/src/langsmith/agent-builder-slack-install.mdx b/src/langsmith/agent-builder-slack-install.mdx index 1ca127e71f..e627542634 100644 --- a/src/langsmith/agent-builder-slack-install.mdx +++ b/src/langsmith/agent-builder-slack-install.mdx @@ -5,8 +5,6 @@ sidebarTitle: Slack installation mode: wide --- -Connect the LangSmith Agent Builder to your Slack workspace to enable AI agents that can interact directly with your team. - After installation, your agents will be able to: - Send direct messages.