This release is a pre-release and may not be stable for production use.
Microsoft Agents Hosting - Slack
Build Slack agents with the Microsoft 365 Agents SDK using typed message and event handlers, direct Slack Web API calls, and streaming responses.
Packages Overview
We offer the following PyPI packages to create conversational experiences based on Agents:
| Package Name | PyPI Version | Description |
|---|---|---|
microsoft-agents-activity |
 |
Types and validators implementing the Activity protocol spec. |
microsoft-agents-hosting-core |
 |
Core library for Microsoft Agents hosting. |
microsoft-agents-hosting-aiohttp |
 |
Configures aiohttp to run the Agent. |
microsoft-agents-hosting-fastapi |
 |
Configures fastapi to run the Agent. |
microsoft-agents-hosting-msteams |
 |
Provides classes to host an Agent for Teams. |
microsoft-agents-hosting-dialogs |
 |
Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
microsoft-agents-hosting-slack |
 |
Provides classes to host an Agent for Slack. |
microsoft-agents-storage-blob |
 |
Extension to use Azure Blob as storage. |
microsoft-agents-storage-cosmos |
 |
Extension to use CosmosDB as storage. |
microsoft-agents-authentication-msal |
 |
MSAL-based authentication for Microsoft Agents. |
microsoft-agents-authentication-entra-auth-sidecar |
 |
Credential-free Entra ID Agent ID authentication via the sidecar. |
Installation
pip install microsoft-agents-hosting-slack
Usage
Given configured application options (including storage) and a connection manager:
from microsoft_agents.hosting.core.app import AgentApplication
from microsoft_agents.hosting.core.app.state import TurnState
from microsoft_agents.hosting.slack import SlackAgentExtension, SlackTurnContext
app = AgentApplication[TurnState](options, connection_manager=connections)
slack = SlackAgentExtension(app)
@slack.message()
async def on_slack_message(context: SlackTurnContext, state: TurnState) -> None:
channel_data = context.activity.slack_channel_data
await slack.call(
context,
"chat.postMessage",
{
"channel": channel_data.channel,
"text": f"You said: {context.activity.text}",
},
token=channel_data.api_token or "",
)
Use @slack.message("hello") for a specific message or @slack.event("reaction_added")
for a specific event. Both accept a string, a compiled regular expression, or a list of
either, and match only Slack activities. When called without a selector, they match every
Slack message or event and register at RouteRank.LAST, so more specific routes win.
on_message() and on_event() are deprecated aliases.
@slack.conversation_update(...), @slack.members_added(), @slack.members_removed(),
and @slack.installation_update() mirror the corresponding AgentApplication route
hooks, but match only Slack activities and pass a SlackTurnContext to the handler.
Handlers receive a SlackTurnContext with typed activity.slack_channel_data and
access to the per-turn Slack API client through context.client. Envelope, payload,
and response models support nested lookups such as envelope.get("event.channel")
and typed lookups such as response.get("count", type_=int).
Use slack.create_stream(context, thread_ts=...) to start a SlackStream, then
append content and stop the stream. See the API docstrings for routing options,
client configuration, streaming requirements, and lookup behavior.
Quick Links
1 maintainer
Metadata
1 maintainer
Release files for microsoft-agents-hosting-slack 1.9.0.dev10
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| microsoft_agents_hosting_slack-1.9.0.dev10.tar.gz | 18.6 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| microsoft_agents_hosting_slack-1.9.0.dev10-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 43.3 kB
Release files / microsoft_agents_hosting_slack-1.9.0.dev10.tar.gz
| Download URL | microsoft_agents_hosting_slack-1.9.0.dev10.tar.gz |
|---|---|
| Size | 18.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ae725f6985a640cd00f1fa5fbfef6e94e9d5a0acc5d9ebafb172844ea6da0ca5
|
|
BLAKE2b-256 checksum How to use checksums |
b4158c66b32dcdd50ec60e95bda0ed025c273c608da6acddcebe659b54e02b87
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
RestSharp/106.13.0.0
|
Release files / microsoft_agents_hosting_slack-1.9.0.dev10-py3-none-any.whl
| Download URL | microsoft_agents_hosting_slack-1.9.0.dev10-py3-none-any.whl |
|---|---|
| Size | 24.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a175b3264c346a832cf1a635a26cc3d09b5d12580664532b7ce29144f88d2a27
|
|
BLAKE2b-256 checksum How to use checksums |
64e8309c017e7d62473a082895358b066d84cb145a334bf5e76a0dd4501614c6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
RestSharp/106.13.0.0
|
Security for microsoft-agents-hosting-slack 1.9.0.dev10
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
