用途：在开发、维护或迁移基于 Microsoft Agent Framework 的应用、智能体与工作流时提供指导。该框架是 Semantic Kernel 与 AutoGen 的统一后继者，目前处于公开预览阶段，变化较快，因此建议始终以最新官方文档和示例为准。
主要能力：先确定目标语言再给建议。仓库含 .cs、.csproj、.sln、.slnx 等 .NET 文件或用户要求 C#/.NET 时走 .NET 流程，参考 references/dotnet.md；含 .py、pyproject.toml、requirements.txt 或用户要求 Python 时走 Python 流程，参考 references/python.md；两者都有则按正在编辑的文件或用户指定语言匹配；语言不明确时先检查工作区再选最接近的参考。
使用方式：先阅读官方概览 https://learn.microsoft.com/agent-framework/overview/agent-framework-overview，优先使用官方文档与示例，可用 Microsoft Docs MCP 工具获取最新指导。通用建议包括：智能体与工作流操作使用异步模式，实现显式错误处理与日志，偏好强类型、清晰接口与可维护的组合模式，Azure 认证适用时使用 DefaultAzureCredential。智能体适合自主决策、临时规划、对话流、工具调用与 MCP 服务器交互；工作流适合多步编排、预定义执行图、长任务与人在环场景。支持 Azure AI Foundry、Azure OpenAI、OpenAI 等模型提供方，新项目在符合需求时优先 Azure AI Foundry。可按需使用基于线程的状态处理、上下文提供程序、中间件、检查点、路由与编排模式。
迁移：从 Semantic Kernel 迁移参考 https://learn.microsoft.com/agent-framework/migration-guide/from-semantic-kernel/；从 AutoGen 迁移参考 https://learn.microsoft.com/agent-framework/migration-guide/from-autogen/。先保持行为一致，再逐步采用原生模式。
限制：资料未提供具体包名、安装命令、价格与平台细节；框架处于公开预览，API 可能变动，应以官方最新文档为准。