Today, we’re thrilled to announce that Microsoft Agent Framework has reached version 1.0 for both .NET and Python. This is the production-ready release: stable APIs, and a commitment to long-term support. Whether you’re building a single assistant or orchestrating a fleet of specialized agents, Agent Framework 1.0 gives you enterprise-grade multi-agent orchestration, multi-provider model support, and cross-runtime interoperability via A2A and MCP.
When we introduced Microsoft Agent Framework last October, we set out to unify the enterprise-ready foundations of Semantic Kernel with the innovative orchestrations of AutoGen into a single, open-source SDK. When we hit Release Candidate in February, we locked the feature surface and invited the community to put it through its paces. Today, after months of feedback, hardening, and real-world validation with customers and partners, Agent Framework 1.0 is ready for production.
Create Your First Agent
Getting started takes just a few lines of code. Here’s how to create a simple agent in both languages.
Python
# pip install agent-framework
# Use `az login` to authenticate with Azure CLI
import asyncio
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential
agent = Agent(
client= FoundryChatClient(
project_endpoint="https://your-project.services.ai.azure.com",
model="gpt-5.3",
credential=AzureCliCredential(),
),
name="HelloAgent",
instructions="You are a friendly assistant."
)
print(asyncio.run(agent.run("Write a haiku about shipping 1.0.")))
.NET
// dotnet add package Microsoft.Agents.AI.OpenAI --prerelease
using Microsoft.Agents.AI;
using Microsoft.Agents.AI.Foundry
using Azure.Identity;
// Replace the <apikey> with your OpenAI API key.
var agent = new AIProjectClient(endpoint:"https://your-project.services.ai.azure.com")
.GetResponsesClient("gpt-5.3")
.AsAIAgent(
name: "HaikuBot",
instructions: "You are an upbeat assistant that writes beautifully."
);
Console.WriteLine(await agent.RunAsync("Write a haiku about shipping 1.0."));
That’s it – a working AI agent in a handful of lines. From here you can add function tools, sessions for multi-turn conversations, streaming responses, and more.
Multi-Agent Workflows
Single agents are powerful, but real-world applications often need multiple agents working together. Here’s a sequential workflow where a copywriter drafts a tagline and a reviewer provides feedback:
Python
import asyncio
from agent_framework import Agent, Message
from agent_framework.foundry import FoundryChatClient
from agent_framework.orchestrations import SequentialBuilder
from azure.identity import AzureCliCredential
async def main() -> None:
# credentials read from .env
client = FoundryChatClient(credential=AzureCliCredential())
writer = Agent(
client=client,
instructions="You are a concise copywriter. Provide a single, punchy marketing sentence.",
name="writer",
)
reviewer = Agent(
client=client,
instructions="You are a thoughtful reviewer. Give brief feedback on the previous message.",
name="reviewer",
)
workflow = SequentialBuilder(participants=[writer, reviewer]).build()
outputs: list[list[Message]] = []
async for event in workflow.run("Write a tagline for Microsoft Agent Framework 1.0.", stream=True):
if event.type == "output":
outputs.append(cast(list[Message], event.data))
if outputs:
for msg in outputs[-1]:
print(f"[{msg.author_name or 'user'}]: {msg.text}")
if __name__ == "__main__":
asyncio.run(main())
and check out the .NET version here: Getting Started with Workflows
What’s in version 1.0
Version 1.0 represents the features we’ve battle-tested, stabilized, and committed to supporting with full backward compatibility going forward.
- Single Agent and Service Connectors – The core agent abstraction is stable and production-ready across both .NET and Python. Agent Framework ships with first-party service connectors for Microsoft Foundry, Azure OpenAI, OpenAI, Anthropic Claude, Amazon Bedrock, Google Gemini and Ollama. [Learn more… ]
- Middleware Hooks – The middleware pipeline lets you intercept, transform, and extend agent behavior at every stage of execution: content safety filters, logging, compliance policies, custom logic – all without modifying agent prompts. [Learn more… ]
- Agent Memory and Context Providers – Pluggable memory architecture supporting conversational history, persistent key-value state, and vector-based retrieval. Choose your backend: Memory in Foundry Agent Service, Mem0, Redis, Neo4j or use a custom store. [Learn more…]
- Agent Workflows – The graph-based workflow engine for composing agents and functions into deterministic, repeatable processes is now stable. Build workflows that combine agent reasoning with business logic, branch on conditions, fan out to parallel steps, and converge results. Checkpointing and hydration ensure long-running processes survive interruptions. [Learn more… ]
- Multi-Agent Orchestration – Stable support for the orchestration patterns that emerged from Microsoft Research and AutoGen: sequential, concurrent, handoff, group chat, and Magentic-One. All patterns support streaming, checkpointing, human-in-the-loop approvals, and pause/resume for long-running workflows. [Learn more…]
- Declarative Agents and Workflows (YAML) – Define agents’ instructions, tools, memory configuration, and orchestration topology in version-controlled YAML files, then load and run them with a single API call. [Learn more… ]
- A2A, and MCP – MCP (Model Context Protocol) support lets agents dynamically discover and invoke external tools exposed over MCP-compliant servers. A2A (Agent-to-Agent) protocol (A2A 1.0 support coming soon) support enables cross-runtime agent collaboration – your agents can coordinate with agents running in other frameworks using structured, protocol-driven messaging. [Learn more…]
- Migration Assistants (Semantic Kernel and AutoGen) – For teams coming from Semantic Kernel or AutoGen, migration assistants analyze your existing code and generate step-by-step migration plans. The Semantic Kernel migration guide and AutoGen migration guide provide detailed walkthroughs.
What’s new since the October release
We’re also shipping with preview features that are functional and available for early adoption. These APIs may evolve based on community feedback before reaching ‘stable’.
- DevUI – browser-based local debugger for visualizing agent execution, message flows, tool calls, and orchestration decisions in real time. [Learn more… ]
- Foundry Hosted Agent Integration – run Agent Framework agents as managed services on Microsoft Foundry or as Azure Durable Functions. [Learn more… ]
- Foundry Tools, Memory, Observability and Evaluations – deep integration with Foundry’s managed tool ecosystem, memory, and OpenTelemetry-powered observability and evaluations dashboards. [Learn more… ]
- AG-UI / CopilotKit / ChatKit – stream agent output to frontend surfaces with adapters for CopilotKit and ChatKit, including tool execution status and human-in-the-loop flows. [Learn more… ]
- Skills – reusable domain capability packages (instructions + scripts + resources)) that give agents structured capabilities out of the box. [Learn more… ]
- GitHub Copilot SDK and Claude Code SDK — use GitHub Copilot SDK or Claude Code as an agent harness directly from your Agent Framework orchestration code. These SDKs handle the autonomous agent loop – planning, tool execution, file edits, and session management – and Agent Framework wraps them, letting you compose a coding-capable agent alongside other agents (Azure OpenAI, Anthropic, custom) in the same multi-agent workflow. [Learn more… ]
- Agent Harness — customizable Microsoft Agent Framework harness and local runtime giving agents access to shell, file system, and messaging loop for coding agents, automation, and personal assistant patterns. [Learn more… ]
Getting Started
If you’ve been running on the RC packages, upgrading to 1.0 is a package version bump. If you’re new to Agent Framework, install and go:
Python
pip install agent-framework
.NET
dotnet add package Microsoft.Agents.AI
Check out the quickstart guide for walkthroughs in both languages, or jump straight to the samples on GitHub.
Coming from AutoGen or Semantic Kernel? Now is the time to migrate to Microsoft Agent Framework. The Semantic Kernel migration guide and AutoGen migration guide provide detailed walkthroughs.
What’s Next
Version 1.0 is a beginning, not a destination. We’re continuing to invest in graduating preview features, expanding the connector and skills ecosystem, deepening Foundry integration, and incorporating the latest orchestration research from Microsoft Research. The framework is 100% open source – we build in the open, and your feedback and contributions shape what comes next.
Thank you to everyone who filed issues, submitted PRs, tested release candidates, and pushed us to make Agent Framework better. This milestone belongs to the community as much as it does to the team.
Get started today:
- Download the SDK: aka.ms/AgentFramework
- Documentation: aka.ms/AgentFramework/Docs
- GitHub: github.com/microsoft/agent-framework
- Discord: aka.ms/foundry/discord
- NuGet (.NET): Microsoft.Agents.AI
- PyPI (Python): agent-framework
The post Microsoft Agent Framework Version 1.0 appeared first on Microsoft Agent Framework.

