microsoft/agent-framework

Microsoft Agent Framework (MAF)

它是什么：一个开源、多语言的 SDK，用于构建生产级 AI 代理和多代理工作流。它提供了 Python、.NET/C# 的库，以及一个单独的 Go SDK，让开发者可以用他们偏好的语言编写代理，同时使用一组通用的概念和 API。

关键能力

• 跨语言支持 – Python 和 .NET 中相同的编程模型；Go SDK 单独提供。
• 与提供商无关 – 可与 Azure OpenAI、OpenAI、GitHub Copilot SDK 以及其他 LLM 提供商一起使用。
• 基于图的编排 – 定义顺序、并发、交接和群组协作模式；包括检查点、流式传输和人工介入控制。
• 中间件 – 可插拔的请求/响应处理、错误处理和自定义管道。
• 可观测性 – 内置 OpenTelemetry 集成，用于追踪和指标。
• 声明式代理 – 代理可以用 YAML 描述，便于版本控制。
• 代理技能 – 附加领域特定的知识库（文件、代码、库），代理可以查询。
• 托管选项 – 在本地、Azure Functions/Durable Tasks 上运行，或作为 Foundry 托管 代理，只需极少的代码更改。
• 开发者 UI – 用于测试和调试工作流的交互式 UI。

典型用例

• 需要可靠状态、重试和监控的企业级聊天助手。
• 复杂的多代理系统（例如，一个规划代理协调专业代理）。
• 必须切换 LLM 提供商或从原型迁移到生产而无需重写核心逻辑的应用程序。

入门

• 安装 Python 包：pip install agent-framework（或 .NET NuGet Microsoft.Agents.AI）。
• 按照快速入门示例创建一个简单的“HaikuAgent”，调用 Foundry 托管的模型。
• 探索广泛的示例目录，了解代理、中间件、工作流和托管模式。

社区与支持

• Microsoft Learn 上的官方文档、Discord 社区、每周办公时间以及公共问题跟踪器。
• 欢迎通过仓库的 CONTRIBUTING 指南贡献代码。

底线：Microsoft Agent Framework 是一个真正的、面向生产的工具包，用于跨多种语言和云提供商构建、编排和操作 AI 代理，使其成为团队超越单提示聊天机器人，进入健壮、可观测代理系统的可靠选择。