[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-microsoft--agent-framework":3,"tool-microsoft--agent-framework":64},[4,17,27,35,43,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":16},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,3,"2026-04-05T11:01:52",[13,14,15],"开发框架","图像","Agent","ready",{"id":18,"name":19,"github_repo":20,"description_zh":21,"stars":22,"difficulty_score":23,"last_commit_at":24,"category_tags":25,"status":16},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",138956,2,"2026-04-05T11:33:21",[13,15,26],"语言模型",{"id":28,"name":29,"github_repo":30,"description_zh":31,"stars":32,"difficulty_score":23,"last_commit_at":33,"category_tags":34,"status":16},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",107662,"2026-04-03T11:11:01",[13,14,15],{"id":36,"name":37,"github_repo":38,"description_zh":39,"stars":40,"difficulty_score":23,"last_commit_at":41,"category_tags":42,"status":16},3704,"NextChat","ChatGPTNextWeb\u002FNextChat","NextChat 是一款轻量且极速的 AI 助手，旨在为用户提供流畅、跨平台的大模型交互体验。它完美解决了用户在多设备间切换时难以保持对话连续性，以及面对众多 AI 模型不知如何统一管理的痛点。无论是日常办公、学习辅助还是创意激发，NextChat 都能让用户随时随地通过网页、iOS、Android、Windows、MacOS 或 Linux 端无缝接入智能服务。\n\n这款工具非常适合普通用户、学生、职场人士以及需要私有化部署的企业团队使用。对于开发者而言，它也提供了便捷的自托管方案，支持一键部署到 Vercel 或 Zeabur 等平台。\n\nNextChat 的核心亮点在于其广泛的模型兼容性，原生支持 Claude、DeepSeek、GPT-4 及 Gemini Pro 等主流大模型，让用户在一个界面即可自由切换不同 AI 能力。此外，它还率先支持 MCP（Model Context Protocol）协议，增强了上下文处理能力。针对企业用户，NextChat 提供专业版解决方案，具备品牌定制、细粒度权限控制、内部知识库整合及安全审计等功能，满足公司对数据隐私和个性化管理的高标准要求。",87618,"2026-04-05T07:20:52",[13,26],{"id":44,"name":45,"github_repo":46,"description_zh":47,"stars":48,"difficulty_score":23,"last_commit_at":49,"category_tags":50,"status":16},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,"2026-04-05T10:45:23",[14,51,52,53,15,54,26,13,55],"数据工具","视频","插件","其他","音频",{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":16},3128,"ragflow","infiniflow\u002Fragflow","RAGFlow 是一款领先的开源检索增强生成（RAG）引擎，旨在为大语言模型构建更精准、可靠的上下文层。它巧妙地将前沿的 RAG 技术与智能体（Agent）能力相结合，不仅支持从各类文档中高效提取知识，还能让模型基于这些知识进行逻辑推理和任务执行。\n\n在大模型应用中，幻觉问题和知识滞后是常见痛点。RAGFlow 通过深度解析复杂文档结构（如表格、图表及混合排版），显著提升了信息检索的准确度，从而有效减少模型“胡编乱造”的现象，确保回答既有据可依又具备时效性。其内置的智能体机制更进一步，使系统不仅能回答问题，还能自主规划步骤解决复杂问题。\n\n这款工具特别适合开发者、企业技术团队以及 AI 研究人员使用。无论是希望快速搭建私有知识库问答系统，还是致力于探索大模型在垂直领域落地的创新者，都能从中受益。RAGFlow 提供了可视化的工作流编排界面和灵活的 API 接口，既降低了非算法背景用户的上手门槛，也满足了专业开发者对系统深度定制的需求。作为基于 Apache 2.0 协议开源的项目，它正成为连接通用大模型与行业专有知识之间的重要桥梁。",77062,"2026-04-04T04:44:48",[15,14,13,26,54],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":80,"owner_twitter":81,"owner_website":82,"owner_url":83,"languages":84,"stars":118,"forks":119,"last_commit_at":120,"license":121,"difficulty_score":122,"env_os":123,"env_gpu":124,"env_ram":124,"env_deps":125,"category_tags":133,"github_topics":134,"view_count":23,"oss_zip_url":79,"oss_zip_packed_at":79,"status":16,"created_at":144,"updated_at":145,"faqs":146,"releases":175},2406,"microsoft\u002Fagent-framework","agent-framework","A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET.","Microsoft Agent Framework 是微软推出的开源框架，旨在帮助开发者轻松构建、编排和部署 AI 智能体及多智能体协作工作流。它同时支持 Python 和 .NET (C#) 两种主流技术栈，提供了一致且强大的 API 体验。\n\n面对从简单对话机器人到复杂自动化流程的开发需求，该框架解决了智能体之间协作难、状态管理复杂以及调试不便等痛点。它特别适合软件工程师、系统架构师及 AI 研究人员使用，无论是希望从 Semantic Kernel 或 AutoGen 迁移的老用户，还是想要探索前沿多智能体系统的新技术爱好者，都能从中获益。\n\n其核心技术亮点在于基于图的编排能力，允许开发者通过数据流将智能体与确定性函数灵活连接，并原生支持流式输出、检查点保存、人机协同干预甚至“时间旅行”（回溯执行状态）等高级功能。此外，框架内置了 OpenTelemetry 可观测性支持，方便进行分布式追踪与监控；配套的 DevUI 交互式界面则让开发、测试和调试过程更加直观高效。对于追求实验创新的用户，它还提供了包含基准测试和强化学习功能的 AF Labs 实验包。","![Microsoft Agent Framework](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmicrosoft_agent-framework_readme_1053dbb72774.png)\n\n# Welcome to Microsoft Agent Framework!\n\n[![Microsoft Foundry Discord](https:\u002F\u002Fdcbadge.limes.pink\u002Fapi\u002Fserver\u002Fb5zjErwbQM?style=flat)](https:\u002F\u002Fdiscord.gg\u002Fb5zjErwbQM)\n[![MS Learn Documentation](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMS%20Learn-Documentation-blue)](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002F)\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fagent-framework)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fagent-framework\u002F)\n[![NuGet](https:\u002F\u002Fimg.shields.io\u002Fnuget\u002Fv\u002FMicrosoft.Agents.AI)](https:\u002F\u002Fwww.nuget.org\u002Fprofiles\u002FMicrosoftAgentFramework\u002F)\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\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=AAgdMhftj8w\" title=\"Watch the full Agent Framework introduction (30 min)\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmicrosoft_agent-framework_readme_f808cd6dc132.jpg\"\n         alt=\"Watch the full Agent Framework introduction (30 min)\" width=\"480\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=AAgdMhftj8w\">\n    Watch the full Agent Framework introduction (30 min)\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## 📋 Getting Started\n\n### 📦 Installation\n\nPython\n\n```bash\npip install agent-framework --pre\n# This will install all sub-packages, see `python\u002Fpackages` 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:\u002F\u002Flearn.microsoft.com\u002Fagent-framework\u002Foverview\u002Fagent-framework-overview)** - High level overview of the framework\n- **[Quick Start](https:\u002F\u002Flearn.microsoft.com\u002Fagent-framework\u002Ftutorials\u002Fquick-start)** - Get started with a simple agent\n- **[Tutorials](https:\u002F\u002Flearn.microsoft.com\u002Fagent-framework\u002Ftutorials\u002Foverview)** - Step by step tutorials\n- **[User Guide](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fuser-guide\u002Foverview)** - In-depth user guide for building agents and workflows\n- **[Migration from Semantic Kernel](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fmigration-guide\u002Ffrom-semantic-kernel)** - Guide to migrate from Semantic Kernel\n- **[Migration from AutoGen](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fmigration-guide\u002Ffrom-autogen)** - Guide to migrate from AutoGen\n\nStill have questions? Join our [weekly office hours](.\u002FCOMMUNITY.md#public-community-office-hours) or ask questions in our [Discord channel](https:\u002F\u002Fdiscord.gg\u002Fb5zjErwbQM) 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](.\u002Fpython\u002Fsamples\u002F03-workflows\u002F) | [.NET workflows](.\u002Fdotnet\u002Fsamples\u002F03-workflows\u002F)\n- **AF Labs**: Experimental packages for cutting-edge features including benchmarking, reinforcement learning, and research initiatives\n  - [Labs directory](.\u002Fpython\u002Fpackages\u002Flab\u002F)\n- **DevUI**: Interactive developer UI for agent development, testing, and debugging workflows\n  - [DevUI package](.\u002Fpython\u002Fpackages\u002Fdevui\u002F)\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=mOAaGY4WPvc\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmicrosoft_agent-framework_readme_9c431d0220b7.jpg\" alt=\"See the DevUI in action\" width=\"480\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=mOAaGY4WPvc\">\n    See the DevUI in action (1 min)\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n- **Python and C#\u002F.NET Support**: Full framework support for both Python and C#\u002F.NET implementations with consistent APIs\n  - [Python packages](.\u002Fpython\u002Fpackages\u002F) | [.NET source](.\u002Fdotnet\u002Fsrc\u002F)\n- **Observability**: Built-in OpenTelemetry integration for distributed tracing, monitoring, and debugging\n  - [Python observability](.\u002Fpython\u002Fsamples\u002F02-agents\u002Fobservability\u002F) | [.NET telemetry](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgentOpenTelemetry\u002F)\n- **Multiple Agent Provider Support**: Support for various LLM providers with more being added continuously\n  - [Python examples](.\u002Fpython\u002Fsamples\u002F02-agents\u002Fproviders\u002F) | [.NET examples](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgentProviders\u002F)\n- **Middleware**: Flexible middleware system for request\u002Fresponse processing, exception handling, and custom pipelines\n  - [Python middleware](.\u002Fpython\u002Fsamples\u002F02-agents\u002Fmiddleware\u002F) | [.NET middleware](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgents\u002FAgent_Step11_Middleware\u002F)\n\n### 💬 **We want your feedback!**\n\n- For bugs, please file a [GitHub issue](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fissues).\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 --pre\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\u002F\u002F dotnet add package Microsoft.Agents.AI.OpenAI --prerelease\nusing Microsoft.Agents.AI;\nusing OpenAI;\nusing OpenAI.Responses;\n\n\u002F\u002F Replace the \u003Capikey> with your OpenAI API key.\nvar agent = new OpenAIClient(\"\u003Capikey>\")\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\u002F\u002F dotnet add package Microsoft.Agents.AI.AzureAI --prerelease\n\u002F\u002F dotnet add package Azure.Identity\n\u002F\u002F 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 & Samples\n\n### Python\n\n- [Getting Started](.\u002Fpython\u002Fsamples\u002F01-get-started): progressive tutorial from hello-world to hosting\n- [Agent Concepts](.\u002Fpython\u002Fsamples\u002F02-agents): deep-dive samples by topic (tools, middleware, providers, etc.)\n- [Workflows](.\u002Fpython\u002Fsamples\u002F03-workflows): workflow creation and integration with agents\n- [Hosting](.\u002Fpython\u002Fsamples\u002F04-hosting): A2A, Azure Functions, Durable Task hosting\n- [End-to-End](.\u002Fpython\u002Fsamples\u002F05-end-to-end): full applications, evaluation, and demos\n\n### .NET\n\n- [Getting Started](.\u002Fdotnet\u002Fsamples\u002F01-get-started): progressive tutorial from hello agent to hosting\n- [Agent Concepts](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgents): basic agent creation and tool usage\n- [Agent Providers](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgentProviders): samples showing different agent providers\n- [Workflows](.\u002Fdotnet\u002Fsamples\u002F03-workflows): advanced multi-agent patterns and workflow orchestration\n- [Hosting](.\u002Fdotnet\u002Fsamples\u002F04-hosting): A2A, Durable Agents, Durable Workflows\n- [End-to-End](.\u002Fdotnet\u002Fsamples\u002F05-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\u002Fprovider |\n\n> **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](.\u002FCONTRIBUTING.md)\n- [Python Development Guide](.\u002Fpython\u002FDEV_SETUP.md)\n- [Design Documents](.\u002Fdocs\u002Fdesign)\n- [Architectural Decision Records](.\u002Fdocs\u002Fdecisions)\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","![Microsoft Agent Framework](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmicrosoft_agent-framework_readme_1053dbb72774.png)\n\n# 欢迎来到 Microsoft Agent Framework！\n\n[![Microsoft Foundry Discord](https:\u002F\u002Fdcbadge.limes.pink\u002Fapi\u002Fserver\u002Fb5zjErwbQM?style=flat)](https:\u002F\u002Fdiscord.gg\u002Fb5zjErwbQM)\n[![MS Learn Documentation](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMS%20Learn-Documentation-blue)](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002F)\n[![PyPI](https:\u002F\u002Fimg.shields.io\u002Fpypi\u002Fv\u002Fagent-framework)](https:\u002F\u002Fpypi.org\u002Fproject\u002Fagent-framework\u002F)\n[![NuGet](https:\u002F\u002Fimg.shields.io\u002Fnuget\u002Fv\u002FMicrosoft.Agents.AI)](https:\u002F\u002Fwww.nuget.org\u002Fprofiles\u002FMicrosoftAgentFramework\u002F)\n\n欢迎来到微软的全面多语言框架，用于构建、编排和部署 AI 代理，同时支持 .NET 和 Python 实现。该框架提供从简单聊天代理到复杂多代理工作流的一切功能，并采用基于图的编排方式。\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=AAgdMhftj8w\" title=\"观看完整的 Agent Framework 介绍（30 分钟）\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmicrosoft_agent-framework_readme_f808cd6dc132.jpg\"\n         alt=\"观看完整的 Agent Framework 介绍（30 分钟）\" width=\"480\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=AAgdMhftj8w\">\n    观看完整的 Agent Framework 介绍（30 分钟）\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## 📋 入门指南\n\n### 📦 安装\n\nPython\n\n```bash\npip install agent-framework --pre\n# 这将安装所有子包，单个包请参阅 `python\u002Fpackages`。\n# 在 Windows 上首次安装时可能需要一分钟。\n```\n\n.NET\n\n```bash\ndotnet add package Microsoft.Agents.AI\n```\n\n### 📚 文档\n\n- **[概述](https:\u002F\u002Flearn.microsoft.com\u002Fagent-framework\u002Foverview\u002Fagent-framework-overview)** - 框架的高层次概述\n- **[快速入门](https:\u002F\u002Flearn.microsoft.com\u002Fagent-framework\u002Ftutorials\u002Fquick-start)** - 使用简单代理开始\n- **[教程](https:\u002F\u002Flearn.microsoft.com\u002Fagent-framework\u002Ftutorials\u002Foverview)** - 分步教程\n- **[用户指南](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fuser-guide\u002Foverview)** - 构建代理和工作流的深入用户指南\n- **[从 Semantic Kernel 迁移指南](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fmigration-guide\u002Ffrom-semantic-kernel)** - 从 Semantic Kernel 迁移的指南\n- **[从 AutoGen 运行时迁移指南](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fmigration-guide\u002Ffrom-autogen)** - 从 AutoGen 运行时迁移的指南\n\n仍有疑问？加入我们的 [每周办公时间](.\u002FCOMMUNITY.md#public-community-office-hours) 或在我们的 [Discord 频道](https:\u002F\u002Fdiscord.gg\u002Fb5zjErwbQM) 中提问，以获得团队和其他用户的帮助。\n\n### ✨ **亮点**\n\n- **基于图的工作流**：使用数据流连接代理和确定性函数，具备流式处理、检查点、人机协作和时间旅行等功能\n  - [Python 工作流](.\u002Fpython\u002Fsamples\u002F03-workflows\u002F) | [.NET 工作流](.\u002Fdotnet\u002Fsamples\u002F03-workflows\u002F)\n- **AF Labs**：用于前沿功能的实验性包，包括基准测试、强化学习和研究项目\n  - [Labs 目录](.\u002Fpython\u002Fpackages\u002Flab\u002F)\n- **DevUI**：用于代理开发、测试和调试工作流的交互式开发者界面\n  - [DevUI 包](.\u002Fpython\u002Fpackages\u002Fdevui\u002F)\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=mOAaGY4WPvc\">\n    \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmicrosoft_agent-framework_readme_9c431d0220b7.jpg\" alt=\"查看 DevUI 的实际效果\" width=\"480\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=mOAaGY4WPvc\">\n    查看 DevUI 的实际效果（1 分钟）\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n- **Python 和 C#\u002F .NET 支持**：完整框架同时支持 Python 和 C#\u002F .NET 实现，且 API 一致\n  - [Python 包](.\u002Fpython\u002Fpackages\u002F) | [.NET 源代码](.\u002Fdotnet\u002Fsrc\u002F)\n- **可观测性**：内置 OpenTelemetry 集成，用于分布式追踪、监控和调试\n  - [Python 可观测性](.\u002Fpython\u002Fsamples\u002F02-agents\u002Fobservability\u002F) | [.NET 链路追踪](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgentOpenTelemetry\u002F)\n- **多代理提供商支持**：支持多种 LLM 提供商，并将持续增加更多提供商\n  - [Python 示例](.\u002Fpython\u002Fsamples\u002F02-agents\u002Fproviders\u002F) | [.NET 示例](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgentProviders\u002F)\n- **中间件**：灵活的中间件系统，用于请求\u002F响应处理、异常处理和自定义管道\n  - [Python 中间件](.\u002Fpython\u002Fsamples\u002F02-agents\u002Fmiddleware\u002F) | [.NET 中间件](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgents\u002FAgent_Step11_Middleware\u002F)\n\n### 💬 **我们期待您的反馈！**\n\n- 如发现任何问题，请提交 [GitHub 问题](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fissues)。\n\n## 快速入门\n\n### 基础代理 - Python\n\n创建一个简单的 Azure Responses 代理，撰写一首关于 Microsoft Agent Framework 的俳句。\n\n```python\n# pip install agent-framework --pre\n# 使用 `az login` 通过 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    # 初始化一个使用 Microsoft Foundry 的聊天代理\n    # 终端节点、部署名称和 API 版本可以通过环境变量设置\n    # 或直接传递给 FoundryChatClient 构造函数\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=\"你是一位乐观开朗、文笔优美的助手。\",\n    )\n\n    print(await agent.run(\"写一首关于 Microsoft Agent Framework 的俳句。\"))\n\nif __name__ == \"__main__\":\n    asyncio.run(main())\n```\n\n### 基础代理 - .NET\n\n使用 OpenAI 响应创建一个简单的代理，该代理会撰写一首关于 Microsoft 代理框架的俳句。\n\n```c#\n\u002F\u002F dotnet add package Microsoft.Agents.AI.OpenAI --prerelease\nusing Microsoft.Agents.AI;\nusing OpenAI;\nusing OpenAI.Responses;\n\n\u002F\u002F 将 \u003Capikey> 替换为您的 OpenAI API 密钥。\nvar agent = new OpenAIClient(\"\u003Capikey>\")\n    .GetResponsesClient(\"gpt-4o-mini\")\n    .AsAIAgent(name: \"HaikuBot\", instructions: \"您是一位积极向上、文笔优美的助手。\");\n\nConsole.WriteLine(await agent.RunAsync(\"请写一首关于 Microsoft 代理框架的俳句。\"));\n```\n\n使用基于令牌的身份验证的 Microsoft Foundry 创建一个简单的代理，该代理会撰写一首关于 Microsoft 代理框架的俳句。\n\n```c#\n\u002F\u002F dotnet add package Microsoft.Agents.AI.AzureAI --prerelease\n\u002F\u002F dotnet add package Azure.Identity\n\u002F\u002F 使用 `az login` 通过 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 未设置。\");\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: \"您是一位积极向上、文笔优美的助手。\");\n\nConsole.WriteLine(await agent.RunAsync(\"请写一首关于 Microsoft 代理框架的俳句。\"));\n```\n\n## 更多示例与样本\n\n### Python\n\n- [入门](.\u002Fpython\u002Fsamples\u002F01-get-started)：从“Hello World”到托管的逐步教程\n- [代理概念](.\u002Fpython\u002Fsamples\u002F02-agents)：按主题深入探讨的示例（工具、中间件、提供商等）\n- [工作流](.\u002Fpython\u002Fsamples\u002F03-workflows)：工作流的创建及与代理的集成\n- [托管](.\u002Fpython\u002Fsamples\u002F04-hosting)：A2A、Azure Functions、Durable Task 托管\n- [端到端](.\u002Fpython\u002Fsamples\u002F05-end-to-end)：完整应用、评估和演示\n\n### .NET\n\n- [入门](.\u002Fdotnet\u002Fsamples\u002F01-get-started)：从简单代理到托管的逐步教程\n- [代理概念](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgents)：基础代理的创建及工具的使用\n- [代理提供商](.\u002Fdotnet\u002Fsamples\u002F02-agents\u002FAgentProviders)：展示不同代理提供商的示例\n- [工作流](.\u002Fdotnet\u002Fsamples\u002F03-workflows)：高级多代理模式及工作流编排\n- [托管](.\u002Fdotnet\u002Fsamples\u002F04-hosting)：A2A、Durable Agents、Durable Workflows\n- [端到端](.\u002Fdotnet\u002Fsamples\u002F05-end-to-end)：完整应用及演示\n\n## 故障排除\n\n### 身份验证\n\n| 问题 | 原因 | 解决方法 |\n|------|------|----------|\n| 使用 Azure 凭证时出现身份验证错误 | 未登录 Azure CLI | 在启动应用程序前运行 `az login` |\n| API 密钥错误 | API 密钥错误或缺失 | 验证密钥，并确保其适用于正确的资源\u002F提供商 |\n\n> **提示**：`DefaultAzureCredential` 在开发阶段很方便，但在生产环境中，建议使用特定的凭证（例如 `ManagedIdentityCredential`），以避免延迟问题、意外的凭证探测以及回退机制可能带来的安全风险。\n\n### 环境变量\n\n示例通常从环境变量中读取配置。常见的必需变量如下：\n\n| 变量 | 使用于 | 目的 |\n|------|--------|------|\n| `AZURE_OPENAI_ENDPOINT` | Azure OpenAI 示例 | 您的 Azure OpenAI 资源 URL |\n| `AZURE_OPENAI_DEPLOYMENT_NAME` | Azure OpenAI 示例 | 模型部署名称（例如 `gpt-4o-mini`） |\n| `AZURE_AI_PROJECT_ENDPOINT` | Microsoft Foundry 示例 | 您的 Microsoft Foundry 项目端点 |\n| `AZURE_AI_MODEL_DEPLOYMENT_NAME` | Microsoft Foundry 示例 | 模型部署名称 |\n| `OPENAI_API_KEY` | OpenAI（非 Azure）示例 | 您的 OpenAI 平台 API 密钥 |\n\n## 贡献者资源\n\n- [贡献指南](.\u002FCONTRIBUTING.md)\n- [Python 开发指南](.\u002Fpython\u002FDEV_SETUP.md)\n- [设计文档](.\u002Fdocs\u002Fdesign)\n- [架构决策记录](.\u002Fdocs\u002Fdecisions)\n\n## 重要说明\n\n如果您使用 Microsoft 代理框架构建与第三方服务器或代理交互的应用程序，则需自行承担相关风险。我们建议您仔细审查与第三方服务器或代理共享的所有数据，并了解其在数据保留和存储位置方面的做法。确保您的数据不会流出贵组织的 Azure 合规范围和地理边界，以及由此可能产生的任何影响，这完全由您负责。","# Microsoft Agent Framework 快速上手指南\n\nMicrosoft Agent Framework 是一个用于构建、编排和部署 AI 代理的多语言框架，支持 .NET 和 Python。它涵盖了从简单的聊天代理到基于图编排的复杂多代理工作流。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**: Windows, macOS 或 Linux\n*   **Python 用户**:\n    *   Python 3.10 或更高版本\n    *   `pip` 包管理工具\n    *   (可选) 若使用 Azure 服务，需安装 [Azure CLI](https:\u002F\u002Flearn.microsoft.com\u002Fzh-cn\u002Fcli\u002Fazure\u002Finstall-azure-cli) 并登录 (`az login`)\n*   **.NET 用户**:\n    *   .NET 8.0 SDK 或更高版本\n*   **账号与密钥**:\n    *   若使用 OpenAI：需要有效的 `OPENAI_API_KEY`\n    *   若使用 Azure OpenAI 或 Microsoft Foundry：需要相应的 Azure 订阅、资源端点及部署名称\n\n> **提示**：国内开发者若遇到 PyPI 下载缓慢问题，可使用清华或阿里镜像源加速安装。\n\n## 安装步骤\n\n根据您的开发语言选择对应的安装命令。\n\n### Python 安装\n\n使用 pip 安装预发布版本（当前为 pre-release）：\n\n```bash\npip install agent-framework --pre -i https:\u002F\u002Fpypi.tuna.tsinghua.edu.cn\u002Fsimple\n```\n\n> 注：首次安装可能需要一分钟时间，该命令会安装所有子包。\n\n### .NET 安装\n\n在您的项目目录中运行以下命令添加 NuGet 包：\n\n```bash\ndotnet add package Microsoft.Agents.AI\n```\n\n若需使用特定提供商（如 OpenAI 或 Azure AI），还需安装对应包：\n\n```bash\n# 用于 OpenAI\ndotnet add package Microsoft.Agents.AI.OpenAI --prerelease\n\n# 用于 Azure AI \u002F Microsoft Foundry\ndotnet add package Microsoft.Agents.AI.AzureAI --prerelease\ndotnet add package Azure.Identity\n```\n\n## 基本使用\n\n以下是创建简单 AI 代理的最小化示例，代理将输出一首关于 Microsoft Agent Framework 的俳句。\n\n### Python 示例 (使用 Microsoft Foundry\u002FAzure)\n\n此示例使用 Azure CLI 凭据进行身份验证。\n\n```python\n# pip install agent-framework --pre\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### .NET 示例\n\n#### 方案 A：使用 OpenAI\n\n```c#\n\u002F\u002F dotnet add package Microsoft.Agents.AI.OpenAI --prerelease\nusing Microsoft.Agents.AI;\nusing OpenAI;\nusing OpenAI.Responses;\n\n\u002F\u002F Replace the \u003Capikey> with your OpenAI API key.\nvar agent = new OpenAIClient(\"\u003Capikey>\")\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\n#### 方案 B：使用 Microsoft Foundry (Token 认证)\n\n```c#\n\u002F\u002F dotnet add package Microsoft.Agents.AI.AzureAI --prerelease\n\u002F\u002F dotnet add package Azure.Identity\n\u002F\u002F 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运行上述代码前，请确保已设置必要的环境变量（如 `AZURE_AI_PROJECT_ENDPOINT`）或替换代码中的 API Key。","某电商企业的技术团队正致力于构建一个能自动处理“用户退货申请、库存核对及退款审批”的复杂多智能体协作系统。\n\n### 没有 agent-framework 时\n- **流程编排混乱**：开发者需手动编写大量胶水代码来串联不同功能的 AI 模型，一旦某个环节出错，整个链路难以定位和恢复。\n- **调试黑盒化**：缺乏可视化的追踪手段，当智能体之间传递数据出现偏差时，只能依靠打印日志盲目猜测，排查效率极低。\n- **人机协作困难**：在需要人工介入审批的关键节点，难以优雅地暂停工作流并等待反馈，导致自动化流程经常中断或逻辑死锁。\n- **技术栈割裂**：团队内 Python 算法组与 .NET 业务组各自为战，无法复用同一套智能体逻辑，造成严重的重复开发和维护成本。\n\n### 使用 agent-framework 后\n- **图形化工作流编排**：利用基于图的编排能力，通过清晰的数据流将各个智能体与确定性函数连接，天然支持断点续传和时间旅行（Time-travel）调试。\n- **全景可观测性**：内置 OpenTelemetry 集成，让开发者在 DevUI 中实时看到每个智能体的思考路径、工具调用及数据流转，故障定位从小时级缩短至分钟级。\n- **灵活的人机回环**：原生支持“人在回路”（Human-in-the-loop）模式，工作流可在审批节点自动挂起，待人工确认后无缝继续，确保业务流程严谨可靠。\n- **跨语言统一架构**：Python 和 .NET 拥有完全一致的 API 设计，算法团队用 Python 训练的智能体可直接被 .NET 后端业务系统调用，实现了真正的技术栈融合。\n\nagent-framework 通过标准化的图编排与全链路可观测性，将原本碎片化的 AI 实验转化为稳定、可控且易于协作的企业级生产工作流。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmicrosoft_agent-framework_1053dbb7.png","microsoft","Microsoft","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fmicrosoft_4900709c.png","Open source projects and samples from Microsoft",null,"opensource@microsoft.com","OpenAtMicrosoft","https:\u002F\u002Fopensource.microsoft.com","https:\u002F\u002Fgithub.com\u002Fmicrosoft",[85,89,93,97,101,105,108,112,115],{"name":86,"color":87,"percentage":88},"Python","#3572A5",50.7,{"name":90,"color":91,"percentage":92},"C#","#178600",45.1,{"name":94,"color":95,"percentage":96},"TypeScript","#3178c6",3.7,{"name":98,"color":99,"percentage":100},"HTML","#e34c26",0.3,{"name":102,"color":103,"percentage":104},"CSS","#663399",0.1,{"name":106,"color":107,"percentage":104},"PowerShell","#012456",{"name":109,"color":110,"percentage":111},"Dockerfile","#384d54",0,{"name":113,"color":114,"percentage":111},"JavaScript","#f1e05a",{"name":116,"color":117,"percentage":111},"Shell","#89e051",8398,1401,"2026-04-02T22:17:33","MIT",1,"Windows, Linux, macOS","未说明",{"notes":126,"python":127,"dependencies":128},"该框架同时支持 Python 和 .NET (C#) 开发。Python 包安装时需添加 '--pre' 参数以安装预览版。使用 Azure 服务时，开发环境建议运行 'az login' 进行认证，生产环境建议使用特定的凭证类型（如 ManagedIdentityCredential）而非 DefaultAzureCredential。配置通常通过环境变量（如 AZURE_OPENAI_ENDPOINT, OPENAI_API_KEY 等）进行管理。","未说明 (需安装 Python 环境以运行 pip 命令)",[129,130,131,132],"agent-framework (PyPI)","Microsoft.Agents.AI (NuGet)","azure-identity","openai",[14,15,13],[67,135,136,137,138,139,140,141,142,143],"agentic-ai","agents","ai","multi-agent","orchestration","sdk","workflows","dotnet","python","2026-03-27T02:49:30.150509","2026-04-06T07:00:44.196265",[147,152,157,162,166,171],{"id":148,"question_zh":149,"answer_zh":150,"source_url":151},11079,".NET 中如何让工具同时返回文本和图像？","在当前的实现中，MCP 工具返回的结果通常会被序列化为巨大的 JSON 字符串，这容易导致触及 Token 限制。虽然 Semantic Kernel (SK) 中可以通过 `ChatMessageContent` 包含 `TextContent` 和 `ImageContent` 集合来实现，但在将结果传递给 Chat Completion 时，处理机制较为基础（仅序列化为 JSON 字符串）。\n\n目前的变通方案是：\n1. 如果使用的是 LiteLLM 代理，可能只能依赖 Chat Completion 和 `ChatMessage.RawRepresentation` 来实现目标。\n2. 开发者需注意，直接将包含 Base64 图像数据的对象序列化会导致 Token 溢出，未来框架可能会改进对 `AdditionalProperties` 或消息元数据的支持，以便更好地处理多模态内容。","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fissues\u002F1569",{"id":153,"question_zh":154,"answer_zh":155,"source_url":156},11080,"如何在 Python 中实现 A2A Agent 工具的 ContextId 自动传播以共享会话状态？","目前框架尚未完全自动将 Orchestrator 线程的 `ContextId` 传播到所有 A2A 工具调用中，但可以通过以下方式解决或变通：\n1. **利用元数据 (Metadata)**：框架会将消息的元数据填充到 `options` 中。底层的 `AIAgent` 可以访问这些数据。\n2. **自定义 AIAgent**：通过定义自定义的 `AIAgent` 类型，可以在调用内部 Agent 之前读取消息数据（包括 `ContextId`）。\n3. **使用 AdditionalProperties**：可以将整个 `MessageSendParams` 设置在 `AdditionalProperties` 上。虽然当前版本可能存在传递问题（参考 Issue #3179），但预期可以通过 `FunctionInvokingChatClient.CurrentContext.Options.AdditionalProperties` 在函数工具中访问复制的属性。\n4. **等待更新**：维护者正在改进相关功能，以便更顺畅地传递上下文信息。","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fissues\u002F2694",{"id":158,"question_zh":159,"answer_zh":160,"source_url":161},11081,".NET 中如何将需要依赖注入 (DI) 的整个类注册为 Agent 的工具集？","如果你有一个需要通过依赖注入初始化的工具类（例如 `RAGTool`），不想逐个方法注册，可以采用以下策略：\n1. **静态辅助方法**：推荐使用静态辅助方法（Static Helper Method），这样可以最大程度地保持现有类的兼容性，便于迁移。\n2. **手动转换与迁移指南**：参考官方迁移指南，将原本基于 Semantic Kernel 的代码转换为 Microsoft Agent Framework (MAF) 代码。通常涉及将实例化后的类方法通过 `AIFunctionFactory.Create` 逐个注册，或者编写适配器。\n3. **参考模板**：可以参考社区提供的 Aspire 模板（如 `aspire-sk-rag-template`），其中展示了如何将需要 DI 实例化的工具类转换为 MAF 格式，以及如何处理聊天完成 Agent 的基本转换。","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fissues\u002F726",{"id":163,"question_zh":164,"answer_zh":165,"source_url":151},11082,"为什么在 OpenAI 响应中找不到 reasoning status 属性或其值为 null？","如果在响应中找不到 `reasoning status` 或者其值为 `null`（例如响应显示 `\"status\":null`），这通常与使用的代理层有关。\n1. **原因**：当使用 LiteLLM 代理时，它可能仅支持标准的 Chat Completion 接口，而无法完整透传特定的 Reasoning 响应字段。\n2. **解决方案**：在这种配置下，开发者应主要依赖 `ChatMessage.RawRepresentation` 来尝试获取原始响应数据，或者接受在当前代理设置下无法直接获取该状态属性的限制。维护者指出，标准的 OpenAI 库代码中确实期望存在该属性，因此问题多出在代理层的转换或模型本身的返回内容上。",{"id":167,"question_zh":168,"answer_zh":169,"source_url":170},11083,"Python SDK 的命名约定与 .NET 有何不同，为什么要这样设计？","Python SDK 遵循符合 Python 语言习惯（Idiomatic）的命名约定，与 .NET 有显著区别：\n1. **简洁性**：Python 倾向于使用尽可能简单的类名以保持代码可读性和简洁性。\n2. **导入机制**：与 .NET 需要唯一命名空间不同，Python 允许通过 `from package import object as alias` 轻松地为对象设置别名，几乎没有消歧义的开销。\n3. **设计哲学**：因此，Agent Framework 的 Python 版本不会像 .NET 那样为了全局唯一性而使用冗长的类名，而是采用简短名称，依靠用户的导入别名来解决冲突。这符合 Python 社区的标准实践。","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fissues\u002F506",{"id":172,"question_zh":173,"answer_zh":174,"source_url":151},11084,"如何处理 MCP 工具返回的大尺寸图像数据以避免 Token 限制？","当 MCP 工具返回包含 Base64 编码图像的数据时，直接将其序列化为 JSON 字符串放入 Chat Completion 请求体中会导致 Token 数量迅速达到上限。\n**建议的处理方式**：\n1. **避免直接序列化**：不要简单地将 `CallToolResult` 序列化为 JSON 字符串发送。\n2. **结构化传输**：参考 GitHub Copilot API (CAPI) 或 OpenAI 的结构，将图像作为独立的附件（attachment）发送，而不是嵌入在巨大的文本字符串中。\n3. **框架限制**：目前框架对函数结果内容的处理较为基础（仅序列化），开发者可能需要自行构建符合多模态要求的请求结构，或等待框架后续更新以原生支持将图像内容从工具结果中提取并正确格式化。",[176,181,186,191,196,201,206,211,216,221,226,231,236,241,246,251,256,261,266,271],{"id":177,"version":178,"summary_zh":179,"released_at":180},61463,"dotnet-1.0.0","## 变更：\n\n* c798cb7a2ecd675c898db84931fb700060bceb77 发布：将交接编排标记为实验性功能 (#5065)\n* 524c0216e45a1b6e09b3e2816321c23a4ef57962 .NET：更新发布版本 (#5059)\n* 281661e4097868f75cef5219353b1ddb3106a081 .NET：从 OffThread 执行中的 InputWait 中移除超时设置 (#4996)\n* b0613a8cebdee0e67f81acb1553d9cc1f9318c2b .NET：将 Azure.AI.Projects 升级至 2.0.0 GA 版本 (#5060)\n* 79b38040e8193aa9abf06a7b2f31d69f551af0af 修复：将 Google.GenAI 更新至与 M.E.AI 10.4.0 及以上版本兼容的版本 (#5061)\n* a356a165681d0ecd3583250aeff2159820269ce8 .NET：移除 OpenAIAssistantClientExtensions 类 (#5058)\n\u003Cdetails>\u003Csummary>\u003Cb>查看更多\u003C\u002Fb>\u003C\u002Fsummary>\n\n* 628bb1af48ea264d17147f30190c1e745da309f7 .NET：将 Microsoft.Agents.AI.AzureAI重命名为 Microsoft.Agents.AI.Foundry，并整合 FoundryMemory (#5042)\n* 15e435b47237b2d5f246df1cae28701e2d3780fa 修复遥测示例中的错误 (#5037)\n* 38de9914815833f7e06644c516dfef53853b3785 .NET：修复从检查点恢复工作流时 RequestInfoEvent 丢失的问题 (#4955)\n* 25696a72dca5f1c07917076b5ad2d0520f89b3bb .NET：在 .NET 示例中将 Azure Foundry\u002FAzure AI Foundry 替换为 Microsoft Foundry (#5032)\n* 2cb78ea12e20ffcd102b00c0f42a23f53a32df21 修复并统一 devui 示例 (#5025)\n* acaadc9c45702325b0ffb71009f8a558b114a9c9 .NET：添加验证示例的工具和技能 (#5005)\n* 34329840e1db8bb67c5bc010fedca2426dddacae 添加 Neo4j GraphRAG 示例 (#4994)\n* 2a8c3e2dcf4b7c90df844c18c5b8190b63e48b82 修复 Azure AI 搜索初始化及示例相关问题 (#5021)\n* 9c9d81d8b6bc2189fbfc6241f0cad81ad04c0848 .NET：改进 README：架构概览、故障排除及示例链接 (#5002)\n* 47a8a305d216f17255279d0a51a488addbb2e676 修复 py DEV_SETUP 中的环境变量设置语句 (#5006)\n* 6e7254bba7abbee9b89b73df869074492f7d63df .NET：【破坏性变更】将 ServiceStoredSimulatingChatClient 重命名为 PerServiceCallChatHistoryPersistingChatClient (#4993)\n* 3d09337446c61fc97dbcf1c52dd7abf021c10669 将项目名称从“Semantic Kernel”更新为“Agent Framework” (#5001)\n* 3c727b5b71298a0971a97a22500dac65318bccf1 改进 CONTRIBUTING.md，添加开发环境配置链接和文档指导 (#5000)\n* 3f964c4cdb00766bfdaed24311d67611302399c5 从 dotnet 根目录中移除旧的代码生成文档 (#4997)\n\n此变更列表由 [自动生成](https:\u002F\u002Fmsdata.visualstudio.com\u002FVienna\u002F_build\u002Fresults?buildId=213431361&view=logs)。*\u003C\u002Fdetails>","2026-04-02T16:43:20",{"id":182,"version":183,"summary_zh":184,"released_at":185},61464,"python-1.0.0","## [1.0.0] - 2026-04-02\n\n>[!重要]\n> 如有任何破坏性变更及更新，请查看此[迁移指南](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fsupport\u002Fupgrade\u002Fpython-2026-significant-changes)。\n\n### 新增\n\n- **repo**: 添加 `PACKAGE_STATUS.md` 文件，用于跟踪所有 Python 包的生命周期状态 ([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))\n\n### 变更\n\n- **agent-framework**、**agent-framework-core**、**agent-framework-openai**、**agent-framework-foundry**: [破坏性变更] 从 `1.0.0rc6` 升级至 `1.0.0`（生产\u002F稳定版）([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))\n- **agent-framework-core**、**agent-framework-openai**、**agent-framework-foundry**: [破坏性变更] 依赖项的最低版本现要求已发布的 `>=1.0.0,\u003C2` 版本包，导致与旧 RC 版本安装不兼容([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))\n- **agent-framework-a2a**、**agent-framework-ag-ui**、**agent-framework-anthropic**、**agent-framework-azure-ai-search**、**agent-framework-azure-cosmos**、**agent-framework-azurefunctions**、**agent-framework-bedrock**、**agent-framework-chatkit**、**agent-framework-claude**、**agent-framework-copilotstudio**、**agent-framework-declarative**、**agent-framework-devui**、**agent-framework-durabletask**、**agent-framework-foundry-local**、**agent-framework-github-copilot**、**agent-framework-lab**、**agent-framework-mem0**、**agent-framework-ollama**、**agent-framework-orchestrations**、**agent-framework-purview**、**agent-framework-redis**: 将测试版版本号从 `1.0.0b260330` 提升至 `1.0.0b260402` ([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))\n- **docs**: 更新安装说明，移除针对已发布包的 `--pre` 标志([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))\n\n### 移除\n\n- **agent-framework-core**: [破坏性变更] 移除已弃用的 `BaseContextProvider` 和 `BaseHistoryProvider` 别名([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))\n- **agent-framework-core**: [破坏性变更] 从 `Message` 构造函数中移除已弃用的 `text` 参数([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))\n\n### 修复\n\n- **agent-framework-core**、**agent-framework-openai**、**agent-framework-foundry**、**agent-framework-azurefunctions**、**agent-framework-devui**、**agent-framework-orchestrations**、**agent-framework-azure-ai-search**: 在整个代码库中将消息构建方式从 `Message(text=...)` 迁移到 `Message(contents=[...])`([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))\n- **agent-framework-devui**: 接受旧版有效载荷格式（`text`、`message`、`content`、`input`、`data`），并将其转换为框架原生的 `Message(contents=...)` 格式([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))\n- **samples**: 修复 Foundry 示例，使其一致地使用环境变量，并更新安装指导([#5062](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F5062))","2026-04-02T16:16:18",{"id":187,"version":188,"summary_zh":189,"released_at":190},61465,"dotnet-1.0.0-rc5","## 变更内容\n* .NET：在禁用 Responses 存储输出时，默认包含 ReasoningEncryptedContent，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4623 中实现。\n* .NET：更新 A2A、MCP 和系统包依赖项，由 @SergeyMenshykh 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4647 中完成。\n* .NET：修复工作流执行期间发出 WorkflowStartedEvent 的问题，由 @peibekwe 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4514 中解决。\n* .NET：解决 Docker 构建中抑制实验性功能的问题，由 @rogerbarreto 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4641 中处理。\n* .NET：对持久代理示例的日志语句中的用户输入进行清理，由 @kshyju 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4656 中完成。\n* .NET：[持久代理] 从持久代理状态响应中过滤掉空的 AIContent，由 @cgillum 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4670 中实现。\n* .NET：修复不稳定的工作流测试，由 @Copilot 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4700 中完成。\n* .NET：添加持久工作流支持，由 @kshyju 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4436 中实现。\n* 将 actions\u002Fsetup-dotnet 从 5.1.0 升级到 5.2.0，由 @dependabot[bot] 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4541 中完成。\n* 将 danielpalme\u002FReportGenerator-GitHub-Action 从 5.5.1 升级到 5.5.3，由 @dependabot[bot] 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4542 中完成。\n* 将 MishaKav\u002Fpytest-coverage-comment 从 1.2.0 升级到 1.6.0，由 @dependabot[bot] 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4543 中完成。\n* 将 actions\u002Fupload-artifact 从 4 升级到 7，由 @dependabot[bot] 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4373 中完成。\n* .NET：使示例构建配置与 CI 中的测试运行器保持一致，由 @kshyju 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4735 中实现。\n* .NET：修复 FanInEdge 处理消息时的竞态条件问题，由 @peibekwe 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4662 中解决。\n* .NET Compaction：添加 `AsChatReducer()` 扩展方法，以将 `CompactionStrategy` 公开为 `IChatReducer`，由 @Copilot 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4664 中实现。\n* .NET Compaction：允许开发者为 `ToolResultCompactionStrategy` 指定自定义格式化程序，由 @Copilot 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4667 中实现。\n* .NET：验证 SkillsInstructionPrompt 是否包含 FileAgentSkillsProvider 中的 `{0}` 占位符，由 @moonbox3 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4642 中完成。\n* .NET：修复源代码生成器中的错误，该错误会静默地丢弃仅协议部分执行者的基类处理器注册，由 @peibekwe 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4751 中解决。\n* .NET：精简 src 引用并添加实用工具以强制执行，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4693 中完成。\n* 向开发容器添加 docker-in-docker 功能，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4794 中实现。\n* 添加自动化过期问题和 PR 跟进提醒工作流，由 @moonbox3 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4 中完成。","2026-04-01T19:13:13",{"id":192,"version":193,"summary_zh":194,"released_at":195},61466,"python-1.0.0rc6","## [1.0.0rc6] - 2026-03-30\r\n\r\n>[!重要]\r\n> 如有任何破坏性变更及更新，请查看此[迁移指南](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fsupport\u002Fupgrade\u002Fpython-2026-significant-changes)。\n\n### 新增\n\n- **agent-framework-openai**: 从核心中提取的新包，用于支持 OpenAI 和 Azure OpenAI 提供者（[#4818](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4818)）\n- **agent-framework-foundry**: 用于 Azure AI Foundry 集成的新包（[#4818](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4818)）\n- **agent-framework-core**: 在 MCP 工具结果中支持 `structuredContent`，并修复采样选项类型（[#4763](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4763)）\n- **agent-framework-core**: 将推理消息包含在 `MESSAGES_SNAPSHOT` 事件中（[#4844](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4844)）\n- **agent-framework-core**: [破坏性变更] 向 `AgentExecutor` 添加上下文模式（[#4668](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4668)）\n\n### 变更\n\n- **agent-framework-core**: [破坏性变更] 移除已弃用的 kwargs 兼容路径（[#4858](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4858)）\n- **agent-framework-core**: [破坏性变更] 减少核心依赖项，并简化可选集成（[#4904](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4904)）\n- **agent-framework-openai**: [破坏性变更] 采用以提供者为中心的客户端设计，并提取 OpenAI 包（[#4818](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4818)）\n- **agent-framework-openai**: [破坏性变更] 修复 OpenAI Azure 路由及提供者示例（[#4925](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4925)）\n- **agent-framework-azure-ai**: 弃用 Azure AI v1（Persistent Agents API）辅助方法（[#4804](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4804)）\n- **agent-framework-core**: 避免重复的代理响应遥测数据（[#4685](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4685)）\n- **agent-framework-devui**: 将前端中的 `flatted` 从 3.3.3 升级至 3.4.2（[#4805](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4805)）\n- **示例**: 将 `ag_ui_workflow_handoff` 演示从 `demos\u002F` 移至 `05-end-to-end\u002F`（[#4900](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4900)）\n\n### 修复\n\n- **agent-framework-core**: 修复流式传输路径，在 `output_item.done` 而不是 `output_item.added` 上发出 `mcp_server_tool_result` 事件（[#4821](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4821)）\n- **agent-framework-a2a**: 修复 `A2AAgent`，使其能够从正在进行的 `TaskStatusUpdateEvents` 中显示消息内容（[#4798](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4798)）\n- **agent-framework-core**: 修复在使用 `@tool` 并配合 `from __future__ import annotations` 时出现的 `PydanticSchemaGenerationError`（[#4822](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4822)）\n- **示例**: 修复 GitHub Copilot、声明式及 Responses API 的损坏示例（[#4915](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4915)）","2026-03-30T21:31:25",{"id":197,"version":198,"summary_zh":199,"released_at":200},61467,"python-1.0.0rc5","## [1.0.0rc5] - 2026-03-19\n\n>[!重要]\n> 如有任何破坏性变更及更新，请查看此[迁移指南](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fsupport\u002Fupgrade\u002Fpython-2026-significant-changes)。\n\n### 新增\n\n- **samples**: 添加适用于 Python 的 Foundry 托管代理示例 ([#4648](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4648))\n- **repo**: 添加自动化过期问题和 PR 跟进提醒工作流 ([#4776](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4776))\n- **agent-framework-ag-ui**: 为 MCP 工具调用、结果以及文本推理发出 AG-UI 事件 ([#4760](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4760))\n- **agent-framework-ag-ui**: 在工具批准后恢复执行时发出 TOOL_CALL_RESULT 事件 ([#4758](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4758))\n\n### 变更\n\n- **agent-framework-devui**: 将前端中的 minimatch 从 3.1.2 升级至 3.1.5 ([#4337](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4337))\n- **agent-framework-devui**: 将前端中的 rollup 从 4.47.1 升级至 4.59.0 ([#4338](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4338))\n- **agent-framework-core**: 统一工具结果为支持富内容的 `Content` 项 ([#4331](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4331))\n- **agent-framework-a2a**: 从 `AgentCard` 中默认获取 `A2AAgent` 的名称和描述 ([#4661](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4661))\n- **agent-framework-core**: 【破坏性变更】清理各代理、聊天客户端、工具和会话中的 kwargs 参数 ([#4581](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4581))\n- **agent-framework-devui**: 将 tar 从 7.5.9 升级至 7.5.11 ([#4688](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4688))\n- **repo**: 改进 Python 依赖范围的自动化处理 ([#4343](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4343))\n- **agent-framework-core**: 将空的 MCP 工具输出规范化为 `null` ([#4683](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4683))\n- **agent-framework-core**: 移除错误的依赖项 ([#4696](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4696))\n- **agent-framework-core**: 保持 MCP 清理操作在所有者任务中进行 ([#4687](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4687))\n- **agent-framework-a2a**: 保留 A2A 消息的 `context_id` ([#4686](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4686))\n- **repo**: 将 `danielpalme\u002FReportGenerator-GitHub-Action` 从 5.5.1 升级至 5.5.3 ([#4542](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4542))\n- **repo**: 将 `MishaKav\u002Fpytest-coverage-comment` 从 1.2.0 升级至 1.6.0 ([#4543](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4543))\n- **agent-framework-core**: 将 `pyjwt` 从 2.11.0 升级至 2.12.0 ([#4699](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4699))\n- **agent-framework-azure-ai**: 降低 Azure 聊天客户端的导入开销 ([#4744](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4744))\n- **repo**: 简化 Python Poe 任务并统一包选择器 ([#4722](https:\u002F","2026-03-20T01:36:50",{"id":202,"version":203,"summary_zh":204,"released_at":205},61468,"python-1.0.0rc4","## [1.0.0rc4] - 2026-03-11\n\n### 新增\n\n- **agent-framework-core**: 在 `as_tool()` 中添加 `propagate_session`，用于在代理即工具的场景中共享会话（[#4439](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4439)）\n- **agent-framework-core**: 将运行时关键字参数转发到技能资源函数（[#4417](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4417)）\n- **samples**: 添加 A2A 服务器示例（[#4528](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4528)）\n\n### 变更\n\n- **agent-framework-github-copilot**: [破坏性变更] 更新集成以使用 `ToolInvocation` 和 `ToolResult` 类型（[#4551](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4551)）\n- **agent-framework-azure-ai**: [破坏性变更] 升级至 `azure-ai-projects` 2.0+（[#4536](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4536)）\n\n### 修复\n\n- **agent-framework-core**: 将 MCP 的 `isError` 标志通过函数中间件管道传递（[#4511](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4511)）\n- **agent-framework-core**: 修复 `as_agent()` 未从客户端属性中默认设置名称和描述的问题（[#4484](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4484)）\n- **agent-framework-core**: 从聊天完成 API 选项中排除 `conversation_id`（[#4517](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4517)）\n- **agent-framework-core**: 修复当 `chat_options` 为字典时对话 ID 的传播问题（[#4340](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4340)）\n- **agent-framework-core**: 在迭代完成后自动结束 `ResponseStream`（[#4478](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4478)）\n- **agent-framework-core**: 防止对不受信任的 HITL HTTP 输入进行 pickle 反序列化（[#4566](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4566)）\n- **agent-framework-core**: 修复混合工作流中不可复制的 `raw_representation` 的 `executor_completed` 事件处理问题（[#4493](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4493)）\n- **agent-framework-core**: 修复 `store=False` 无法覆盖客户端默认值的问题（[#4569](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4569)）\n- **agent-framework-redis**: 通过使用 `AggregateHybridQuery`，修复 `RedisContextProvider` 与 redisvl 0.14.0 的兼容性问题（[#3954](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3954)）\n- **samples**: 修复 `chat_response_cancellation` 示例，使其使用 `Message` 对象（[#4532](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4532)）\n- **agent-framework-purview**: 修复 Purview README 中的失效链接（Microsoft 365 开发者计划 URL）（[#4610](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4610)）","2026-03-11T22:59:59",{"id":207,"version":208,"summary_zh":209,"released_at":210},61469,"dotnet-1.0.0-rc4","## 变更内容\n* .NET：修复 GitHub Copilot Agent 中重复输出的 bug，由 @normalian 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3981 中完成。\n* .NET：为集成测试增加凭据超时时间，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4472 中完成。\n* .NET：为 .NET 添加 Foundry 扩展示例，由 @yaoleo34 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4359 中完成。\n* .NET：CI 构建端到端时间优化，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4208 中完成。\n* .NET：将身份验证示例切换为使用单例模式，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4454 中完成。\n* .NET：为托管 DI 注册添加 ServiceLifetime 支持，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4476 中完成。\n* .NET：修复 ChatHistoryMemoryProvider 的筛选器组合逻辑，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4501 中完成。\n* .NET：更新 HostedAgents 示例，升级至 Azure.AI.AgentServer.AgentFramework 1.0.0-beta.9 和 MEAI 10.3.0，由 @Copilot 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4477 中完成。\n* .NET：改进技能名称验证：拒绝连续连字符，并强制要求与目录名匹配，由 @SergeyMenshykh 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4526 中完成。\n* .NET：创建一个示例，展示带有溢出到聊天历史记忆中的受限聊天历史功能，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4136 中完成。\n* .NET：将 Anthropic 更新至 12.8.0，Anthropic.Foundry 更新至 0.4.2，由 @Copilot 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4475 中完成。\n* .NET：为核心组件的 XML 注释添加安全警告，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4527 中完成。\n* 自动在迭代完成后最终化 ResponseStream，由 @giles17 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4478 中完成。\n* .NET：跳过 Azure Persistent (V1) 中不稳定 CodeInterpreter 集成测试，由 @rogerbarreto 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4583 中完成。\n* .NET：启用 Microsoft.Agents.AI.FoundryMemory 的 NuGet 发布，由 @rogerbarreto 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4559 中完成。\n* 修复 ADR 中 Strands Agents 文档链接，由 @Copilot 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4584 中完成。\n* .NET：清理不必要的 AsIChatClient 使用，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4561 中完成。\n* .NET：为工作流输出添加多态类型支持，由 @peibekwe 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4485 中完成。\n* .NET 紧缩——引入紧缩策略和管道，由 @crickman 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4533 中完成。\n* .NET：SDK 补丁版本提升（10.0.200）——解决托管项目中 IL2026\u002FIL3050 诊断误报问题，由 @rogerbarreto 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4586 中完成。\n* .NET：为 AgentResponses 添加 FinishReason，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4617 中完成。\n* .NET：更新包版本，由 @dmytrostruk 在 https:","2026-03-11T22:58:44",{"id":212,"version":213,"summary_zh":214,"released_at":215},61470,"python-1.0.0rc3","## [1.0.0rc3] - 2026-03-04\n\n### 新增功能\n\n- **agent-framework-core**: 添加 Shell 工具 ([#4339](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4339))\n- **agent-framework-core**: 为 `get_code_interpreter_tool()` 添加 `file_ids` 和 `data_sources` 支持 ([#4201](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4201))\n- **agent-framework-core**: 将 Assistants API 流式传输中的 `TextDeltaBlock` 中的文件引用注释进行映射 ([#4316](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4316), [#4320](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4320))\n- **agent-framework-claude**: 为 `ClaudeAgent` 添加 OpenTelemetry 指标监控 ([#4278](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4278), [#4326](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4326))\n- **agent-framework-azure-cosmos**: 添加 Azure Cosmos 历史记录提供者包 ([#4271](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4271))\n- **samples**: 添加用于处理速率限制的 `auto_retry.py` 示例 ([#4223](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4223))\n- **tests**: 为 Entry JoinExecutor 工作流输入初始化添加回归测试 ([#4335](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4335))\n\n### 变更\n\n- **samples**: 重构并改进 Python 示例 ([#4092](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4092))\n- **agent-framework-orchestrations**: 【破坏性变更】收紧 `HandoffBuilder`，要求传入 `Agent` 而非 `SupportsAgentRun` 类型 ([#4301](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4301), [#4302](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4302))\n- **samples**: 更新工作流编排示例，使其使用 `AzureOpenAIResponsesClient` ([#4285](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4285))\n\n### 修复\n\n- **agent-framework-bedrock**: 修复嵌入测试桩中缺少 `meta` 属性的问题 ([#4287](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4287))\n- **agent-framework-ag-ui**: 修复在后续对话轮次中审批负载被重复处理的问题 ([#4232](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4232))\n- **agent-framework-core**: 修复流式传输最终处理器中 `response_format` 的解析问题 ([#4291](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4291))\n- **agent-framework-core**: 在 `AgentExecutor` 中剔除保留关键字参数，以防止出现重复参数引发的 `TypeError` 错误 ([#4298](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4298))\n- **agent-framework-core**: 在使用 `run(responses=...)` 继续执行时，保留工作流运行的关键字参数 ([#4296](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4296))\n- **agent-framework-core**: 修复 `WorkflowAgent` 未将响应消息持久化到会话历史记录的问题 ([#4319](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4319))\n- **agent-framework-core**: 修复 `OpenAIResponsesClient._prepare_tools_for_openai` 中单工具输入的处理问题 ([#4312](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4312))\n- **agent-framework-core**: 修复代理选项合并逻辑，使其支持字典定义。","2026-03-04T22:01:55",{"id":217,"version":218,"summary_zh":219,"released_at":220},61471,"dotnet-1.0.0-rc3","## 变更内容\n* .NET：支持托管代码解释器用于技能脚本执行，由 @SergeyMenshykh 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4192 中实现。\n* .NET：AgentThread 序列化替代方案 ADR，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3062 中提出。\n* .NET：添加辅助方法，以便更轻松地访问内存中的 ChatHistory，并使 ChatHistoryProvider 的管理更具可配置性。由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4224 中实现。\n* .NET：添加额外的托管代理示例，由 @rogerbarreto 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4325 中完成。\n* .NET：撤销“.NET：支持托管代码解释器用于技能脚本执行”，由 @SergeyMenshykh 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4385 中实施。\n* .NET：修复在可视化 .NET 工作流时节点 ID 无效的问题。由 @alliscode 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4269 中解决。\n* .NET：修复 FileAgentSkillsProvider 自定义 SkillsInstructionPrompt 会静默丢弃技能的问题，由 @SergeyMenshykh 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4388 中修复。\n* .NET：包含 ASP.NET 服务和 Web 客户端的 AuthN & AuthZ 示例，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4354 中实现。\n* .NET：更新 GroupChat 工作流构建器，以支持名称和描述，由 @peibekwe 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4334 中完成。\n* .NET：跳过 OffThread 可观测性测试，由 @rogerbarreto 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4399 中实施。\n* .NET：AzureAI 包——当 UseProvidedChatClientAsIs 为真时，跳过工具验证，由 @rogerbarreto 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4389 中实现。\n* [重大变更] 为 *Providers 添加存储输入的响应过滤器，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4327 中引入。\n* .NET：[重大变更] 将 *Provider StateKey 更改为 StateKeys 列表，由 @westey-m 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4395 中完成。\n* .NET：将 Copilot SDK 更新至最新版本，由 @dmytrostruk 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4406 中完成。\n* .NET：禁用 OpenAIAssistant 结构化输出集成测试，由 @SergeyMenshykh 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4451 中实施。\n* .NET：更新 Azure.AI.Projects 至 2.0.0-beta.1，由 @rogerbarreto 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4270 中完成。\n* .NET：跳过不稳定单元测试 + （尝试）合并 Gatekeeper 修复，由 @rogerbarreto 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4456 中实施。\n* .NET：从目录而非 Markdown 链接中发现技能资源，由 @SergeyMenshykh 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4401 中实现。\n* .NET：更新包版本，由 @dmytrostruk 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4468 中完成。\n* .NET：修复 CA1873 警告，由 @dmytrostruk 在 https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4479 中解决。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fcompare\u002Fdotnet-1.0.0-rc2...dotnet-1.0.0-rc3","2026-03-04T22:00:19",{"id":222,"version":223,"summary_zh":224,"released_at":225},61472,"python-1.0.0rc2","## [1.0.0rc2] - 2026-02-25\n\n### 新增功能\n\n- **agent-framework-core**: 支持智能体技能 ([#4210](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4210))\n- **agent-framework-core**: 添加嵌入抽象层及 OpenAI 实现（第一阶段）([#4153](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4153))\n- **agent-framework-core**: 添加 Foundry 记忆上下文提供者 ([#3943](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3943))\n- **agent-framework-core**: 在 `FunctionInvocationConfiguration` 中添加 `max_function_calls` 参数 ([#4175](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4175))\n- **agent-framework-core**: 添加 `CreateConversationExecutor`，修复输入路由问题，并移除未使用的处理器层 ([#4159](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4159))\n- **agent-framework-azure-ai-search**: Azure AI 搜索提供者的改进——嵌入生成器、异步上下文管理器以及知识库消息处理 ([#4212](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4212))\n- **agent-framework-azure-ai-search**: 在 Foundry V2 中增强 Azure AI 搜索引用，添加文档 URL ([#4028](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4028))\n- **agent-framework-ag-ui**: 添加工作流支持，强化流式传输语义，并新增动态交接演示 ([#3911](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3911))\n\n### 变更\n\n- **agent-framework-declarative**: 【破坏性变更】为声明式工作流添加 `InvokeFunctionTool` 动作 ([#3716](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3716))\n\n### 修复\n\n- **agent-framework-core**: 修复达到 `max_iterations` 时出现的线程损坏问题 ([#4234](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4234))\n- **agent-framework-core**: 修复工作流运行器的并发处理问题 ([#4143](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4143))\n- **agent-framework-core**: 修复流式传输时 `MESSAGES_SNAPSHOT` 中 `tool_call` 参数重复的问题 ([#4200](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4200))\n- **agent-framework-core**: 修复 OpenAI 聊天客户端与第三方端点及 OTel 0.4.14 的兼容性问题 ([#4161](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4161))\n- **agent-framework-claude**: 修复 `ClaudeAgent` 中 `structured_output` 的传播问题 ([#4137](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4137))","2026-02-26T01:19:16",{"id":227,"version":228,"summary_zh":229,"released_at":230},61473,"dotnet-1.0.0-rc2","## What's Changed\r\n* .NET: Add Foundry Memory Context Provider by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3522\r\n* .NET: Replace inline string literals with constants in ChatHistoryMemoryProvider by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4096\r\n* .NET: Fix failing vision integration tests by using local test files by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4128\r\n* .NET: Support Agent Skills by @SergeyMenshykh in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4122\r\n* Added new GitHub action for manual integration test run based on PR by @dmytrostruk in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4135\r\n* .NET: Simplify store=false scenario for responses by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4124\r\n* .NET: Add Foundry Agents Tool Sample - Memory Search by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3700\r\n* .NET: [BREAKING] Add ChatClient decorator for calling AIContextProviders by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4097\r\n* Updated GitHub action for manual integration tests by @dmytrostruk in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4147\r\n* .NET: Fix Structured Output for agents configured with function middleware by @SergeyMenshykh in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4179\r\n* Make Cosmos DB tests read COSMOSDB_ENDPOINT and COSMOSDB_KEY from environment variables by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4156\r\n* .NET: Add Foundry Agents Tool Sample - Web Search by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4040\r\n* .NET: Fix case-sensitive property mismatch in CosmosChatHistoryProvider queries by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3485\r\n* Revert devcontainer bug workaround by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4206\r\n* .NET:  Add Foundry Agents Tool Sample - Bing Custom Search by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3701\r\n* .NET: Fix JSON arrays of objects parsed as empty records when no schema is defined by @LEDazzio01 in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4199\r\n* .NET: Implement Task support for A2A Hosting package by @DeagleGross in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3732\r\n* Add Additional Properties ADR by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4246\r\n* .NET: Add Foundry SharePoint Tool Sample by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4227\r\n* .NET: Update .NET package version to rc2 by @dmytrostruk in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4257\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fcompare\u002Fdotnet-1.0.0-rc1...dotnet-1.0.0-rc2","2026-02-25T23:08:18",{"id":232,"version":233,"summary_zh":234,"released_at":235},61474,"dotnet-1.0.0-rc1","## What's Changed\r\n* .NET Workflows - Rename agent-provider and add comments (Declarative Workflows) by @crickman in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3895\r\n* .NET: [BREAKING] Add session StateBag for state storage and support multiple providers on the Agent by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3806\r\n* .NET: [Breaking] Structured Output improvements by @SergeyMenshykh in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3761\r\n* .NET: Add CreateSessionAsync overload with taskId for A2AAgent session resumption by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3924\r\n* .NET: Add skill to verify samples by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3931\r\n* .NET: Fixes for bug bash. by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3927\r\n* .NET: [BREAKING] Refactor providers to move common functionality to base by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3900\r\n* .NET: Surface downstream experimental flags and remove unnecessary suppressions by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3968\r\n* .NET: [BREAKING] Replace Typed Base Providers with Composition by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3988\r\n* .NET: Fix sample resource path resolution by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3952\r\n* .NET: Fixing some small issues from bugbash by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3961\r\n* .NET: Improve session cast error message quality and consistency by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3973\r\n* .NET Workflows - Add unit tests for RequestExternalInputExecutor by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3891\r\n* .NET Workflows - Add unit tests for ConditionGroupExecutor by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3893\r\n* .NET: Open an active item in Solution Explorer in VS Code automatically by @SergeyMenshykh in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3992\r\n* .NET Workflows - Add unit tests for QuestionExecutor by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3892\r\n* .NET: Add additional build, test and project structure skills by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3987\r\n* .NET: Update Microsoft.Agents.ObjectModel packages to 2026.2.2.1 by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4003\r\n* .NET: Disable intermittently failing AzureAIAgentsPersistent integration tests by @SergeyMenshykh in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3997\r\n* .NET: Inline private RunCoreAsync into the protected one by @SergeyMenshykh in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3928\r\n* .NET: Add Foundry Evaluation samples (Safety + Quality) by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3697\r\n* .NET: Fix MCP samples: update MCP SDK to 0.8.0-preview.1 and fix README references by @SergeyMenshykh in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3959\r\n* .NET: BREAKING: Unify `AgentResponse[Update]` events as `WorkflowOutputEvent`s by @lokitoth in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3441\r\n* .NET: Support InvokeFunctionTool for declarative workflows by @peibekwe in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4014\r\n* .NET: Fix FoundryAgents_Step15_ComputerUse sample for Azure Agents API by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3989\r\n* .NET: Add File Search Sample for Foundry Agents. by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3990\r\n* .NET: Fixes AgentWithHostedMCP chat fails: ErrorHTTP 404 (: 404) Resource not found by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3856\r\n* .NET: [BREAKING] Implement Polymorphic Routing by @lokitoth in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3792\r\n* .NET: Fix CheckpointInfo.Parent always null in InProcessRunner by @lokitoth in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3812\r\n* .NET: Update AdditionalAIContext sample with simplified implementation by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4039\r\n* .NET:  Add Foundry Agents Tool Sample - OpenAPI Tools by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3702\r\n* [BREAKING] .NET: Decouple Checkpointing from Run\u002FStreamAsync APIs by @lokitoth in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4037\r\n* .NET: Updated package versions for RC release by @dmytrostruk in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4067\r\n* .NET: Add tweaks to .net agent skills by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4081\r\n* .NET: Support a message only AIContextProvider as an AIAgent Decorator by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4009\r\n* .NET: Remove FunctionCalls and Tool Messages from Handoff passed messages by @lokitoth in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3811\r\n* .NET: Small ","2026-02-20T03:03:28",{"id":237,"version":238,"summary_zh":239,"released_at":240},61475,"python-1.0.0rc1","## [1.0.0rc1] - 2026-02-19\r\n\r\nRelease candidate for **agent-framework-core** and **agent-framework-azure-ai** packages.\r\n\r\n### Added\r\n\r\n- **agent-framework-core**: Add default in-memory history provider for workflow agents ([#3918](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3918))\r\n- **agent-framework-core**: Durable support for workflows ([#3630](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3630))\r\n\r\n### Changed\r\n\r\n- **agent-framework-core**: [BREAKING] Scope provider state by `source_id` and standardize source IDs ([#3995](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3995))\r\n- **agent-framework-core**: [BREAKING] Fix chat\u002Fagent message typing alignment ([#3920](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3920))\r\n- **agent-framework-core**: [BREAKING] Remove `FunctionTool[Any]` compatibility shim for schema passthrough ([#3907](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3907))\r\n- **agent-framework-core**: Inject OpenTelemetry trace context into MCP requests ([#3780](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3780))\r\n- **agent-framework-core**: Replace wildcard imports with explicit imports ([#3908](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3908))\r\n\r\n### Fixed\r\n\r\n- **agent-framework-core**: Fix hosted MCP tool approval flow for all session\u002Fstreaming combinations ([#4054](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4054))\r\n- **agent-framework-core**: Prevent repeating instructions in continued Responses API conversations ([#3909](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3909))\r\n- **agent-framework-core**: Add missing system instruction attribute to `invoke_agent` span ([#4012](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4012))\r\n- **agent-framework-core**: Fix tool normalization and provider sample consolidation ([#3953](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3953))\r\n- **agent-framework-azure-ai**: Warn on unsupported AzureAIClient runtime tool\u002Fstructured_output overrides ([#3919](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3919))\r\n- **agent-framework-azure-ai-search**: Improve Azure AI Search package test coverage ([#4019](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4019))\r\n- **agent-framework-anthropic**: Fix Anthropic option conflicts and manager parse retries ([#4000](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4000))\r\n- **agent-framework-anthropic**: Track and enforce 85%+ unit test coverage for anthropic package ([#3926](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3926))\r\n- **agent-framework-azurefunctions**: Achieve 85%+ unit test coverage for azurefunctions package ([#3866](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3866))\r\n- **samples**: Fix workflow, declarative, Redis, Anthropic, GitHub Copilot, Azure AI, MCP, eval, and migration samples ([#4055](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4055), [#4051](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4051), [#4049](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4049), [#4046](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4046), [#4033](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4033), [#4030](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4030), [#4027](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4027), [#4032](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4032), [#4025](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4025), [#4021](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4021), [#4022](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4022), [#4001](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F4001))","2026-02-20T02:53:54",{"id":242,"version":243,"summary_zh":244,"released_at":245},61476,"python-1.0.0b260212","# [1.0.0b260212] - 2026-02-12\r\n\r\n> [!IMPORTANT]\r\n> To see details about related breaking changes, please visit the [Python 2026 Significant Changes Guide](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fsupport\u002Fupgrade\u002Fpython-2026-significant-changes).\r\n\r\n### Added\r\n\r\n- **agent-framework-core**: Allow `AzureOpenAIResponsesClient` creation with Foundry project endpoint ([#3814](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3814))\r\n\r\n### Changed\r\n\r\n- **agent-framework-core**: [BREAKING] Wire context provider pipeline, remove old types, update all consumers ([#3850](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3850))\r\n- **agent-framework-core**: [BREAKING] Checkpoint refactor: encode\u002Fdecode, checkpoint format, etc ([#3744](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3744))\r\n- **agent-framework-core**: [BREAKING] Replace `Hosted*Tool` classes with tool methods ([#3634](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3634))\r\n- **agent-framework-core**: Replace Pydantic Settings with `TypedDict` + `load_settings()` ([#3843](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3843))\r\n- **agent-framework-core**: Centralize tool result parsing in `FunctionTool.invoke()` ([#3854](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3854))\r\n- **samples**: Restructure Python samples into progressive 01-05 layout ([#3862](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3862))\r\n- **samples**: Adopt `AzureOpenAIResponsesClient`, reorganize orchestration examples, and fix workflow\u002Forchestration bugs ([#3873](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3873))\r\n\r\n### Fixed\r\n\r\n- **agent-framework-core**: Fix non-ascii chars in span attributes ([#3894](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3894))\r\n- **agent-framework-core**: Fix streamed workflow agent continuation context by finalizing `AgentExecutor` streams ([#3882](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3882))\r\n- **agent-framework-ag-ui**: Fix `Workflow.as_agent()` streaming regression ([#3875](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3875))\r\n- **agent-framework-declarative**: Fix declarative package powerfx import crash and `response_format` kwarg error ([#3841](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3841))","2026-02-13T00:13:10",{"id":247,"version":248,"summary_zh":249,"released_at":250},61477,"python-1.0.0b260210","# [1.0.0b260210] - 2026-02-10\r\n\r\n> [!IMPORTANT]\r\n> To see details about related breaking changes, please visit the [Python 2026 Significant Changes Guide](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fagent-framework\u002Fsupport\u002Fupgrade\u002Fpython-2026-significant-changes).\r\n\r\n### Added\r\n\r\n- **agent-framework-core**: Add long-running agents and background responses support with `ContinuationToken` TypedDict, `background` option in `OpenAIResponsesOptions`, and continuation token propagation through response types ([#3808](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3808))\r\n- **agent-framework-core**: Add streaming support for code interpreter deltas ([#3775](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3775))\r\n- **agent-framework-core**: Add explicit input, output, and workflow_output parameters to `@handler`, `@executor` and `request_info` ([#3472](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3472))\r\n- **agent-framework-core**: Add explicit schema handling to `@tool` decorator ([#3734](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3734))\r\n- **agent-framework-core**: New session and context provider types ([#3763](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3763))\r\n- **agent-framework-purview**: Add tests to Purview package ([#3513](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3513))\r\n\r\n### Changed\r\n\r\n- **agent-framework-core**: [BREAKING] Renamed core types for simpler API: `ChatAgent` → `Agent`, `RawChatAgent` → `RawAgent`, `ChatMessage` → `Message`, `ChatClientProtocol` → `SupportsChatGetResponse` ([#3747](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3747))\r\n- **agent-framework-core**: [BREAKING] Moved to a single `get_response` and `run` API ([#3379](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3379))\r\n- **agent-framework-core**: [BREAKING] Merge `send_responses` into `run` method ([#3720](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3720))\r\n- **agent-framework-core**: [BREAKING] Renamed `AgentRunContext` to `AgentContext` ([#3714](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3714))\r\n- **agent-framework-core**: [BREAKING] Renamed `AgentProtocol` to `SupportsAgentRun` ([#3717](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3717))\r\n- **agent-framework-core**: [BREAKING] Renamed next middleware parameter to `call_next` ([#3735](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3735))\r\n- **agent-framework-core**: [BREAKING] Standardize TypeVar naming convention (`TName` → `NameT`) ([#3770](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3770))\r\n- **agent-framework-core**: [BREAKING] Refactor workflow events to unified discriminated union pattern ([#3690](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3690))\r\n- **agent-framework-core**: [BREAKING] Refactor `SharedState` to `State` with sync methods and superstep caching ([#3667](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3667))\r\n- **agent-framework-core**: [BREAKING] Move single-config fluent methods to constructor parameters ([#3693](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3693))\r\n- **agent-framework-core**: [BREAKING] Types API Review improvements ([#3647](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3647))\r\n- **agent-framework-core**: [BREAKING] Fix workflow as agent streaming output ([#3649](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3649))\r\n- **agent-framework-orchestrations**: [BREAKING] Move orchestrations to dedicated package ([#3685](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3685))\r\n- **agent-framework-core**: [BREAKING] Remove workflow register factory methods; update tests and samples ([#3781](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3781))\r\n- **agent-framework-core**: Include sub-workflow structure in graph signature for checkpoint validation ([#3783](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3783))\r\n- **agent-framework-core**: Adjust workflows TypeVars from prefix to suffix naming convention ([#3661](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3661))\r\n- **agent-framework-purview**: Update CorrelationId ([#3745](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3745))\r\n- **agent-framework-anthropic**: Added internal kwargs filtering for Anthropic client ([#3544](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3544))\r\n- **agent-framework-github-copilot**: Updated instructions\u002Fsystem_message logic in GitHub Copilot agent ([#3625](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3625))\r\n- **agent-framework-mem0**: Disable mem0 telemetry by default ([#3506](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3506))\r\n\r\n### Fixed\r\n\r\n- **agent-framework-core**: Fix workflow not pausing when agent calls declaration-only tool ([#3757](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3757))\r\n- **agent-framework-core**: Fix GroupChat orchestrator message cleanup issue ([#3712](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3712))\r\n- **agent-framework-core**: Fix HandoffBuilder silently dropping `context_provider` during agent cloning ([#3721](https:\u002F\u002Fgith","2026-02-11T00:35:34",{"id":252,"version":253,"summary_zh":254,"released_at":255},61478,"dotnet-1.0.0-preview.260209.1","## What's Changed\r\n* .NET: [BREAKING] Introduce Core implementation methods for session methods on AIAgent by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3699\r\n* .NET: [BREAKING] Add ability to mark the source of Agent request messages and use that for filtering by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3540\r\n* .NET: Workflow telemetry opt in by @TaoChenOSU in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3467\r\n* .NET Pre-Publish - Update package version to 260209 by @crickman in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3777\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fcompare\u002Fdotnet-1.0.0-preview.260205.1...dotnet-1.0.0-preview.260209.1","2026-02-10T04:09:01",{"id":257,"version":258,"summary_zh":259,"released_at":260},61479,"dotnet-1.0.0-preview.260205.1","## What's Changed\r\n* .NET: Consolidate durable agent samples into Durable\u002FAgents folder by @kshyju in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3471\r\n* .Net: Update Anthropic and Anthropic.Foundry package versions by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3517\r\n* .NET: Workflows - Support fidelity when converting to and from ChatMessage in declarative workflows by @peibekwe in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3505\r\n* Update readme by @dmytrostruk in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3576\r\n* .NET: [BREAKING] Rename GetNewSession to CreateSession by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3501\r\n* .NET: [BREAKING] Move AgentSession.Serialize to AIAgent by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3650\r\n* .NET: Improve unit test coverage for Microsoft.Agents.AI.Abstractions by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3381\r\n* .NET: Add .NET Anthropic Claude Skills sample by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3497\r\n* .NET: [BREAKING] Rename session state json param by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3681\r\n* .NET: Rename 3rdPartyThreadStorage sample to 3rdPartyChatHistoryStorage by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3643\r\n* [BREAKING] Obsoleting ReflectingExecutor in favor of source gen by @alliscode in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3380\r\n* .NET: Adding AgentRunContext to allow accessing agent run info in external downstream components by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3476\r\n* .NET: [BREAKING] Remove UserInputRequests property by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3682\r\n* .NET: Fix Error 404 Agent Hosted MCP by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3678\r\n* .NET: [BREAKING] Provide agent and session to AIContextProvider & ChatHistoryProvider by @westey-m in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3695\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fcompare\u002Fdotnet-1.0.0-preview.260128.1...dotnet-1.0.0-preview.260205.1","2026-02-06T03:06:03",{"id":262,"version":263,"summary_zh":264,"released_at":265},61480,"python-1.0.0b260130","## [1.0.0b260130] - 2026-01-30\r\n\r\n### Added\r\n\r\n- **agent-framework-claude**: Add BaseAgent implementation for Claude Agent SDK ([#3509](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3509))\r\n- **agent-framework-core**: Add core types and agents unit tests ([#3470](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3470))\r\n- **agent-framework-core**: Add core utilities unit tests ([#3487](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3487))\r\n- **agent-framework-core**: Add observability unit tests to improve coverage ([#3469](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3469))\r\n- **agent-framework-azure-ai**: Improved AzureAI package test coverage ([#3452](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3452))\r\n\r\n### Changed\r\n\r\n- **agent-framework-core**: Added generic types to `ChatOptions` and `ChatResponse`\u002F`AgentResponse` for Response Format ([#3305](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3305))\r\n- **agent-framework-durabletask**: Update durabletask package ([#3492](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3492))","2026-01-30T18:51:35",{"id":267,"version":268,"summary_zh":269,"released_at":270},61481,"python-1.0.0b260128","## [1.0.0b260128] - 2026-01-28\r\n\r\n### Changed\r\n\r\n- **agent-framework-core**: [BREAKING] Renamed `@ai_function` decorator to `@tool` and `AIFunction` to `FunctionTool` ([#3413](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3413))\r\n- **agent-framework-core**: [BREAKING] Add factory pattern to `GroupChatBuilder` and `MagenticBuilder` ([#3224](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3224))\r\n- **agent-framework-github-copilot**: [BREAKING] Renamed `Github` to `GitHub`  ([#3486](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3486))","2026-01-28T21:25:04",{"id":272,"version":273,"summary_zh":274,"released_at":275},61482,"dotnet-1.0.0-preview.260128.1","## What's Changed\r\n* .NET: Add tests for subworkflow shared state behavior by @lokitoth in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3444\r\n* .NET: Improve unit test coverage for Microsoft.Agents.AI.AzureAI to 85.6% by @Copilot in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3383\r\n* .Net: Adding copilot cli to the codespaces definition by @rogerbarreto in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3479\r\n* .NET: Python: [BREAKING] Renamed Github to GitHub by @dmytrostruk in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3486\r\n* .NET - [Breaking]: Update Declarative Object Model + Dependencies by @crickman in https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fpull\u002F3017\r\n\r\n\r\n**Full Changelog**: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagent-framework\u002Fcompare\u002Fdotnet-1.0.0-preview.260127.1...dotnet-1.0.0-preview.260128.1","2026-01-28T21:14:42"]