m
microsoft/agent-framework
A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET.
agent-frameworkagentic-aiagentsaidotnetmulti-agentorchestrationpythonsdkworkflows
PythonMIT创建于 2025/4/28更新于 今天
README
由 Gemini 翻译整理
欢迎使用 Microsoft Agent Framework！
Microsoft Agent Framework (MAF) 是一个开源的多语言框架，用于在 .NET 和 Python 中构建生产级 AI Agent 和多 Agent 工作流。
Microsoft Agent Framework 专为那些将 Agent 从原型推向生产环境的团队而设计。它为跨 Python 和 .NET 构建、编排及运行 Agent 系统提供了统一的基础，同时在需求演变时保持架构选择的灵活性。它支持广泛的生态系统，包括 Microsoft Foundry、Azure OpenAI、OpenAI 以及 GitHub Copilot SDK，并提供了适用于本地开发和云端部署的示例与托管模式。
观看完整的 Agent Framework 介绍（30 分钟）
这是适合您的框架吗？
如果您符合以下情况，MAF 将是一个强有力的选择：
- 您正在构建预期在生产环境中运行的 Agent 和工作流；
- 您需要的编排功能超出了单个 Prompt 或无状态聊天循环的范畴；
- 您需要基于图（graph-based）的模式，如顺序执行、并发执行、任务移交（handoff）和群组协作；
- 您关注持久性、可重启性、可观测性、治理或人机协同控制（human-in-the-loop）；
- 您需要提供商的灵活性，以便在不进行重大重构的情况下优化您的架构。
关键特性
探索 MAF 的新功能和真实实现模式，请访问官方博客。
- Python 和 C#/.NET 支持：为 Python 和 C#/.NET 实现提供全框架支持，并具有一致的 API。
- 多 Agent 提供商支持：支持各种 LLM 提供商，并持续增加中。
- 中间件 (Middleware)：灵活的中间件系统，用于请求/响应处理、异常处理和自定义流水线。
- 编排模式与工作流：构建多 Agent 系统，支持基于图的工作流，涵盖顺序执行、并发执行、移交和群组协作模式；包含检查点、流式传输、人机协同和时间旅行（time-travel）调试。
- Foundry 托管 Agent (新)：只需额外两行代码即可将 Agent 部署并托管到 Foundry 托管的基础设施中。
- 可观测性：内置 OpenTelemetry 集成，用于分布式追踪、监控和调试。
- 声明式 Agent (Declarative Agents)：使用 YAML 定义 Agent，以便更快速地进行设置和版本管理。
- Agent 技能 (Skills)：从多种来源（文件、内联代码、类库）构建领域特定的知识库，供 Agent 发现和使用。
- AF Labs：用于前沿功能的实验性包，包括基准测试、强化学习和研究计划。
- DevUI：用于 Agent 开发、测试和调试工作流的交互式开发 UI。
目录
入门指南
安装
Python
pip install agent-framework
# 这将安装所有子包，查看 `python/packages` 获取单个包的信息。
# 首次安装可能需要一点时间