Where to start in Microsoft Foundry
Neil Haddley • October 31, 2026
A 10,000-foot view of Microsoft Foundry for agents: what is open and cross-platform, what Microsoft adds and why, a suggested order to learn it in, and what is going away
Microsoft Foundry has a lot of places to learn from: samples, solution templates, quickstarts and a learning path. When I started, I could not tell which one to open first, or which parts were Microsoft's and which were not. So I read them all. This post is the short version: the big picture, and the Microsoft learning path I would follow.
An agent in one sentence
An agent is a model that can think, use tools, know things and team up with other agents, running with an identity that decides what it is allowed to do. Foundry is Microsoft's place to build, run and look after agents like that.
What is open, and what does Microsoft add?
Most of the ideas are not unique to Microsoft. They are cross-industry standards and open source, and that is a good thing: what you learn is not locked in, and your tools and agents can work with other platforms. Microsoft's contribution is mostly the work around them: running agents, finding your data and keeping everything safe.
- Open and cross-platform: MCP for tools, A2A for agents talking to agents, OpenTelemetry for traces, and the OpenAI-style Responses API and SDK for talking to models. For code you can use Microsoft's Agent Framework (MIT licence, .NET and Python), LangGraph (MIT) or your own. A2A is Apache 2.0, and I found it lives under its own
a2aprojectorganisation, with Google Cloud among the partners it names. I wrote about MCP, LangGraph with A2A and A2A in Foundry. - Microsoft adds: a place to host agents, one toolbox for tools, Foundry IQ and a memory store for knowledge, identity and roles for every agent, guardrails, and a way to publish to Teams and Microsoft 365.
The pattern: bring your own, and Microsoft runs it
The most useful thing I learned is a pattern. Foundry does not ask you to write agents its way. A hosted agent is your container, built with any framework, and Microsoft's own docs name Agent Framework, LangGraph, Semantic Kernel or plain custom code. Foundry then does the plumbing: it hosts the container, gives it an identity, and sends its traces to Application Insights through OpenTelemetry.
The edges speak open protocols. A hosted agent can answer on the Responses protocol, so any OpenAI-compatible SDK can talk to it. It can also answer on A2A, and it can use a custom Invocations protocol when the caller has its own format. Even the Microsoft-only parts show an open face:
- The toolbox exposes all its tools through one MCP endpoint.
- A Foundry IQ knowledge base is reached through an MCP endpoint too.
- The model catalog holds more than OpenAI models. Microsoft's page lists DeepSeek, Meta Llama, Mistral, Cohere, xAI and Black Forest Labs, and one of the samples runs an Anthropic Claude model through Foundry.
How portable is it?
Here is my rough sorting of the pieces. It is my judgement from reading the docs, not a promise.
| Piece | How portable | Why |
|---|---|---|
| Tools as MCP servers | High | An open protocol, and any MCP client can use them |
| Agents you expose over A2A | High | An open protocol, though implementations differ (see below) |
| Code in Agent Framework or LangGraph | High | Open source, and it runs in any container |
| Traces | High | OpenTelemetry |
| A prompt agent definition | Low | It lives in Foundry, with no open standard for it |
| Memory store, project connections | Low | Foundry features with no open equivalent |
| Roles and identity | Low | Microsoft Entra, so they are tied to Azure |
So I would put the valuable logic in the open layer, and let Foundry carry the plumbing. Then moving later would mean replacing the plumbing, not rewriting the agents.
Standards Microsoft supports, and what comes next
Here are the standards I saw Microsoft support in its own docs and samples. I did not find one official list, so this is what I found, not everything.
| Standard | Where Microsoft supports it |
|---|---|
| MCP | The MCP tool, the toolbox endpoint, Foundry IQ knowledge bases and MCP servers on Azure Functions |
| A2A | The A2A tool and a hosted agent's A2A endpoint. Protocol 1.0 is generally available and 0.3 stays in preview |
| OpenTelemetry | Hosted agents emit traces by default |
| OpenAPI | The OpenAPI tool |
| OpenAI Responses API and SDKs | Any OpenAI-compatible SDK works against a hosted agent |
| OpenID Connect | Federated sign-in from GitHub Actions to Azure in the CI/CD quickstart |
| Containers | Hosted agents are container images |
Three cautions. Microsoft's own protocols, such as the Activity protocol for Teams and Microsoft Entra for identity, are not cross-industry standards. I did not check which MCP spec version Foundry supports. And I did not find explicit support for other agent protocols such as AG-UI, only a mention that you can serve one through the custom Invocations protocol.
What Microsoft is working on with others. I looked for places where Microsoft says it is helping to develop a standard, not just use one. Here is what I could confirm from primary sources.
| Standard | What Microsoft says or does | Confidence |
|---|---|---|
| MCP: authorization and security | Microsoft says its Developer Division and Microsoft Security work with Anthropic and the MCP steering committee on the authorization spec and security practices | Stated by Microsoft |
| MCP: the C# SDK | Microsoft built the official C# SDK with Anthropic. Version 2.0 implements the July 2026 spec, the largest revision since launch | Stated by Microsoft |
| MCP: the registry | A community registry led by GitHub, Anthropic and others, which Microsoft's blog names as an example of its collaboration | Stated by Microsoft |
| A2A | A Linux Foundation project. The Linux Foundation says Microsoft integrated it into Foundry and Copilot Studio, and quotes a Microsoft architect | Stated by the Linux Foundation |
| OpenTelemetry: multi-agent traces | Microsoft's Foundry docs say Microsoft, with Cisco Outshift, contributes conventions for multi-agent systems. They are still in development | Stated by Microsoft |
| Agent identity | Microsoft's Entra Agent ID uses OAuth 2.0 token exchange. MCP's roadmap plans an agent identity working group. I found no Microsoft-authored IETF draft | Not confirmed |
Agent Skills (SKILL.md) | Anthropic developed it and released it as an open standard. Foundry's quickstarts use SKILL.md, but I found no sign that Microsoft helps develop it | Used, not co-developed |
Both big protocols now sit under the Linux Foundation. MCP moved to the Agentic AI Foundation in December 2025, and Anthropic's announcement lists Microsoft among its supporters. A2A is hosted by the Linux Foundation, with more than 150 supporting organisations.
Where the standards are heading. The MCP roadmap, dated August 2026, plans four things: long-running tasks and events, a simpler HTTP transport, agent identity (agents acting for a user who is not present) and a cleaner tool result shape. I find two of these interesting. Agent identity is the same theme as the roles and identities in the quickstarts, so the standards are moving towards agents, not just people, signing in. And MCP growing its own tasks starts to overlap with A2A's. I do not know how the two will fit together, so I would watch it. Both points are my reading.
What might become a standard next?
Earlier I said Microsoft's contribution is mostly the work around the standards: running agents, finding your data and keeping everything safe. Some of that work may harden into standards over time. Here is my guess, with the signal behind each one. These are guesses, not announcements.
| Piece | Signal I found | My guess |
|---|---|---|
| Agent identity | MCP's roadmap plans an agent identity working group. Microsoft's Entra Agent ID uses OAuth 2.0 token exchange. I found no finished IETF standard | Likely, and the most active area |
| Multi-agent traces | Microsoft and Cisco Outshift are contributing conventions to OpenTelemetry, still in development | Likely, because it is already under way |
| Finding agents and servers | The MCP community registry, A2A agent cards, and Foundry's control plane that registers A2A agents | Likely, since two open ways already exist |
| Finding your data | A Foundry IQ knowledge base is reached over an MCP endpoint | Partly. The access path is open, while the retrieval method inside is Microsoft's |
| Long-running work | MCP is adding tasks, and A2A already has them | Likely to converge, but I do not know how |
| Running agents | A hosted agent speaks the open Responses protocol and A2A, plus Microsoft's Activity protocol for Teams | Partly. The edges are open and the hosting is Microsoft's |
| Memory | A Foundry memory store with no open equivalent that I found | Unclear |
| Guardrails | Foundry guardrails and content safety, with no open equivalent that I found | Unclear |
The pattern I see is that the parts which cross a boundary tend to become standards first: who an agent is, how it is found, how its work is traced, and how it asks for something. The parts that sit inside one platform, such as memory and guardrails, are the least likely to.
What the retirements tell us
Most of what Microsoft is retiring is its own shape, but not all of it. Connected Agents and workflows were Foundry features. They are replaced by the open A2A tool and by Agent Framework, which is open source. Prompt flow is the exception that teaches the most: it was open source too, with an MIT-licensed public repository on GitHub. Its repository sits in Microsoft's own GitHub organisation, and I found no foundation or other vendors behind it. That is my reading, because I could not tell contributors' employers apart from the commit data. Being open source did not save it, and it is retiring on 20 April 2027, with Agent Framework as the recommended replacement.
So the lesson is not simply "open good, Microsoft-only bad". An open licence does not make a tool a standard. MCP, A2A and OpenTelemetry are different because many companies back them, not because their code is open. That is the signal I would look for before building on something: a standard with several backers, or a Microsoft-only tool, and which of the two it is.
Four kinds of agent
Foundry describes every agent with a kind. The first two are where I would start.
- Prompt agent: instructions, a model and tools, all defined in Foundry. Start here.
- Hosted agent: your own code, running as a container in Foundry.
- Voice agent: a managed agent you talk to. A side trip.
- Workflow: a visual flow of agents. Going away, see below.
Follow the learning path
The best single thing I found is a Microsoft Learn path, Develop AI agents on Azure. It has nine modules and takes about ten hours, and each module ends with a 30-minute lab. I read the module pages, not the labs. It is the nearest thing to an official order, so I would follow it and use my posts and the quickstarts to go deeper.
| Module | What you do | Where my posts fit |
|---|---|---|
| 1. Foundry and VS Code | Build a first agent in the portal, then manage it as a YAML file in VS Code | Part 1, a prompt agent |
| 2. Custom tools | Give an agent a Python function, an Azure Function or an OpenAPI tool | |
| 3. MCP tools | Build a small MCP server and connect an agent to it | My MCP series, and Part 3 |
| 4. Foundry IQ | Ground an agent in a knowledge base, with rules like "always cite, never guess" | Part 5, where I test the module's rules |
| 5. Microsoft 365 | Publish an agent to Teams and Copilot | |
| 6. Workflows | Build a visual flow of agents | Skip it, see below |
| 7. Agent Framework | Build an agent in code | Part 2, a hosted agent |
| 8. Multi-agent | Orchestrate agents in sequence, in parallel, as a group chat or with handoffs | |
| 9. A2A | Agent cards, an agent server and a client | Part 4, and LangGraph with A2A |
I liked the Foundry IQ module most. Its sample instructions are a good template for any agent that must answer from documents, and I tested them in Part 5.
The quickstarts, the samples and the templates are for after the path. A quickstart teaches one thing, a sample is code to copy, and a template shows a whole system.
What is going away
Skip these. I confirmed the first two on Microsoft's pages.
| What | Date | Use instead |
|---|---|---|
| Workflows | 1 December 2026 | Microsoft Agent Framework |
| Classic agents | 31 March 2027 | The new Foundry Agent Service |
| Prompt flow (my series) | 20 April 2027 | Agent Framework |
The Prompt flow date is stated in the project's own GitHub README. The learning path still has a workflows module, so skip that one. I did not check Microsoft's official retirement list, so confirm a date before you rely on it.