agent-framework

环境要求

• Python 环境及 pip（使用 Python 版 SDK）
• 可访问 PyPI 的网络
• 安装 .NET 包需要 .NET SDK 和一个已有的 .NET 项目
• 接入 Microsoft Foundry 时需要 Azure 相关资源与凭据

安装与启动步骤

1. 1安装 Python 包

   在终端执行 pip 安装官方包 agent-framework，它会装上标准包集合；首次安装可能需要一点时间。

   pip install agent-framework

   复制

2. 2安装实验模块

   标准包不含实验性模块，如需实验功能再单独安装 agent-framework-lab。

   pip install agent-framework-lab

   复制

3. 3安装 .NET 包

   在 .NET 项目目录下通过 dotnet add package 添加核心包 Microsoft.Agents.AI。

   dotnet add package Microsoft.Agents.AI

   复制

4. 4安装 Foundry 依赖

   若使用 .NET 快速开始中的 Foundry 集成，需再添加三个配套包。

   dotnet add package Microsoft.Agents.AI.Foundry
   dotnet add package Azure.AI.Projects
   dotnet add package Azure.Identity

   复制

5. 5查阅官方文档

   README 未给出运行代码示例，建议从官网获取快速开始与部署示例。

如何确认成功

用 pip show agent-framework 能看到已安装的包信息，或在 .NET 项目引用列表中看到 Microsoft.Agents.AI，即表示安装成功。

常见问题

注意事项

• README 节选中未给出端口、配置文件或环境变量说明，实际接入方式请以官网 aka.ms/agent-framework 文档为准。
• dotnet add package 需先在已有 .NET 项目的目录中执行，否则会报错。
• 框架同时支持 Python、.NET 与 Go，不同语言使用各自的包管理器安装，勿混用命令。