Microsoft Agent Framework 智能体开发框架

能做什么

Microsoft Agent Framework (MAF) 是一个开源、多语言的智能体开发框架，面向需要将智能体从原型推进到生产环境的团队。根据项目说明，它提供以下能力：

• 多语言支持：为 Python 与 C#/.NET 提供完整框架支持，两者 API 保持一致；Go SDK 位于独立仓库。
• 多智能体服务商接入：支持多种 LLM 服务商，并持续增加。
• 编排模式与工作流：支持基于图的顺序、并发、交接（handoff）和群组协作模式，并包含检查点、流式输出、人在回路与时间旅行（time-travel）能力。
• 中间件：提供灵活的中间件系统，用于请求/响应处理、异常处理和自定义管道。
• 可观测性：内置 OpenTelemetry 集成，用于分布式追踪、监控与调试。
• 声明式智能体：可使用 YAML 定义智能体，便于快速搭建与版本管理。
• Agent Skills：从文件、内联代码、类库等多种来源构建领域知识库，供智能体发现与使用。
• Foundry 托管智能体：项目说明称可通过额外少量代码将智能体部署并托管到 Foundry 托管基础设施。
• DevUI：用于智能体开发、测试与调试的交互式开发者界面。
• AF Labs：包含基准测试、强化学习等前沿实验性功能的实验包。

适用场景

项目说明中列出的适用情况包括：

• 构建预期在生产环境中运行的智能体与工作流；
• 需要超出单一提示或无状态对话循环的编排能力；
• 需要图结构模式，如顺序、并发、交接和群组协作；
• 关注持久性、可重启、可观测性、治理或人在回路控制；
• 需要服务商灵活性，使架构演进时无需大规模重写。

使用条件与限制

• 安装方式：Python 通过 pip install agent-framework 安装；.NET 通过 dotnet add package Microsoft.Agents.AI 及相关包添加。实验模块需单独安装 agent-framework-lab。
• 运行环境：需要对应语言的运行环境（Python 或 .NET）。示例中使用 Azure CLI 登录（az login）进行身份验证，并可通过环境变量配置端点、部署名称和 API 版本。
• 第三方系统风险：项目说明提示，若用该框架构建与任何第三方服务器、智能体、代码或非 Azure Direct 模型交互的应用，风险由使用者自行承担；第三方系统受其自身许可条款约束，数据共享、保留与跨境流动需由使用者自行管理并确保获得适当授权。
• 责任归属：使用者需针对自身用例审查和测试所构建的应用，并自行落实负责任 AI 措施（如元提示、内容过滤或其他安全系统），确保满足质量、可靠性、安全与可信标准。
• 生产凭据建议：项目说明建议开发时可用 DefaultAzureCredential，但生产环境应考虑使用特定凭据（如 ManagedIdentityCredential），以避免延迟、非预期凭据探测及回退机制带来的安全风险。