Microsoft Agents Hosting - Dialogs
Dialog system for the Microsoft 365 Agents SDK. Provides waterfall dialogs, prompts, choice recognition, and multi-turn conversation management.
This library is a port of the botbuilder-dialogs library to the new Microsoft 365 Agents SDK. It provides the same dialog primitives (WaterfallDialog, ComponentDialog, DialogSet, DialogContext) and prompts (TextPrompt, NumberPrompt, ChoicePrompt, ConfirmPrompt, DateTimePrompt, OAuthPrompt, etc.) with updated imports and patterns for the new SDK.
What is this?
This library is part of the Microsoft 365 Agents SDK for Python - a comprehensive framework for building enterprise-grade conversational AI agents. The dialogs library enables developers to structure multi-turn conversations with reusable, composable dialog primitives.
Release Notes
| Version | Date | Release Notes |
|---|---|---|
| 1.5.0 | 2026-08-26 | 1.5.0 Release Notes |
| 1.4.0 | 2026-08-18 | 1.4.0 Release Notes |
| 1.3.0 | 2026-07-30 | 1.3.0 Release Notes |
| 1.2.0 | 2026-07-17 | 1.2.0 Release Notes |
| 1.1.0 | 2026-06-19 | 1.1.0 Release Notes |
| 1.0.0 | 2026-05-22 | 1.0.0 Release Notes |
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. |
Key Features
- WaterfallDialog: Sequential step-by-step conversation flows
- ComponentDialog: Composable, encapsulated dialog components
- Prompts: Built-in prompts for text, numbers, choices, confirmations, dates, attachments, and OAuth
- Choice recognition: Locale-aware choice matching and recognition
- Dialog memory: Scoped memory management (conversation, user, dialog, class, settings)
- DialogManager: High-level dialog orchestration with state management
Installation
pip install microsoft-agents-hosting-dialogs
Quick Start
from microsoft_agents.hosting.dialogs import (
WaterfallDialog,
WaterfallStepContext,
DialogSet,
DialogTurnStatus,
)
from microsoft_agents.hosting.dialogs.prompts import TextPrompt, PromptOptions
from microsoft_agents.hosting.core import ConversationState, MemoryStorage
storage = MemoryStorage()
conversation_state = ConversationState(storage)
dialog_state = conversation_state.create_property("DialogState")
dialogs = DialogSet(dialog_state)
async def step1(step: WaterfallStepContext):
return await step.prompt(
"text_prompt",
PromptOptions(prompt=MessageFactory.text("What is your name?"))
)
async def step2(step: WaterfallStepContext):
await step.context.send_activity(f"Hello, {step.result}!")
return await step.end_dialog()
dialogs.add(TextPrompt("text_prompt"))
dialogs.add(WaterfallDialog("main", [step1, step2]))
1 maintainer
Release files for microsoft-agents-hosting-dialogs 1.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| microsoft_agents_hosting_dialogs-1.5.0.tar.gz | 61.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| microsoft_agents_hosting_dialogs-1.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 160.0 kB
Release files / microsoft_agents_hosting_dialogs-1.5.0.tar.gz
| Download URL | microsoft_agents_hosting_dialogs-1.5.0.tar.gz |
|---|---|
| Size | 61.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6b64cf12b64dcf77c2c65ae9d57910c30515efe6e19e3f7ebd41d3278e5ba129
|
|
BLAKE2b-256 checksum How to use checksums |
82fe3650611887910ebb6dd0c3c73ceb2d36221965aaaee3c20e7c48090daf36
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
RestSharp/106.13.0.0
|
Release files / microsoft_agents_hosting_dialogs-1.5.0-py3-none-any.whl
| Download URL | microsoft_agents_hosting_dialogs-1.5.0-py3-none-any.whl |
|---|---|
| Size | 98.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
21f4f5efc7d345967bfc5748d350002c9c058ac0752198e0985cedd729ab27c3
|
|
BLAKE2b-256 checksum How to use checksums |
d6f33194b96793f498a78e97ed9991ed8760c0c7cfbb9aa0a5b14f6dd2feb0de
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
RestSharp/106.13.0.0
|
