Skip to content

Releases: microsoft/Agents-for-net

v1.3 SDK Release

04 Dec 15:16
963a5f3

Choose a tag to compare

Microsoft 365 Agents SDK for .NET - Release Notes v1.3.0

Release Date: November 15, 2025
Previous Version: 1.2.0 (Released August 18, 2025)

🎉 What's New in 1.3.0

This release introduces first-class A2A hosting (preview), and Copilot Studio Connector (preview). It also brings extensible serialization, richer feedback orchestration, and bug fixes to help you build production-grade agent experiences.

🚀 Major Features & Enhancements

A2A Hosting (Preview)

  • Introduced the Microsoft.Agents.Hosting.AspNetCore.A2A.Preview library for support in exposting your SDK agent to A2A clients. (#391)
  • Added A2A sample agent (samples/A2AAgent, samples/A2ATCKAgent) that demonstrate basic A2A multi-turn tasks, and alignment with the A2A TCK. (#391)

Copilot Studio Agent Connector

  • Added the Copilot Studio Power Apps Connector implementation, including and a ready-to-run sample. This is in preview in Copilot Studio and not generally available for everyone. (#450)
  • Samples now default to requiring authentication and respect configured scopes when calling Copilot Studio services. (#472, #450)

Citation-Aware Responses

  • Improved streaming responses with citation management APIs, deduplication safeguards, and richer metadata on AI entities. (#427)
  • Added helper methods to MessageFactory and entity models so experiences can surface citations without hand-coding payloads. (#427)

Feedback Loop

  • Enabled feedback loop handling in AgentApplication, making it easier to capture user evaluations during conversations. This existed in the Teams Extension, but is now part of AgentApplication. Not all channels support this, but expanded support is coming. (#480)

📚 Documentation & Developer Experience

Expanded API Surface Descriptions

  • Added missing XML documentation for AgentApplicationBuilder, IAgentClient, IAgentHost, and quick view responses to improve IntelliSense and API discovery. (#417)
  • Clarified Teams channel support semantics in Channels to avoid confusion when routing agent traffic. (#430)

🔧 Developer Tools & Quality

Serialization Performance & Extensibility

  • Generated assembly-level serialization attributes to eliminate runtime scans and lowered cold-start costs. (#449, #441)
  • Introduced dynamic entity discovery via EntityNameAttribute and public registration hooks, enabling custom entity types without forking the serializer. (#465)
  • Refined entity cleanup and removal logic to prevent stale data from leaking between turns. (#463)

Analyzer & Build Infrastructure

  • Bundled analyzers inside Microsoft.Agents.Core and unified their target framework for consistent diagnostics. (37deeaf7, 5fa356d3)
  • Moved the repository to .NET SDK 8.0.414 to align with the latest LTS servicing updates. (#439, #481)

🔐 Authentication & Security Enhancements

  • Add support for Entra Agent ID Preview
  • Improved Multi-tenant detction for authenticaiton token support this will attempt to create a tenant specifice token for User Autheitcation and AgentID scenarios when the authority associated with current Agent identity is using the /common authority.5

🐛 Bug Fixes & Maintenance

  • Resolved failures when registering IAgent implementations via factories in multi-agent hosts. (#418)
  • Ensured Cosmos DB storage can reuse existing CosmosClient instances for dependency injection scenarios. (#446)
  • Improved route handlers to understand sub-channel identifiers and alternate blueprint connection names. (#458, #445)
  • Removed obsolete helper extensions and tightened activity validation to match the latest Teams schemas. (#461)

📦 New Package Information

  1. Microsoft.Agents.Hosting.AspNetCore.A2A.Preview – new preview package delivering A2A hosting (preview). (#391)

🚀 Getting Started

Upgrade your projects to the new release with:

dotnet add package Microsoft.Agents.Hosting.AspNetCore --version 1.3.0
dotnet add package Microsoft.Agents.Authentication.Msal --version 1.3.0

🙏 Acknowledgments

Thank you to the Microsoft 365 Agents team and the open-source community for the ideas, code reviews, and contributions that shaped this release.

📞 Support & Resources

Details - What's Changed

Read more

1.2.41 Nuget release

19 Aug 16:52

Choose a tag to compare

POSSIBLE BREAKING CHANGE FOR SOME DEVELOPERS:

Update ChannelID to support the fully qualified channel when working with Channels that include subChannels.

  • This update converts ChanneID to a class that contains the primary channel id and the subchannel id when sent.
    • The updated channel id will be formatted as : <channelid>:<subschannelid> see spec change request: microsoft/Agents#77
    • An example of this is M365 Copilot. Which will appear as msteams:copilot
  • Existing code using string compare will continue to function, however the comparisons will need to be updated if you want to apply the same or differing treatment to the subchannel
    • If your are using code such as this:
if (turnContext.Activity.ChannelId.Equals(Channels.Msteams))
{
  /// do work for teams 
}

you will need to update it as such:

if (turnContext.Activity.ChannelId.Equals(Channels.Msteams))
{
    // do stuff only for Teams channel
}

if (turnContext.Activity.ChannelId.IsParentChannel(Channels.Msteams))
{
    // do stuff for Teams channel and all sub-channels of teams
}

if (turnContext.Activity.ChannelId.Equals(Channels.M365Copilot))
{
    // do stuff for M365 Copilot channel which will appear as "msteams:copilot"
}

Changes Summary:

Added: Support for generating an Azure.Core TokenCredential for ICredential Provider based authentication modules.
Added: Support for hosting multiple distinct agent endpoint in a single hosting process.
Added: Initial support for Copilot Studio Agent-to-Agent Connector authentication support.
Updated: Blob Storage provider to provide additional BlobContainerClient features.
Reorganized and optimized code around how we handle deliveryMode ExpectReplies.
Teams Extension: Added Support for Teams Shared Channels.

What's Changed

Full Changelog: v1.1.0...v1.2.0

v1.1.151 Nuget release

16 Jul 15:56

Choose a tag to compare

Significant Improvements / Bug fixes

  • Fixed several bugs around managing user token expiration for user authorization tokens to reduce the frequency of communication with Entra ID
  • Fixed issues relating to some Teams Auth Centric SSO behaviors that would cause the system fail to acquire an auth token for a user that the user should have otherwise been able to acquire.
  • Fixed several behavior issues with Agent SDK Host operating as a Skill, and in Agent to Agent Mode for Copilot Studio, specifically dealing with the behavior of the system when operating in Expect Replies mode.
  • Improved handling of InvokeReplies and hardened the behavior with relation to teams.
    Teams client ported from Teams AI lib v1.
  • Added Net Standard 2.0 target for Non-Hosting libraries to support internal and external partner system dependencies on Agent SDK modules.
  • Added support for Pre-Route user authorization handlers, this will allow a developer to request that 1 or more user authorization tokens be available to the turn operation at execution time.
  • Added support for Workload Identity
  • Microsoft Teams added Microsoft.Agents.Extensions.Teams.AI lib porting over Teams AI v1 and part of v2 AI lib support.
  • Microsoft Teams improved teams operations support in Microsoft.Agents.Extensions.Teams to include additional features for

Dependency Updates:

  • Updated several package versions in Directory.Packages.props, including Microsoft.SemanticKernel packages, System.Runtime.Caching, and Microsoft.Bcl.AsyncInterfaces. Added new dependencies such as PolySharp and JsonSchema.Net. [1] [2] [3] [4]

Workflow Adjustments:

  • Added a new Linux-specific CI workflow (ci-linux.yml) for local build and test.
  • Modified the existing CI workflow (ci.yml) to target Windows instead of Linux.

Detailed What's Changed:

Read more

Nuget Release version 1.0.1

14 Jul 03:24

Choose a tag to compare