月明的文档中心 分享AI实践与思考
入门
上手
教程
基础
概念解释
Microsoft Foundry
开发工具
操作指南
参考
治理与网络
工具与知识
概念解释
操作指南
Agent Service
总览
概念解释
Azure OpenAI
API 与开发
总览
Azure AI Search
权限与安全
参考
检索概念
概念解释
快速上手
教程
Foundry Tools
其他与已退役
总览
概念解释
RAG 与知识工程
智能体与工具
MCP 与 Skills
操作指南
基础
评测、观测与安全
安全
评测
概念解释
参考
企业架构与成本
解决方案场景
样例与学习资源
附录
SDK 与项目
本页汇总 Foundry SDK 的语言包、版本线与项目端点的基本约定，便于选择依赖与核对环境。版本号、运行时版本与示例模型名均标注为待核实（2026-11-05 获取），以官方页面为准。
核心概念
概念 | 说明 |
Foundry SDK | 薄客户端，通过单一的项目端点访问 Foundry 项目的各类 API；其他 Foundry 相关 SDK（例如 Microsoft Agent Framework 的 foundry 包）依赖它 |
项目端点（project endpoint） | 形如 https://<资源名>.services.ai.azure.com/api/projects/<项目名>；使用自定义子域时替换为对应的子域名 |
项目客户端 | 各语言的 AIProjectClient，用于创建与管理 agent、获取 OpenAI 兼容客户端等 |
新版与经典版 | 门户分为 Foundry（new）与 Foundry classic，两者的包版本线不同，不能混用 |
语言包与版本线
语言 | 新版包（Foundry new） | 版本（待核实，2026-11-05 获取） | 安装方式（页面示例） |
Python | azure-ai-projects | 2.x，页面示例要求 2.3.0 或更高 | pip 安装 azure-ai-projects 与 openai |
JavaScript / TypeScript | @azure/ai-projects | 2.8.0 | npm 安装 @azure/ai-projects 与 @azure/identity |
.NET（C#） | Azure.AI.Projects、Azure.AI.Projects.Agents、Azure.AI.Extensions.OpenAI | 2.0.0（页面标注为 GA） | dotnet add package 逐个添加 |
Java | azure-ai-projects、azure-ai-agents（Maven） | 2.3.0 | 在 pom 中声明依赖 |
语言 | 经典版（Foundry classic）包 | 版本（待核实） |
Python | azure-ai-projects | 1.0.0 |
JavaScript / TypeScript | @azure/ai-projects | 1.0.1 |
.NET（C#） | Azure.AI.Projects | 1.1.0 |
运行环境与前提
项目 | 页面要求 | 状态 |
Python | 3.10 或更高 | 待核实（2026-11-05 获取） |
Node.js | 22 或更高 | 待核实（2026-11-05 获取） |
.NET | 8 或更高 | 待核实（2026-11-05 获取） |
Java | 17 或更高 | 待核实（2026-11-05 获取） |
身份 | 通过 Azure CLI 登录，或使用 DefaultAzureCredential 等凭据；本机凭据需能请求 Foundry 访问令牌 | 页面说明 |
角色 | 需要对 Foundry 资源拥有对应的 Foundry 角色（页面示例为 Foundry User） | 角色说明见“身份、RBAC 与策略” |
模型部署 | 项目中需已有可用的模型部署，示例部署名为 gpt-5-mini | 示例名称，待核实 |
版本注意事项
事项 | 说明 | 状态 |
同名类型冲突 | .NET 中不要同时安装预览包 Azure.AI.Projects.OpenAI 与 GA 包 Azure.AI.Extensions.OpenAI，二者的类型同名，会引起引用歧义；agent 场景只使用后者 | 页面说明 |
稳定客户端 | Python 2.3.0 起，托管 agent 与 toolbox 操作改用稳定客户端，不再使用 beta 命名空间 | 页面说明 |
长时运行操作 | 评测、数据生成等在新版 SDK 中返回 poller，需要轮询结果 | 页面说明 |
旧版与新版混用 | 经典版与新版的包版本线不同，依赖管理时需按门户版本选择 | 页面说明 |
与相邻工具的关系
工具 | 适用场景 | 与 SDK 的关系 |
Foundry 门户 | 可视化创建 agent、评测与查看结果 | 同一项目资源的图形入口；复杂的资源管理以门户为准 |
VS Code 扩展（Foundry Toolkit） | 在编辑器内浏览资源、调试与部署 | 扩展的操作最终落到 SDK 或门户能力，见“VS Code 扩展” |
Microsoft Agent Framework | 代码优先的多 agent 编排 | foundry 包依赖 Foundry SDK |
限制与待核实
- 上表所有版本号与运行环境要求均为 2026-11-05 获取的页面信息，待核实。
- 页面包含大量代码示例，本页未逐一核对其可运行性。
- 经典版与新版的功能差异、支持周期待核实。
来源与核对
- sources：见页头 sources 列表（Foundry SDK 概览页、VS Code 扩展页）。
- read_scope：正文已读。SDK 概览页长文已读取其中的安装、包名与项目端点相关章节；代码示例与其他语言细节未逐段核对。
上一篇
VS Code 扩展
下一篇
内容过滤配置
Loading...