{"id":31462065,"url":"https://github.com/microsoft/agent-framework","last_synced_at":"2026-04-15T23:01:00.055Z","repository":{"id":317527345,"uuid":"974445592","full_name":"microsoft/agent-framework","owner":"microsoft","description":"A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET.","archived":false,"fork":false,"pushed_at":"2026-04-10T12:30:25.000Z","size":85869,"stargazers_count":9265,"open_issues_count":773,"forks_count":1512,"subscribers_count":96,"default_branch":"main","last_synced_at":"2026-04-10T12:34:58.066Z","etag":null,"topics":["agent-framework","agentic-ai","agents","ai","dotnet","multi-agent","orchestration","python","sdk","workflows"],"latest_commit_sha":null,"homepage":"https://aka.ms/agent-framework","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/microsoft.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":"SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-28T19:40:42.000Z","updated_at":"2026-04-10T12:32:31.000Z","dependencies_parsed_at":"2025-10-16T10:37:44.732Z","dependency_job_id":"7cdbaed5-f3cc-4f7e-89ca-8b62496dda8b","html_url":"https://github.com/microsoft/agent-framework","commit_stats":null,"previous_names":["microsoft/agent-framework"],"tags_count":138,"template":false,"template_full_name":null,"purl":"pkg:github/microsoft/agent-framework","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagent-framework","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagent-framework/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagent-framework/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagent-framework/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/microsoft","download_url":"https://codeload.github.com/microsoft/agent-framework/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/microsoft%2Fagent-framework/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31863499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-framework","agentic-ai","agents","ai","dotnet","multi-agent","orchestration","python","sdk","workflows"],"created_at":"2025-10-01T15:57:15.945Z","updated_at":"2026-04-15T23:01:00.035Z","avatar_url":"https://github.com/microsoft.png","language":"Python","readme":"![Microsoft Agent Framework](docs/assets/readme-banner.png)\n\n# Welcome to Microsoft Agent Framework!\n\n[![Microsoft Foundry Discord](https://dcbadge.limes.pink/api/server/b5zjErwbQM?style=flat)](https://discord.gg/b5zjErwbQM)\n[![MS Learn Documentation](https://img.shields.io/badge/MS%20Learn-Documentation-blue)](https://learn.microsoft.com/en-us/agent-framework/)\n[![PyPI](https://img.shields.io/pypi/v/agent-framework)](https://pypi.org/project/agent-framework/)\n[![NuGet](https://img.shields.io/nuget/v/Microsoft.Agents.AI)](https://www.nuget.org/profiles/MicrosoftAgentFramework/)\n\nWelcome to Microsoft's comprehensive multi-language framework for building, orchestrating, and deploying AI agents with support for both .NET and Python implementations. This framework provides everything from simple chat agents to complex multi-agent workflows with graph-based orchestration.\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.youtube.com/watch?v=AAgdMhftj8w\" title=\"Watch the full Agent Framework introduction (30 min)\"\u003e\n    \u003cimg src=\"https://img.youtube.com/vi/AAgdMhftj8w/hqdefault.jpg\"\n         alt=\"Watch the full Agent Framework introduction (30 min)\" width=\"480\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.youtube.com/watch?v=AAgdMhftj8w\"\u003e\n    Watch the full Agent Framework introduction (30 min)\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## 📋 Getting Started\n\n### 📦 Installation\n\nPython\n\n```bash\npip install agent-framework\n# This will install all sub-packages, see `python/packages` for individual packages.\n# It may take a minute on first install on Windows.\n```\n\n.NET\n\n```bash\ndotnet add package Microsoft.Agents.AI\n```\n\n### 📚 Documentation\n\n- **[Overview](https://learn.microsoft.com/agent-framework/overview/agent-framework-overview)** - High level overview of the framework\n- **[Quick Start](https://learn.microsoft.com/agent-framework/tutorials/quick-start)** - Get started with a simple agent\n- **[Tutorials](https://learn.microsoft.com/agent-framework/tutorials/overview)** - Step by step tutorials\n- **[User Guide](https://learn.microsoft.com/en-us/agent-framework/user-guide/overview)** - In-depth user guide for building agents and workflows\n- **[Migration from Semantic Kernel](https://learn.microsoft.com/en-us/agent-framework/migration-guide/from-semantic-kernel)** - Guide to migrate from Semantic Kernel\n- **[Migration from AutoGen](https://learn.microsoft.com/en-us/agent-framework/migration-guide/from-autogen)** - Guide to migrate from AutoGen\n\nStill have questions? Join our [weekly office hours](./COMMUNITY.md#public-community-office-hours) or ask questions in our [Discord channel](https://discord.gg/b5zjErwbQM) to get help from the team and other users.\n\n### ✨ **Highlights**\n\n- **Graph-based Workflows**: Connect agents and deterministic functions using data flows with streaming, checkpointing, human-in-the-loop, and time-travel capabilities\n  - [Python workflows](./python/samples/03-workflows/) | [.NET workflows](./dotnet/samples/03-workflows/)\n- **AF Labs**: Experimental packages for cutting-edge features including benchmarking, reinforcement learning, and research initiatives\n  - [Labs directory](./python/packages/lab/)\n- **DevUI**: Interactive developer UI for agent development, testing, and debugging workflows\n  - [DevUI package](./python/packages/devui/)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.youtube.com/watch?v=mOAaGY4WPvc\"\u003e\n    \u003cimg src=\"https://img.youtube.com/vi/mOAaGY4WPvc/hqdefault.jpg\" alt=\"See the DevUI in action\" width=\"480\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.youtube.com/watch?v=mOAaGY4WPvc\"\u003e\n    See the DevUI in action (1 min)\n  \u003c/a\u003e\n\u003c/p\u003e\n\n- **Python and C#/.NET Support**: Full framework support for both Python and C#/.NET implementations with consistent APIs\n  - [Python packages](./python/packages/) | [.NET source](./dotnet/src/)\n- **Observability**: Built-in OpenTelemetry integration for distributed tracing, monitoring, and debugging\n  - [Python observability](./python/samples/02-agents/observability/) | [.NET telemetry](./dotnet/samples/02-agents/AgentOpenTelemetry/)\n- **Multiple Agent Provider Support**: Support for various LLM providers with more being added continuously\n  - [Python examples](./python/samples/02-agents/providers/) | [.NET examples](./dotnet/samples/02-agents/AgentProviders/)\n- **Middleware**: Flexible middleware system for request/response processing, exception handling, and custom pipelines\n  - [Python middleware](./python/samples/02-agents/middleware/) | [.NET middleware](./dotnet/samples/02-agents/Agents/Agent_Step11_Middleware/)\n\n### 💬 **We want your feedback!**\n\n- For bugs, please file a [GitHub issue](https://github.com/microsoft/agent-framework/issues).\n\n## Quickstart\n\n### Basic Agent - Python\n\nCreate a simple Azure Responses Agent that writes a haiku about the Microsoft Agent Framework\n\n```python\n# pip install agent-framework\n# Use `az login` to authenticate with Azure CLI\nimport os\nimport asyncio\nfrom agent_framework import Agent\nfrom agent_framework.foundry import FoundryChatClient\nfrom azure.identity import AzureCliCredential\n\n\nasync def main():\n    # Initialize a chat agent with Microsoft Foundry\n    # the endpoint, deployment name, and api version can be set via environment variables\n    # or they can be passed in directly to the FoundryChatClient constructor\n    agent = Agent(\n      client=FoundryChatClient(\n          credential=AzureCliCredential(),\n          # project_endpoint=os.environ[\"FOUNDRY_PROJECT_ENDPOINT\"],\n          # model=os.environ[\"FOUNDRY_MODEL_DEPLOYMENT_NAME\"],\n      ),\n      name=\"HaikuBot\",\n      instructions=\"You are an upbeat assistant that writes beautifully.\",\n    )\n\n    print(await agent.run(\"Write a haiku about Microsoft Agent Framework.\"))\n\nif __name__ == \"__main__\":\n    asyncio.run(main())\n```\n\n### Basic Agent - .NET\n\nCreate a simple Agent, using OpenAI Responses, that writes a haiku about the Microsoft Agent Framework\n\n```c#\n// dotnet add package Microsoft.Agents.AI.OpenAI --prerelease\nusing Microsoft.Agents.AI;\nusing OpenAI;\nusing OpenAI.Responses;\n\n// Replace the \u003capikey\u003e with your OpenAI API key.\nvar agent = new OpenAIClient(\"\u003capikey\u003e\")\n    .GetResponsesClient(\"gpt-4o-mini\")\n    .AsAIAgent(name: \"HaikuBot\", instructions: \"You are an upbeat assistant that writes beautifully.\");\n\nConsole.WriteLine(await agent.RunAsync(\"Write a haiku about Microsoft Agent Framework.\"));\n```\n\nCreate a simple Agent, using Microsoft Foundry with token-based auth, that writes a haiku about the Microsoft Agent Framework\n\n```c#\n// dotnet add package Microsoft.Agents.AI.AzureAI --prerelease\n// dotnet add package Azure.Identity\n// Use `az login` to authenticate with Azure CLI\nusing Azure.AI.Projects;\nusing Azure.Identity;\nusing Microsoft.Agents.AI;\n\nvar endpoint = Environment.GetEnvironmentVariable(\"AZURE_AI_PROJECT_ENDPOINT\") ?? throw new InvalidOperationException(\"AZURE_AI_PROJECT_ENDPOINT is not set.\");\nvar deploymentName = Environment.GetEnvironmentVariable(\"AZURE_AI_MODEL_DEPLOYMENT_NAME\") ?? \"gpt-4o-mini\";\n\nvar agent = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential())\n    .AsAIAgent(model: deploymentName, name: \"HaikuBot\", instructions: \"You are an upbeat assistant that writes beautifully.\");\n\nConsole.WriteLine(await agent.RunAsync(\"Write a haiku about Microsoft Agent Framework.\"));\n```\n\n## More Examples \u0026 Samples\n\n### Python\n\n- [Getting Started](./python/samples/01-get-started): progressive tutorial from hello-world to hosting\n- [Agent Concepts](./python/samples/02-agents): deep-dive samples by topic (tools, middleware, providers, etc.)\n- [Workflows](./python/samples/03-workflows): workflow creation and integration with agents\n- [Hosting](./python/samples/04-hosting): A2A, Azure Functions, Durable Task hosting\n- [End-to-End](./python/samples/05-end-to-end): full applications, evaluation, and demos\n\n### .NET\n\n- [Getting Started](./dotnet/samples/01-get-started): progressive tutorial from hello agent to hosting\n- [Agent Concepts](./dotnet/samples/02-agents/Agents): basic agent creation and tool usage\n- [Agent Providers](./dotnet/samples/02-agents/AgentProviders): samples showing different agent providers\n- [Workflows](./dotnet/samples/03-workflows): advanced multi-agent patterns and workflow orchestration\n- [Hosting](./dotnet/samples/04-hosting): A2A, Durable Agents, Durable Workflows\n- [End-to-End](./dotnet/samples/05-end-to-end): full applications and demos\n\n## Troubleshooting\n\n### Authentication\n\n| Problem | Cause | Fix |\n|---------|-------|-----|\n| Authentication errors when using Azure credentials | Not signed in to Azure CLI | Run `az login` before starting your app |\n| API key errors | Wrong or missing API key | Verify the key and ensure it's for the correct resource/provider |\n\n\u003e **Tip:** `DefaultAzureCredential` is convenient for development but in production, consider using a specific credential (e.g., `ManagedIdentityCredential`) to avoid latency issues, unintended credential probing, and potential security risks from fallback mechanisms.\n\n### Environment Variables\n\nThe samples typically read configuration from environment variables. Common required variables:\n\n| Variable | Used by | Purpose |\n|----------|---------|---------|\n| `AZURE_OPENAI_ENDPOINT` | Azure OpenAI samples | Your Azure OpenAI resource URL |\n| `AZURE_OPENAI_DEPLOYMENT_NAME` | Azure OpenAI samples | Model deployment name (e.g. `gpt-4o-mini`) |\n| `AZURE_AI_PROJECT_ENDPOINT` | Microsoft Foundry samples | Your Microsoft Foundry project endpoint |\n| `AZURE_AI_MODEL_DEPLOYMENT_NAME` | Microsoft Foundry samples | Model deployment name |\n| `OPENAI_API_KEY` | OpenAI (non-Azure) samples | Your OpenAI platform API key |\n\n## Contributor Resources\n\n- [Contributing Guide](./CONTRIBUTING.md)\n- [Python Development Guide](./python/DEV_SETUP.md)\n- [Design Documents](./docs/design)\n- [Architectural Decision Records](./docs/decisions)\n\n## Important Notes\n\nIf you use the Microsoft Agent Framework to build applications that operate with third-party servers or agents, you do so at your own risk. We recommend reviewing all data being shared with third-party servers or agents and being cognizant of third-party practices for retention and location of data. It is your responsibility to manage whether your data will flow outside of your organization's Azure compliance and geographic boundaries and any related implications.\n","funding_links":[],"categories":["AI Agent Frameworks","A01_文本生成_文本对话","Getting Started","Tools","LLM Frameworks","HarmonyOS","Python","Agent","C# #","Repos","📋 Contents","AI Agent Frameworks \u0026 SDKs","Frameworks \u0026 Libraries","Platforms \u0026 Frameworks","Agent Frameworks","Frameworks"],"sub_categories":["General Agent Frameworks","大语言对话模型及数据","Quick Start Resources","Agent Frameworks","Windows Manager","🤖 4. Agentic AI \u0026 Multi-Agent Systems","Multi-Agent Collaboration Systems","Multi-Agent Orchestration","Cloud-native Agent Platforms \u0026 Managed Stacks","Tools"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fagent-framework","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmicrosoft%2Fagent-framework","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmicrosoft%2Fagent-framework/lists"}