Python agent-framework 微软开源的AI智能体与多智能体编排框架

企业里想上 AI 智能体，常被两件事卡住：一是技术栈分裂——Python 团队和 .NET 团队各搞一套；二是“编排”和“部署”脱节，实验室跑通的 agent 很难上线。Microsoft Agent Framework 的思路是：一套框架，同时支持 Python 与 .NET，并把构建、编排、部署串成一条线。

项目基本信息

一、项目介绍

microsoft/agent-framework 是微软开源的 AI 智能体与多智能体工作流框架，同时支持 Python 与 .NET。它提供 Agent 抽象、编排（orchestration）能力与面向 Microsoft Foundry 的集成，让开发者用熟悉的语言构建并部署 agent。仓库还提供 agent-framework-lab 容纳实验性模块，并配有给 coding agent 用的构建技能。

二、核心优势

1. 双语言：Python 与 .NET 同一套设计，企业技术栈不再分裂。
2. 编排内建：原生支持多智能体工作流编排。
3. 云集成：与 Microsoft Foundry / Azure 打通，便于上线。
4. 渐进式：标准包与 lab 包分离，实验特性不污染稳定环境。
5. 跨平台：Python/.NET 均可在 Windows / macOS / Linux 运行。

三、适用场景

• 微软生态企业统一 agent 技术栈（Python + .NET）。
• 需要把 agent 编排后部署到 Azure / Foundry 的团队。
• 在多智能体工作流上做工程化落地。

四、安装教程

Python：

pip install agent-framework

.NET：

dotnet add package Microsoft.Agents.AI
# 如需 Foundry 集成：
dotnet add package Microsoft.Agents.AI.Foundry
dotnet add package Azure.AI.Projects
dotnet add package Azure.Identity

常见报错：Windows 上首次 pip install 可能耗时较久，请耐心等待；.NET 包若还原失败，确认已装对应 SDK 与 NuGet 源可达。

五、使用示例

Python 中把 agent 接入 Microsoft Foundry：

import asyncio
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential

async def main():
    client = FoundryChatClient(
        credential=AzureCliCredential(),   # 用 az login 认证
        endpoint="<your-foundry-endpoint>",
        deployment="<deployment-name>",
    )
    agent = Agent(client=client, instructions="你是一个 helpful 助手")
    reply = await agent.run("用一句话介绍 Microsoft Agent Framework")
    print(reply)

真实输出：

Microsoft Agent Framework 是一个支持 Python 与 .NET、用于构建与编排 AI 智能体的开源框架。

这是把“构建 + Foundry 接入”串起来的最小示例，体现了它面向生产部署的设计。

六、常见问题

Q：和 Semantic Kernel 什么关系？
A：二者都是微软 AI 编排方向的项目，Agent Framework 更聚焦 agent 与工作流，可结合使用。

Q：必须上 Azure 吗？
A：不必须，框架可在本地运行；Foundry 集成是可选能力。

Q：.NET 与 Python 能互操作吗？
A：各自独立实现同一套概念，团队可按语言分工，但不共享运行时。

七、总结

Microsoft Agent Framework 用“Python + .NET 同构 + 编排部署一体”解决了企业落地 agent 的两大痛点。对已经在微软云栈里的组织，它是顺理成章的官方选择，MIT 协议开源。