欢迎使用 Microsoft Agent Framework！

欢迎使用 Microsoft 推出的综合性多语言框架，用于构建、编排和部署 AI Agent。本框架同时支持 .NET 和 Python 实现，提供了从简单的聊天 Agent 到基于图的复杂多 Agent 工作流所需的一切功能。

观看 Microsoft Agent Framework 完整介绍（30 分钟）

📋 入门指南

📦 安装

Python

pip install agent-framework --pre
# 这将安装所有子包，查看 `python/packages` 以获取单个包。
# 在 Windows 上首次安装可能需要一点时间。

.NET

dotnet add package Microsoft.Agents.AI

📚 文档

• 概述 - 框架的高级概述
• 快速入门 - 从一个简单的 Agent 开始
• 教程 - 分步教程
• 用户指南 - 构建 Agent 和工作流的深入用户指南
• 从 Semantic Kernel 迁移 - 从 Semantic Kernel 迁移的指南
• 从 AutoGen 迁移 - 从 AutoGen 迁移的指南

还有疑问？欢迎加入我们的每周答疑时间，或在我们的 Discord 频道提问，从团队成员和其他用户那里获取帮助。

✨ 功能亮点

• 基于图的工作流 (Graph-based Workflows)：使用数据流连接 Agent 和确定性函数，支持流式处理、检查点、人工介入 (Human-in-the-loop) 和时间回溯能力
  • Python 工作流 | .NET 工作流
• AF Labs：用于前沿特性的实验性包，包括基准测试、强化学习和研究项目
  • Labs 目录
• DevUI：用于 Agent 开发、测试和调试工作流的交互式开发人员 UI
  • DevUI 包

查看 DevUI 演示（1 分钟）

• Python 和 C#/.NET 支持：全框架支持 Python 和 C#/.NET 实现，且 API 保持一致
  • Python 包 | .NET 源码
• 可观测性 (Observability)：内置 OpenTelemetry 集成，用于分布式追踪、监控和调试
  • Python 可观测性 | .NET 遥测
• 多 Agent 提供商支持：支持各种 LLM 提供商，并且持续增加中
  • Python 示例 | .NET 示例
• 中间件 (Middleware)：用于请求/响应处理、异常处理和自定义管道的灵活中间件系统
  • Python 中间件 | .NET 中间件

💬 期待您的反馈！

• 如遇 Bug，请提交 GitHub Issue。

快速入门

基础 Agent - Python

创建一个简单的 Azure Responses Agent，让它写一首关于 Microsoft Agent Framework 的俳句：

# pip install agent-framework --pre
# 使用 `az login` 通过 Azure CLI 进行身份验证
import os
import asyncio
from agent_framework.azure import AzureOpenAIResponsesClient
from azure.identity import AzureCliCredential


async def main():
    # 初始化一个带有 Azure OpenAI Responses 的聊天 Agent
    # endpoint、deployment_name 和 api_version 可以通过环境变量设置，
    # 或者直接传递给 AzureOpenAIResponsesClient 构造函数
    agent = AzureOpenAIResponsesClient(
        # endpoint=os.environ["AZURE_OPENAI_ENDPOINT"],
        # deployment_name=os.environ["AZURE_OPENAI_RESPONSES_DEPLOYMENT_NAME"],
        # api_version=os.environ["AZURE_OPENAI_API_VERSION"],
        # api_key=os.environ["AZURE_OPENAI_API_KEY"],  # 如果使用 AzureCliCredential 则可选
    )