Create slack runner integration page #1521 - 4 by zyantw · Pull Request #2035 · google/adk-docs

zyantw · 2026-07-30T22:45:53Z

Rendered> https://deploy-preview-2035--adk-docs-preview.netlify.app/integrations/slack/
Pull request to upload Slack logo> #2036
PR> #1524
Original Issue> #1521

Adds the official integration documentation for SlackRunner.

Created docs/integrations/slack.md following the Plugin template.
Added Socket Mode installation and initialization instructions (google-adk[slack]).
Checked against the integration-review and integration-create instructions.

Adds the official integration documentation for `SlackRunner`. - Created `docs/integrations/slack.md` following the Plugin template. - Added Socket Mode installation and initialization instructions (`google-adk[slack]`). - Checked against the integration-review and integration-create instructions.

netlify · 2026-07-30T22:45:58Z

✅ Deploy Preview for adk-docs-preview ready!

Name	Link
🔨 Latest commit	`9ccc197`
🔍 Latest deploy log	https://app.netlify.com/projects/adk-docs-preview/deploys/6a6bdd660fe8130008d41a32
😎 Deploy Preview	https://deploy-preview-2035--adk-docs-preview.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

joefernandez · 2026-07-31T02:49:31Z

Technical Verification Against `google/adk-python`

1. Installation & Extra Dependencies — ✅ Verified

Doc Claim: pip install "google-adk[slack]"
Code Verification:
- In pyproject.toml, optional-dependencies.slack is explicitly defined as [ "slack-bolt>=1.22" ].
- In slack_runner.py, missing slack_bolt explicitly instructs the user to run pip install "google-adk[slack]".

2. Module Imports & Exports — ✅ Verified

Doc Claim: from google.adk.integrations.slack import SlackRunner and from google.adk.agents import Agent
Code Verification:
- SlackRunner is re-exported at slack/init.py.
- Agent is exported as an alias for LlmAgent at agents/init.py.

3. Slack Scopes & Socket Mode Prerequisites — ✅ Verified

Doc Claim: Requires bot token scopes (app_mentions:read, chat:write, im:history) and app-level token scope (connections:write).
Code Verification:
- SlackRunner._setup_handlers listens for app_mention and message (specifically direct messages im and threads).
- SlackRunner._handle_message dispatches messages via say, chat_update, and chat_delete (requiring chat:write).
- SlackRunner.start uses AsyncSocketModeHandler, which requires connections:write.
- Matches the repository integration reference in README.md.

4. API Reference Table — ✅ Verified

Doc Claim: __init__(runner, slack_app) and start(app_token)
Code Verification:
- SlackRunner.init accepts runner: Runner and slack_app: AsyncApp.
- SlackRunner.start accepts app_token: str.

Issues & Recommended Fixes for PR #2035

Issue 1: Missing Import of `InMemorySessionService`

File & Line: docs/integrations/slack.md, line 63
Problem: The example code instantiates session_service=InMemorySessionService(), but InMemorySessionService is not imported in lines 45–50. Running this code throws NameError: name 'InMemorySessionService' is not defined.
Fix: Add from google.adk.sessions import InMemorySessionService to the top import block.
Code Reference: sessions/init.py and sample agent.py.

Issue 2: Missing `auto_create_session=True` on `Runner`

File & Line: docs/integrations/slack.md, lines 60–64
Problem: In SlackRunner._handle_message, session IDs are dynamically formatted per channel/thread (e.g. f"{channel_id}-{thread_ts}"). Runner.__init__ defaults auto_create_session=False (runners.py). Without auto_create_session=True, incoming messages will fail with a SessionNotFoundError.
Fix: Add auto_create_session=True when initializing Runner(...).
Code Reference: Sample agent.py.

Issue 3: Minor Comment Formatting

File & Line: docs/integrations/slack.md, line 59
Problem: #Wire it up to Slack over Socket Mode is missing a space after #.

Suggested Corrected Code Block for `docs/integrations/slack.md`

import asyncio
import os
from google.adk.agents import Agent
from google.adk.runners import Runner
from google.adk.sessions import InMemorySessionService
from google.adk.integrations.slack import SlackRunner
from slack_bolt.app.async_app import AsyncApp

# Define the core agent
root_agent = Agent(
    model="gemini-flash-latest",
    name="slack_agent",
    instruction="You are a helpful team assistant running on Slack.",
)

# Wire it up to Slack over Socket Mode
runner = Runner(
    app_name="slack_agent",
    agent=root_agent,
    session_service=InMemorySessionService(),
    auto_create_session=True,
)
slack_app = AsyncApp(token=os.environ["SLACK_BOT_TOKEN"])
slack_runner = SlackRunner(runner, slack_app)

asyncio.run(slack_runner.start(os.environ["SLACK_APP_TOKEN"]))

joefernandez · 2026-07-31T02:51:29Z

+import os
+from google.adk.agents import Agent
+from google.adk.runners import Runner
+from google.adk.integrations.slack import SlackRunner


add:
from google.adk.sessions import InMemorySessionService

joefernandez · 2026-07-31T02:53:30Z

+runner = Runner(
+    app_name="slack_agent",
+    agent=root_agent,
+    session_service=InMemorySessionService(),


add:
auto_create_session=True,

joefernandez · 2026-07-31T02:54:19Z

+    instruction="You are a helpful team assistant running on Slack.",
+)
+
+#Wire it up to Slack over Socket Mode


add space to conform to comment syntax:
# Wire it...

