月明的文档中心 分享AI实践与思考
入门
上手
教程
基础
概念解释
Microsoft Foundry
开发工具
操作指南
参考
治理与网络
工具与知识
概念解释
操作指南
Agent Service
总览
概念解释
Azure OpenAI
API 与开发
总览
Azure AI Search
权限与安全
参考
检索概念
概念解释
快速上手
教程
Foundry Tools
其他与已退役
总览
概念解释
RAG 与知识工程
智能体与工具
MCP 与 Skills
操作指南
基础
评测、观测与安全
安全
评测
概念解释
参考
企业架构与成本
解决方案场景
样例与学习资源
附录
VS Code 扩展
本页说明如何在 VS Code 中使用 Microsoft Foundry Toolkit 连接 Foundry 项目，并完成模型、agent、工具、追踪与评测相关的开发工作。该扩展原名 AI Toolkit，现已并入原 Microsoft Foundry 扩展的功能。
适用场景
- 在编辑器内浏览 Foundry 项目中的模型、agent、工具与评测。
- 本地试用模型与 prompt，调试 agent 代码，再部署为 hosted agent。
- 开发阶段查看 trace 与评测结果，不必频繁切换到门户。
前提
项目 | 要求 | 状态 |
编辑器 | Visual Studio Code，安装 Microsoft Foundry Toolkit 扩展 | 页面要求 |
登录 | 登录 Azure 账户，并设置要使用的 Foundry 项目 | 页面要求 |
角色 | 对项目具有开发所需的 Foundry 角色，示例为 Foundry User | 见“身份、RBAC 与策略” |
开发环境 | 按“准备开发环境”页面安装语言运行时、全局工具与 VS Code 扩展（该页面未读取） | 待核实 |
本地模型 | 本地模型可通过 ONNX、Ollama 或 Foundry Local 使用，需按各自要求安装 | 待核实 |
工作区结构
区域 | 作用 |
My Resources | 查看模型、agent、工具、知识源、评测、最近资源，以及 Foundry 项目中的资源 |
Developer Tools | 发现模型与工具；构建、调试、部署、测试、评测与监控 AI 应用和 agent |
Help And Feedback | 询问 Copilot、查看入门与发布信息、报告问题 |
主要任务与入口
任务 | 入口或功能 | 说明 |
发现与比较模型 | Model Catalog、Model Playground | 可浏览 Foundry 与外部提供方的模型，并比较提示词、参数与附件 |
创建 prompt agent | Agent Builder | 配置模型、指令与工具，保存版本，并生成调用已保存 agent 的客户端代码 |
开发 hosted agent | 基于 Microsoft Agent Framework 的代码项目 | 开发、检查并部署到 Foundry Agent Service，可从源码或容器镜像部署 |
添加工具 | Tool Catalog | 发现 Foundry 工具、MCP 服务器与 toolbox，并添加到 agent |
本地调试 | Agent Inspector | 发送本地请求，查看流式响应、工具调用与工作流执行 |
查看追踪 | 本地 OTLP 收集，或查看 hosted agent 遥测 | 与 Application Insights 中的存储 trace 不同，见追踪与监控操作指南 |
评测 | 数据集、内置或自定义评测器 | 对模型、prompt 与 agent 评测，详见运行评测操作指南 |
资源管理 | My Resources | 查看模型端点与认证信息，浏览工具与知识源 |
步骤（概要）
本页未读取各子任务的分步页面，以下仅列出总体顺序，具体操作待核实。
- 在 VS Code 扩展市场安装 Microsoft Foundry Toolkit。
- 登录 Azure 账户，在扩展中设置要使用的 Foundry 项目。
- 在 My Resources 中确认项目资源可见。
- 按任务进入 Developer Tools 的对应功能，例如在 Agent Builder 中创建 prompt agent，或在 Model Playground 中试用模型。
验证
- My Resources 中能看到所选 Foundry 项目下的模型、agent 或工具。
- 在 Agent Builder 或 Model Playground 中发送一条测试消息，能收到回复。
排错
现象 | 可能原因 | 处理 |
资源列表为空 | 登录账户与项目不一致；未设置项目 | 检查当前登录账户，重新选择 Foundry 项目 |
无法读取或修改资源 | 账户缺少对项目的 Foundry 角色 | 联系订阅或资源管理员分配角色，参见“身份、RBAC 与策略” |
本地追踪没有数据 | 收集器未启动，或 SDK 未向本地端点发送 | 待核实，按扩展中的追踪说明检查 |
限制与待核实
- 声明式 workflow 在 Foundry 中的退役日期页面写为 2026-12-01，代码型的 hosted agent 编排不受影响；日期待核实（2026-11-05 获取）。新的 workflow 开发建议改用 Microsoft Agent Framework（页面建议）。
- 部分扩展功能为预览，具体功能与版本以扩展的发布说明为准（待核实）。
- 本地保存的 prompt 不代表模型推理在本机运行（页面说明）；使用本地追踪时，模型与工具调用仍可能使用云服务并产生费用（页面说明，费用单价待核实）。
- 本地保存的 prompt 与云端 Foundry prompt agent 的工具、结构化输出及数据集评测选项不同，二者不能直接等同（页面说明）。
- 调试与追踪的数据来源不同：Agent Inspector 查看的是实时事件，trace 查看的是已记录的遥测。
来源与核对
- sources：见页头 sources 列表（VS Code 扩展概览页、追踪设置页）。
- read_scope：正文已读。扩展概览页已通读；各子任务的分步页面未读取，步骤部分仅为概要，具体操作待核实。
上一篇
从 Azure OpenAI 资源升级到 Foundry
下一篇
SDK 与项目
Loading...