Key insight
The Agent 365 SDK does not create or host agents. It extends agents already built on any stack with enterprise capabilities: an Entra-backed identity, notifications, full observability, and governed access to Microsoft 365 data through Model Context Protocol servers, all within an IT-approved blueprint. Picture three layers: your chosen framework’s orchestrator runtime at the bottom, your own agent logic in the middle, and enterprise capabilities from the Agent 365 SDK on top — it complements the Microsoft 365 Agents SDK rather than replacing it.
The tools covered so far help you build an agent’s reasoning and choose where it shows up. This article covers a different, later concern: turning an agent that already works into one an enterprise can actually trust, govern, and audit.
1 · A name that trips people up
The Agent 365 SDK sounds, on first hearing, like it should build agents the way the frameworks covered earlier in this level do. It does not. It “does not create or host agents”; instead, it enhances agents you have already built — regardless of the underlying stack — by adding enterprise capabilities such as Entra-based agent identity, governed tool access, and observability. Understanding that distinction up front avoids the most common confusion around this tool.
2 · Three layers: orchestrator, logic, enterprise capabilities
The cleanest mental model is three stacked layers. At the bottom, the LLM orchestrator runtime — model invocation and tool orchestration — provided by whichever agent software development kit or framework you chose to build with. In the middle, agent logic — prompts, workflows, reasoning — your own implementation, written in your own code. On top, enterprise capabilities — identity, notifications, observability, tooling — provided by the Agent 365 SDK.
Each layer is provided by a different party, and each does one job. Your chosen framework runs the model. You write the logic. The Agent 365 SDK adds the enterprise shell around both, without needing to know or care what is happening inside the layers beneath it.
3 · What the SDK actually gives an agent
Concretely, once wired in, an agent gains five things. First, an Entra-backed agent identity with its own resources, such as a mailbox, for secure authentication and controlled access, exactly the identity construct covered in Level 200. Second, it can receive and respond to notifications from Teams, Outlook, and Word comments, just like a human participant in those apps. Third, it gains full observability through OpenTelemetry, an open industry tracing standard, making every interaction, tool call, and model invocation auditable. Fourth, it can invoke governed Model Context Protocol servers to reach Microsoft 365 data, such as mail, calendars, and Teams, entirely under administrator control. And fifth, it runs within an IT-approved blueprint, so every instance automatically inherits the compliance, governance, and security policy that blueprint carries.
4 · Why it complements rather than competes
A natural question: does this replace the Microsoft 365 Agents SDK covered in the previous article? No. The Agent 365 SDK “doesn’t replace the Microsoft 365 Agents SDK,” which continues to provide hosting, the underlying activity protocol, and identity plumbing. Instead, the Agent 365 SDK complements it “by layering governance, compliance, and lifecycle controls on top of agents built with it or other platforms.” Whatever hosts and runs your agent keeps doing that job; the Agent 365 SDK adds the enterprise shell around it.
5 · The Agent 365 CLI
Alongside the software development kit sits the Agent 365 CLI (command-line interface), described as the “command-line backbone for Agent 365 throughout the agent development lifecycle.” It automates setup, identity, configuration, tool integration, publishing, and deployment to the cloud, giving developers a single, consistent command-line path through the practical steps of making an agent enterprise-ready, rather than performing each step by hand through separate portals.
The Agent 365 SDK does not build your agent’s brain — it gives the agent you already built an identity, a voice in Teams and Outlook, an audit trail, and governed access to your organisation’s data.
6 · Glossary — every short-form term, spelled out
- Agent 365 SDK
- A software development kit that extends agents built on any stack with enterprise identity, observability, notifications, security, and governed data access.
- LLM orchestrator runtime
- The layer that invokes the underlying AI model and coordinates its tools, provided by the developer’s chosen agent framework.
- Agent logic
- The prompts, workflows, and reasoning a developer writes for their agent.
- Entra-backed agent identity
- An agent identity issued and managed through Microsoft Entra, giving the agent its own resources and secure authentication.
- OpenTelemetry (OTel)
- An open industry standard for capturing telemetry and tracing across software systems.
- Model Context Protocol (MCP) server
- A governed connector that lets an agent reach data and tools, such as Microsoft 365 mail or calendars, under administrator control.
- Agent identity blueprint
- A reusable, IT-approved template that agent instances inherit compliance and governance policy from.
- CLI (command-line interface)
- A tool operated through typed commands rather than a graphical interface; the Agent 365 CLI automates setup, identity, configuration, and deployment.
The Agent 365 SDK does not create or host agents; it extends agents already built on any stack.
Picture three layers: the orchestrator runtime from your chosen framework, your own agent logic, and enterprise capabilities from the Agent 365 SDK on top.
It gives an agent an Entra-backed identity, notifications in Teams and Outlook, full OpenTelemetry observability, governed access via MCP servers, and inherited blueprint compliance.
It complements, rather than replaces, the Microsoft 365 Agents SDK, which still handles hosting and the activity protocol.
The Agent 365 CLI is the command-line backbone automating setup, identity, configuration, tool integration, publishing, and deployment.
References
- Microsoft Learn, Microsoft Agent 365 SDK Overview. learn.microsoft.com
- Microsoft Learn, Microsoft Agent 365 SDK and CLI — how it differs, layered architecture, CLI. learn.microsoft.com
- Microsoft Learn, Get started with Agent 365 development — observability instrumentation options. learn.microsoft.com