Context: David Ortinau walked through the Foundry Agent Service GA announcement and docs as a .NET developer already using Agent Framework + M.E.AI + Foundry model endpoints. This documents what we found.
A .NET developer today using:
- Microsoft Agent Framework for agent orchestration
- Microsoft.Extensions.AI for model abstraction and tool integration
- Foundry/Azure endpoints (ai.azure.com) for model inference (GPT-4o, Whisper, etc.)
- Self-hosted on ASP.NET Core / Aspire / ACA
This is the stack we want people on. The question: what does Foundry Agent Service add, and how do you get there?
Agent Service is a separate product layer that sits on top of Foundry's model hosting. It is NOT an upgrade to your existing Foundry model deployments — it's an additional managed runtime you opt into.
Three agent types (overview):
| Type | What it is | Code required | Status |
|---|---|---|---|
| Prompt agents | Defined entirely through config — instructions, model, tools. Foundry owns orchestration. | No | GA |
| Workflow agents | Multi-step orchestration via visual builder or YAML. | No (YAML optional) | Preview |
| Hosted agents | Your containerized code deployed to Foundry's managed runtime. | Yes | Preview |
What Agent Service adds over raw model access:
- Managed agent hosting with autoscaling
- Built-in tracing and observability (Application Insights)
- Evaluation pipelines with continuous production monitoring (evals GA)
- Enterprise security: private networking, Entra RBAC, content filters
- MCP tool connections with managed auth (key-based, Entra, OAuth passthrough)
- Voice Live: real-time speech-to-speech (preview)
- Publishing agents to M365/Teams and Entra Agent Registry
- Conversation state management
What it does NOT replace:
- Your model deployments (those stay as-is)
- Your Agent Framework orchestration logic (you keep it for hosted agents)
- M.E.AI abstractions (still the foundation)
Source: Foundry Agent Service GA announcement (March 2026)
The blog says: "If you're building with the Responses API today, migrating to Foundry is minimal code changes."
This is confusing because:
- It targets developers on
api.openai.com(direct OpenAI), not developers already on Foundry - If you're already on Foundry calling model endpoints, you're NOT "on the Responses API" — you're on the chat completions API
- The blog conflates "using Foundry" (model hosting) with "using Agent Service" (managed agent runtime)
- A developer already inside Foundry reading this blog cannot tell if they need to do something
Also notable: Every code sample in the GA blog is Python. Zero C#. This is the Foundry team's flagship announcement and .NET is invisible.
| Doc | URL | C#? | Useful for migration? |
|---|---|---|---|
| Agent Service overview | link | N/A | Conceptual understanding |
| Quickstart (get-started-code) | link | ✅ C# tabs | Builds from scratch, not migration |
| Agent Framework → Foundry provider | link | ✅ C# code | Closest to migration path — shows Agent Framework connecting to Agent Service |
| Hosted agents concept | link | ✅ Listed in framework table | Deploy-your-container model, preview |
| Hosted agents quickstart | link | Step-by-step deploy, but Python-first | |
| Workshop (75 min) | link | ❌ Python only | Builds from scratch |
| Classic C# quickstart samples | link | ✅ | Samples, not migration guide |
This is the "bring your own code" path. You containerize your existing Agent Framework app and deploy it to Foundry's managed runtime.
What you'd do:
- Add NuGet packages:
Azure.AI.AgentServer.Core,Azure.AI.AgentServer.AgentFramework - Wrap your Agent Framework code with the hosting adapter
- The adapter exposes your agent as an HTTP service (Responses API compatible)
- Containerize (Dockerfile)
- Deploy via VS Code Foundry extension (supports C#) or
azd up(Python-first) - Foundry manages scaling, identity, conversation state, and the API surface
What you gain:
- Managed hosting (no ACA/App Service to manage)
- Foundry tracing and eval pipelines
- MCP auth management
- Publishable to M365/Teams
- Conversation state management
What you give up:
- Direct control over hosting infrastructure
- Aspire integration (unclear how this works with hosted agents)
- Possibly: networking flexibility (no private networking for hosted agents during preview)
Current status:
- Preview — not production-ready
- C# is listed as supported for Agent Framework hosted agents
- But the tooling (
azdCLI quickstart) only shows Python - The VS Code extension supports C# scaffolding for new projects
- No doc exists for migrating an existing Agent Framework app — only for creating new ones
This path means redefining your agent as a Foundry-managed prompt agent, where Foundry owns all orchestration.
What you'd do:
- Use
Azure.AI.ProjectsNuGet package - Create agent via
AIProjectClient.Agents.CreateVersion() - Register your tools as MCP servers or function calls on the Foundry side
- Interact via the Responses API through
project.GetOpenAIClient() - Give up Agent Framework orchestration entirely — Foundry handles it
What you gain:
- Fully managed, no container to build
- All Agent Service features (GA, not preview)
- Simplest operational model
What you give up:
- All Agent Framework orchestration logic
- Multi-agent patterns you've built
- M.E.AI middleware, filters, and extensibility
- Control over how tools are invoked and composed
- This is not a migration — it's a rebuild
There is no documentation that addresses this scenario:
"I have an existing .NET app using Agent Framework + M.E.AI calling Foundry model endpoints, self-hosted on ASP.NET/Aspire/ACA. How do I deploy this to Foundry Agent Service?"
The pieces exist across 4-5 different doc pages, but no one has stitched them into a coherent migration story. The closest doc is the Agent Framework Foundry provider page, which shows Agent Framework connecting to Agent Service — but it starts from scratch, not from an existing app.
This is the single most natural upgrade path for the developer we want to exist — a .NET developer already on our recommended stack — and it has no documented on-ramp.
-
Is Hosted Agents the intended landing zone for Agent Framework apps? Or is there a different deployment model we should expect? The preview status creates uncertainty.
-
What happens to Aspire? If you're using Aspire for local dev and orchestration today, how does that compose with Foundry Agent Service hosting? Is Aspire complementary, or does Foundry replace it?
-
Is the Agent Framework → Agent Service handoff actually seamless? Has anyone on the .NET team or customer base tried it end-to-end? The hosting adapter (
Azure.AI.AgentServer.AgentFramework) exists as a NuGet package, but we found no walkthrough. -
Why is the GA blog Python-only? Is this a content gap, or does it reflect that C# isn't ready? The quickstart has C# tabs, so the SDK exists — but the flagship narrative excludes .NET.
-
Who should we ask? Glenn Condron is working on Foundry templates and DX from the inside. Jeff Hollan owns Agent Service. The answer to "what's the .NET → Agent Service migration story" likely lives between them.
This research was conducted March 20, 2026 by walking the docs and GA blog as a .NET developer would. The confusion documented here is the actual developer experience.