How microsoft/agent-framework works
Microsoft Agent Framework is a .NET and Python framework for building and operating AI agents and multi-agent workflows. The principal journey is to configure an agent with a model provider, run it on user input, and use its response or coordinate it within a workflow. Separate capabilities cover workflow durability and streaming, declarative agents, hosting, observability, developer UI, and provider integrations. The README documents these product relationships; sampled source confirms selected agent, workflow, provider, telemetry, and storage implementations, but does not establish all runtime wiring.
Main entry points: AIAgent.cs Agent API · GroupChatManager.cs Workflow Engine · DevUIMiddleware.cs Developer UI · _chat_client.py OpenAI Provider
Components 21
Agent Runtime
- Agent API
dotnet/src/Microsoft.Agents.AI.Abstractions/AIAgent.cs - Agent Responses
dotnet/src/Microsoft.Agents.AI.Abstractions/AgentResponseUpdate.cs - Python Core
python/packages/core/agent_framework/_clients.py - Core Types
python/packages/core/agent_framework/_types.py
Model Providers
- OpenAI Provider
python/packages/openai/agent_framework_openai/_chat_client.py - Foundry Provider
dotnet/src/Microsoft.Agents.AI.Foundry/FoundryAgent.cs - Anthropic Provider
dotnet/src/Microsoft.Agents.AI.Anthropic/AnthropicClientExtensions.cs - Copilot Provider
dotnet/src/Microsoft.Agents.AI.GitHub.Copilot/GitHubCopilotAgent.cs
Workflow Orchestration
- Workflow Engine
dotnet/src/Microsoft.Agents.AI.Workflows/GroupChatManager.cs - Workflow Expressions
dotnet/src/Microsoft.Agents.AI.Workflows.Declarative/PowerFx/WorkflowExpressionEngine.cs - Checkpointing
python/packages/azure-cosmos/agent_framework_azure_cosmos/_checkpoint_storage.py
Hosting and Operations
- Conversation Storage
dotnet/src/Microsoft.Agents.AI.Hosting.OpenAI/Conversations/InMemoryConversationStorage.cs - Foundry Hosting
dotnet/src/Microsoft.Agents.AI.Foundry.Hosting/FoundryHostingAgent.cs - A2A Hosting
dotnet/src/Microsoft.Agents.AI.Hosting.A2A/A2AAgentHandler.cs - Developer UI
dotnet/src/Microsoft.Agents.AI.DevUI/DevUIMiddleware.cs - Observability
python/packages/core/agent_framework/observability.py
Agent Extensions
- Middleware
dotnet/src/Microsoft.Agents.AI.AgentHooks/Core/AgentHooksChatClient.cs - Declarative Agents
dotnet/src/Microsoft.Agents.AI.Declarative/PromptAgentFactory.cs - Agent Skills
python/packages/core/agent_framework/__init__.py
Other components
- User
- Model Services
Connections 19
- User → Agent API: provides input
README.md - Agent API → Agent Responses: returns response
dotnet/src/Microsoft.Agents.AI.Abstractions/AIAgent.cs - Agent API → Workflow Engine: coordinates agents
dotnet/src/Microsoft.Agents.AI.Workflows/GroupChatManager.cs - Workflow Engine → Workflow Expressions: evaluates declarations
- Workflow Engine → Checkpointing: persists checkpoints
README.md - Agent API → Python Core: shared framework role
- OpenAI Provider → Model Services: sends model requests
- Foundry Provider → Model Services: sends model requests
- Anthropic Provider → Model Services: connects provider
- Copilot Provider → Model Services: connects provider
- Agent API → Middleware: supports middleware
README.md - Declarative Agents → Agent API: defines agents
README.md - Agent API → Conversation Storage: stores conversations
- Foundry Hosting → Agent API: hosts agents
README.md - A2A Hosting → Agent API: exposes agents
- Developer UI → Agent API: supports debugging
README.md - Agent API → Observability: enables observability
README.md - Agent API → Agent Skills: uses skills
README.md - User → Developer UI: develops workflows
README.md