joefernandez · 2026-07-31T02:56:22Z

+
+<div class="language-support-tag"><span class="lst-supported">Supported in ADK</span><span class="lst-python">Python</span></div>
+
+ADK provides the `SlackRunner` class to easily deploy your agents directly on Slack using [Socket Mode](https://api.slack.com/apis/connections/socket). This integration acts as an adapter that handles event listening, response dispatching, and automated conversation thread management.


to easily deploy --> to allow you to deploy

Avoid using descriptors like "easily"; just the facts.

joefernandez · 2026-07-31T02:59:04Z

+
+## Prerequisites
+
+- A Slack App configured in your [Slack API Dashboard](https://api.slack.com/apps). You must sign in to your Slack account first.


Remove "A " pre-amble from each of these bullets: not necessary

- Slack App... - **Bot User... - **Websocket...

joefernandez

Approved with comments.

joefernandez · 2026-07-31T03:00:45Z

+- A **Websocket App-Level Token** (`xapp-...`) with the `connections:write` scope.
+
+## Installation
+


add intro sentence explaining what this command does

joefernandez · 2026-07-31T03:00:58Z

+```
+
+## Use with agent
+


add intro sentence explaining what this code example does

koverholt · 2026-07-31T16:09:26Z

+---
+catalog_title: Slack
+catalog_description: Deploy ADK agents directly to Slack using Socket Mode.
+catalog_icon: /integrations/assets/slack-runner.png


This should be slack.png to be consistent with #2036 and other integration logo filenames.

Suggested change

catalog_icon: /integrations/assets/slack-runner.png

catalog_icon: /integrations/assets/slack.png

koverholt · 2026-07-31T16:09:48Z

@@ -0,0 +1,71 @@
+---
+catalog_title: Slack
+catalog_description: Deploy ADK agents directly to Slack using Socket Mode.


No period at the end of card descriptions. Also this description should be improved to be more technically accurate and describe to users what functionality it enables, something like the suggested description:

Suggested change

catalog_description: Deploy ADK agents directly to Slack using Socket Mode.

catalog_description: Run agents as bots that reply to mentions, DMs, and threads

koverholt · 2026-07-31T16:10:54Z

+catalog_title: Slack
+catalog_description: Deploy ADK agents directly to Slack using Socket Mode.
+catalog_icon: /integrations/assets/slack-runner.png
+catalog_tags: ["runner", "slack"]


These are not valid catalog tags to add, they will create arbitrary single-item categories, consider running the integration review skill to see if it recommends existing catalog tags or no catalog tabs.

koverholt · 2026-07-31T16:11:24Z

+## Available tools
+
+Tool | Description
+------ | -----------
+`__init__(runner, slack_app)` | Starts the Slack runner adapter with an ADK `Runner` and a Slack `AsyncApp`.
+`start(app_token)` | Starts the Slack runner listener in Socket Mode using your app-level websocket token.


These are adapter methods, not agent-callable tools. Every other ## Available tools table documents tools the agent invokes, usually for MCP tools whereas this is a different type of integration. Suggest removing this section since both methods already appear in the code above.

zyantw self-assigned this Jul 30, 2026

zyantw requested a review from joefernandez July 30, 2026 22:46

Update slack.md

9ccc197

joefernandez reviewed Jul 31, 2026

View reviewed changes

joefernandez approved these changes Jul 31, 2026

View reviewed changes

koverholt added the integration label Jul 31, 2026

koverholt reviewed Jul 31, 2026

View reviewed changes


		<div class="language-support-tag"><span class="lst-supported">Supported in ADK</span><span class="lst-python">Python</span></div>

		ADK provides the `SlackRunner` class to easily deploy your agents directly on Slack using [Socket Mode](https://api.slack.com/apis/connections/socket). This integration acts as an adapter that handles event listening, response dispatching, and automated conversation thread management.


		## Prerequisites

		- A Slack App configured in your [Slack API Dashboard](https://api.slack.com/apps). You must sign in to your Slack account first.

		- A Websocket App-Level Token (`xapp-...`) with the `connections:write` scope.

		## Installation

	catalog_icon: /integrations/assets/slack-runner.png
	catalog_icon: /integrations/assets/slack.png

	catalog_description: Deploy ADK agents directly to Slack using Socket Mode.
	catalog_description: Run agents as bots that reply to mentions, DMs, and threads

Uh oh!

Conversation

zyantw commented Jul 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

netlify Bot commented Jul 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for adk-docs-preview ready!

Uh oh!

joefernandez commented Jul 31, 2026

Technical Verification Against google/adk-python

1. Installation & Extra Dependencies — ✅ Verified

2. Module Imports & Exports — ✅ Verified

3. Slack Scopes & Socket Mode Prerequisites — ✅ Verified

4. API Reference Table — ✅ Verified

Issues & Recommended Fixes for PR #2035

Issue 1: Missing Import of InMemorySessionService

Issue 2: Missing auto_create_session=True on Runner

Issue 3: Minor Comment Formatting

Suggested Corrected Code Block for docs/integrations/slack.md

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

joefernandez Jul 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

joefernandez left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

zyantw commented Jul 30, 2026 •

edited

Loading

netlify Bot commented Jul 30, 2026 •

edited

Loading

Technical Verification Against `google/adk-python`

Issue 1: Missing Import of `InMemorySessionService`

Issue 2: Missing `auto_create_session=True` on `Runner`

Suggested Corrected Code Block for `docs/integrations/slack.md`

joefernandez Jul 31, 2026 •

edited

Loading