Microsoft Releases .NET SDK for Agent-User Protocol

Microsoft has released a new .NET SDK for AG-UI, the Agent-User Interaction protocol, in collaboration with CopilotKit. This development empowers C# developers to standardize communication between AI agents and user-facing applications.

The .NET SDK for AG-UI is now publicly available within the AG-UI repository, residing alongside its TypeScript and Python counterparts. It is distributed on NuGet, an open-source package manager, under the permissive MIT license. This C# implementation of AG-UI integrates seamlessly into any .NET service, providing a versatile tool for developers. Microsoft further confirmed that AG-UI support within the Microsoft Agent Framework (MAF) now relies on this new .NET SDK for enhanced functionality.

Standardizing Agent-User Interaction with AG-UI

The AG-UI protocol functions as an event-driven system, facilitating dynamic interactions between AI agents and front-end applications. This architecture allows a back-end system to generate AG-UI events directly, which a client application then consumes from an agent, regardless of the programming language used. The protocol organizes these interactions into eight distinct categories, ensuring comprehensive coverage of various agent activities and user interface responses.

Life-cycle events are essential for monitoring the progression of agent operations, providing insights into their current status and overall execution. Text message events manage the continuous flow of textual content, enabling real-time communication and updates from agents. Tool call events specifically handle the execution of various tools by agents, allowing for complex tasks and external service integrations.

State management events are crucial for synchronizing data and conditions between agents and the user interface, ensuring consistency across the application. Activity events represent ongoing processes, providing visual feedback on tasks in progress. Subagent events track the activities of secondary agents and attribute their outputs appropriately, supporting modular agent designs.

Special events offer flexibility for implementing unique functionalities tailored to specific application requirements. Draft events are included to propose new functionalities or interactions that are currently under development, facilitating an iterative development process. This structured approach to event handling makes AG-UI a robust framework for agent-user communication.

Technical Architecture and Implementation

The .NET SDK for AG-UI supports bidirectional communication, enabling agents to both send and receive AG-UI events. The AGUI.Server component transforms an agent into an AG-UI endpoint, allowing it to emit events and interact with clients. Conversely, AGUI.Client enables a .NET application to consume events from an AG-UI endpoint, integrating agent outputs directly into the application logic. Both AGUI.Server and AGUI.Client leverage a shared set of AG-UI primitives, ensuring consistency and interoperability.

The .NET SDK for AG-UI ships as a collection of five specialized packages on NuGet, each serving a distinct purpose in the overall architecture. AGUI.Abstractions defines the fundamental elements of the protocol, including events, messages, tools, and capabilities, along with JSON serialization mechanisms. This package establishes the core vocabulary for AG-UI interactions.

AGUI.Formatting provides abstractions for event stream formatters and includes support for Server-Sent Events (SSE), a standard for unidirectional communication from a server to a client over HTTP. AGUI.Protobuf offers a protobuf codec, enabling binary event stream formatting for efficient data transfer. This can be particularly beneficial in scenarios requiring high performance and reduced bandwidth usage.

AGUI.Client encompasses the AG-UI HTTP client and its integration with IChatClient, providing the necessary components for .NET applications to connect to and receive events from AG-UI endpoints. AGUI.Server serves as the server-side adapter, converting ChatResponseUpdate streams into AG-UI events, thereby enabling agents to broadcast their activities and messages to connected clients. These packages collectively provide a comprehensive toolkit for developers to implement and utilize the AG-UI protocol within their .NET projects.

Getting Started and Community Engagement

Microsoft has provided several resources to assist developers in getting started with the .NET SDK for AG-UI. The official AG-UI .NET SDK source code and sample applications are available for reference and experimentation. Comprehensive AG-UI documentation offers detailed explanations of the protocol’s functionalities and usage. Additionally, a dedicated blog post from CopilotKit provides insights into their collaboration and the SDK’s capabilities.

For developers integrating the SDK with Microsoft Agent Framework, specific documentation on Microsoft Learn offers guidance. Migration notes for the Microsoft Agent Framework are also available to assist with transitioning existing projects. Microsoft encourages community engagement by welcoming questions and feedback regarding the SDK directly within the AG-UI repository. For inquiries related to Microsoft Agent Framework integration, developers are directed to the dedicated discussion boards. This commitment to community support aims to foster a collaborative environment for the continued development and improvement of the AG-UI .NET SDK.