16 Apr 16:26

rodrigobr-msft

642f4bc

Microsoft 365 Agents SDK for Python - Release Notes v0.9.0 Latest

Latest

Microsoft 365 Agents SDK for Python - Release Notes v0.9.0

Release Date: April 15, 2026
Previous Version: 0.8.0 (Released February 23, 2026)

Major Features & Enhancements

OpenTelemetry Support: Full distributed tracing and metrics support with traces spanning adapter, app, auth, OAuth, storage, and turn-context layers. Includes a new OTel sample and comprehensive test coverage (#341)
Proactive Messaging: New proactive module in AgentApplication with Conversation, ConversationBuilder, and ConversationReferenceBuilder abstractions for initiating outbound conversations (#350)
FederatedCredentials Auth Type: Support for Managed Identity with Federated Identity Credential (FIC) authentication type in MSAL auth (#353)
PFX Certificate Auth: Support for PFX files in MSAL Certificate authentication type (#349)

Bug Fixes

MCS Connector: Fixed incorrect connector creation in RestChannelServiceClientFactory for MCS channels (#360)
FastAPI JWT Middleware: Fixed parity with aiohttp by correcting async handling in JWT authorization middleware (#343)
OpenTelemetry Testing Utility: Fixed DeltaMetricReader test utility (#362)

Developer Experience

Streaming Consolidation: Moved StreamingResponse, Citation, and CitationUtil from hosting-aiohttp and hosting-fastapi into hosting-core, eliminating duplication (#339)
PyJWKClient Caching: Added thread-safe JWK client caching with a dedicated JwkClientManager class to reduce redundant token-key fetches (#338)
Connector Validation: Improved response-data validation in ConversationsOperations methods with added test coverage (#317)

Documentation

Packages Overview: Added missing microsoft-agents-hosting-fastapi entry to the README packages overview (#346)

Assets 2

16 Apr 16:25

rodrigobr-msft

v0.8.0

b1adaaf

Microsoft 365 Agents SDK for Python - Release Notes v0.8.0

Release Date: February 23, 2026
Previous Version: 0.7.0 (Released January 21, 2026)

Major Features & Enhancements

Microsoft Copilot Studio (MCS) Connector: Full MCS connector support with OAuth OBO token exchange, new connector_user role type, and copilot_studio channel enum value (#295)
Enhanced Multi-Tenant Authentication: Dynamic MSAL client resolution with robust authority and tenant handling for multi-tenant scenarios. Updated MSAL version (#301, #307)
Integration Testing Framework Overhaul: Replaced legacy data-driven test infrastructure with a modern scenario-based framework. Introduces Scenario, ClientFactory, and AgentClient abstractions; a fluent assertion API with per-item field-mismatch reporting; a new CLI with env, chat, post, and scenario run commands; and a @pytest.mark.agent_test plugin exposing agent internals as fixtures (#315)
Copilot Studio Client – DirectConnect URL Support: Added direct_connect_url parameter to ConnectionSettings for simplified single-URL connection setup, bypassing environment-ID lookup. Includes automatic cloud-based token-audience resolution from the URL (#325)

New Models & APIs

StartRequest: Advanced conversation-start options with optional locale and conversation_id parameters (#325)
SubscribeEvent / SubscribeRequest / SubscribeResponse: Models for real-time event streaming with SSE resumption support (#325)
UserAgentHelper: Utility class that automatically injects SDK version and platform information into HTTP User-Agent headers (#325)
ConnectionSettings.populate_from_environment(): Static method that loads ConnectionSettings from environment variables (#325)
use_experimental_endpoint / enable_diagnostics: New ConnectionSettings flags for experimental endpoint capture and HTTP diagnostic logging (#325)

Bug Fixes

FastAPI JWT Middleware: Removed incorrect await from synchronous get_anonymous_claims() call in FastAPI JWT middleware (#299)

Developer Experience

JWT Token Decode Demo: New Adaptive Card integration demonstrating JWT token decode functionality (#307)

Assets 2

04 Feb 21:22

cleemullins

0.7.0

d6e4106

0.7.0 Agents M365 SDK for Python Release Latest

Microsoft 365 Agents SDK for Python - Release Notes v0.7.0

Release Date: January 21, 2026
Previous Version: 0.6.1 (Released December 2, 2025)

Enhancements

Authentication & Token Management: Centralized token scope handling with new get_token_scope method in ClaimsIdentity for consistent scope determination across ChannelServiceAdapter and RestChannelServiceClientFactory (#290)
Storage Backend Improvements: AsyncTokenCredential support for CosmosDB and Blob Storage configurations, with enhanced async resource cleanup and improved error handling (#283)
Copilot Studio Integration: Configurable aiohttp.ClientSession creation through ConnectionSettings.client_session_kwargs parameter for custom HTTP client behavior (#278)
Configuration & Logging: Log configuration support via .env file with new configure_logging function (#230)

Documentation

Installation instructions simplified by removing test PyPI references (#284)

Assets 2

02 Dec 19:08

rodrigobr-msft

v0.6.1

9537e44

0.6.1 Agents M365 SDK for Python Release

Microsoft 365 Agents SDK for Python - Release Notes v0.6.1

Release Date: December 1, 2025
Previous Version: 0.6.0 (Released November 18, 2025)

Changes Documented

Build & Packaging: Version file support via VERSION.txt with MANIFEST.in inclusion (#261, #263)
Bug Fix: OAuth _SignInState serialization refactored to use Pydantic BaseModel (#264)

Assets 2

02 Dec 18:54

rodrigobr-msft

v0.6.0

c602a1c

0.6.0 Agents M365 SDK for Python Release

Microsoft 365 Agents SDK for Python - Release Notes v0.6.0

Release Date: November 18, 2025
Previous Version: 0.5.0 (Released October 22, 2025)

Major Features

FastAPI Integration Package (#176) - New microsoft-agents-hosting-fastapi hosting option
Distributed Error Resources (#223, #237, #240) - Standardized error codes (-60000 to -66999 ranges) with help URLs across all packages
TypingIndicator Simplification (#212) - Explicit start()/stop() API, removed async locking complexity

Bug Fixes

ChannelServiceAdapter.create_conversation flow (#233)
Streaming disabled for agentic requests on Teams (#243)
HTTP client error handling with precise status code checks (#202)
M365Copilot channel detection (#208, #210)
Copilot Studio client conversation ID persistence (#195)
Default max conversation ID length reduced to 150 (#196)

Documentation

Contributing guidelines for internal/external developers (#234)
Type hints and docstring improvements (#207, #214)
CODEOWNERS unified to agents-sdk team (#199)

Assets 2

23 Oct 18:15

cleemullins

v0.5.0

1695c1a

0.5.0 Agents M365 SDK for Python Release

Microsoft 365 Agents SDK for Python - Release Notes v0.5.0

Release Date: October 22, 2025
Previous Version: 0.4.0 (Released October 7, 2025)

🎉 What's New in 0.5.0

This release represents a significant step forward in the Microsoft 365 Agents SDK for Python, focusing on enhanced Python version support, improved developer experience, and robust new features for building enterprise-grade conversational agents.

🔄 Breaking Changes

Python Version Requirements

Dropped Support: Python 3.9 is no longer supported
New Minimum: Python 3.10 is now the minimum required version
Migration: Update your Python environment to 3.10 or later before upgrading

Import Structure (from previous releases)

If you haven't already migrated from earlier versions, note the import structure change:

# Old (no longer supported)
from microsoft.agents.activity import Activity

# New (current)
from microsoft_agents.activity import Activity

🚀 Major Features & Enhancements

Expanded Python Version Support

The SDK now officially supports Python versions 3.10 through 3.14, providing developers with flexibility to use the latest Python features and improvements. This aligns with the currently supported versions of Python.

Key Changes:

Added support for Python 3.12, 3.13, and 3.14
Updated minimum Python requirement to 3.10 (dropped Python 3.9 support)
Updated CI/CD pipelines to test against all supported Python versions
Enhanced compatibility testing across the Python ecosystem

Pull Requests:

Sub-Channel Identification Support

A powerful new feature that enables agents to handle complex channel routing and identification scenarios.

New Capabilities:

Enhanced Activity model with sub-channel identification
New ChannelId class for managing channel routing
Support for channel-specific entity handling
Improved conversation routing and context management

Technical Details:

Added _channel_id_field_mixin.py for channel ID management
Enhanced Activity serialization with channel identification
New entity types for product information and geo-coordinates
Comprehensive test coverage for sub-channel scenarios

Pull Request:

#150 - Support sub channel identification from Activities

📚 Documentation & Developer Experience

Comprehensive Library Documentation

Each package now includes detailed README files with examples, installation instructions, and usage guidance.

New Documentation:

Individual README files for all 8 core libraries
PyPI-friendly descriptions for better package discovery
Comprehensive SDK overview and getting started guides
Sample code and best practices for each component

Libraries with New Documentation:

microsoft-agents-activity - Core activity handling and models
microsoft-agents-authentication-msal - MSAL authentication integration
microsoft-agents-copilotstudio-client - Copilot Studio connectivity
microsoft-agents-hosting-aiohttp - AIOHTTP-based hosting
microsoft-agents-hosting-core - Core hosting functionality
microsoft-agents-hosting-teams - Microsoft Teams integration
microsoft-agents-storage-blob - Azure Blob Storage support
microsoft-agents-storage-cosmos - Azure Cosmos DB storage

Pull Request:

#157 - Author README files for each library and integrate into PyPI descriptions

Enhanced Type Annotations

Improved code clarity and IDE support through comprehensive type annotations across the SDK.

Improvements:

Enhanced type hints for better IntelliSense support
Improved static analysis capabilities
Better error detection during development
Consistent typing patterns across all modules

Pull Request:

#162 - Enhance type annotations in various modules

🔧 Developer Tools & Quality Improvements

PyTest Warning Cleanup

Eliminated test warnings to provide a cleaner development experience and stricter quality enforcement.

Quality Improvements:

Cleaned up test classes to eliminate PyTest warnings
Enhanced test reliability and consistency
Improved CI/CD pipeline stability
Better error reporting and debugging

Pull Request:

🔐 Authentication & Security Enhancements

OAuth Flow Consolidation

Simplified OAuth authentication flows for better security and ease of use.

Improvements:

Consolidated OAuth flow begin_flow calls into single API
New getTokenOrSignInResource API for streamlined authentication
Reduced complexity in authentication setup
Improved security patterns and best practices

Pull Request:

#146 - Consolidating OAuthFlow begin_flow calls

License Information

Added comprehensive license information to all package configurations for better compliance and transparency.

Changes:

Modernize license tagging in all pyproject.toml files
Improved package metadata for PyPI
Enhanced compliance with open source standards
Better legal clarity for enterprise adoption

Pull Request:

#161 - Add license information to pyproject.toml files

🐛 Bug Fixes & Maintenance

Activity Model Improvements

Removed deprecated "delay" activity type to simplify the activity model and improve clarity.

Changes:

Removed "delay" activity as an implied activity type
Simplified activity handling logic
Improved activity model consistency

Pull Request:

#149 - Remove "delay" activity as an implied activity

Documentation Fixes

Multiple rounds of documentation improvements for better clarity and accuracy.

Improvements:

Fixed documentation comments across multiple modules
Improved code examples and usage patterns
Enhanced API documentation
Better consistency in documentation style

Pull Requests:

📦 Package Information

Included Libraries

This release includes the following 8 core libraries:

microsoft-agents-activity - Core activity models and handling
microsoft-agents-authentication-msal - MSAL authentication integration
microsoft-agents-copilotstudio-client - Copilot Studio client connectivity
microsoft-agents-hosting-aiohttp - AIOHTTP-based agent hosting
microsoft-agents-hosting-core - Core hosting functionality and abstractions
microsoft-agents-hosting-teams - Microsoft Teams-specific hosting
microsoft-agents-storage-blob - Azure Blob Storage integration
microsoft-agents-storage-cosmos - Azure Cosmos DB storage integration

Python Version Support

Supported Versions: Python 3.10, 3.11, 3.12, 3.13, 3.14
Minimum Required: Python 3.10
Recommended: Python 3.11 or later for optimal performance

🚀 Getting Started

Installation

Install individual packages as needed:

pip install microsoft-agents-activity
pip install microsoft-agents-hosting-core
pip install microsoft-agents-hosting-aiohttp
# ... other packages as needed

Quick Start

from microsoft_agents.activity import Activity
from microsoft_agents.hosting.core import TurnContext
from microsoft_agents.hosting.aiohttp import start_agent_process

# Your agent implementation here

Sample Applications

Explore comprehensive samples and documentation at:

🙏 Acknowledgments

Special thanks to all contributors who made this release possible, including the Microsoft 365 Agents team and the open source community for their valuable feedback and contributions.

📞 Support & Resources

Documentation: Microsoft 365 Agents SDK
Issues: GitHub Issues
Samples: Agent Samples Repository
Community: Join our developer community discussions

For technical support and questions, please use the GitHub Issues page or refer to our comprehensive documentation and samples.

Assets 2

Releases: microsoft/Agents-for-python