你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
使用 Microsoft Foundry Toolkit for Visual Studio Code 配置提示代理或开发基于代码的托管代理。 根据说明和支持的工具是满足你的需求，还是需要自定义运行时逻辑，选择创建路由。
先决条件
- 安装 Microsoft Foundry Toolkit for Visual Studio Code。
- 对于使用 Foundry 资源的代理， 请设置 Foundry 项目。 请遵循所选路由的指南，了解模型、权限和运行时要求。
- 对于借助 Copilot 进行编码，可访问Visual Studio Code 中的 GitHub Copilot。
选择代理类型
Foundry 支持 提示代理和托管代理。 这两种代理类型都可以使用工具和集成到应用程序中。 提示词代理并不仅限于原型阶段。
| 比较 | 提示智能体 | 托管代理 |
|---|---|---|
| 定义行为 | 配置模型、说明和支持的工具。 | 使用框架或你自己的代码实现自定义逻辑。 |
| 将其用于 | 说明和支持的工具可以处理的任务，例如回答问题或汇总文档。 | 自定义业务流程、依赖项或运行时行为，例如多代理工作流。 |
| 你维护的内容 | 代理配置和已保存的版本。 | 代理代码、依赖项、打包和部署配置。 |
| 从哪里开始 | 代理生成器。 | 托管代理示例或 Copilot 辅助编程。 |
如果提示词代理的配置选项能满足你的需求，就先使用提示词代理。 如果需要对执行进行更多控制，请选择托管代理。 有关详细信息，请参阅 何时使用托管代理。
打开“创建代理”
打开“创建”页，选择如何生成代理。
在活动栏中，选择 Foundry Toolkit。
在 “开发人员工具”下，展开“ 生成”，然后选择“ 创建代理”。
如果开发人员工具使用按资源分组，请在代理开发工具下查找“创建代理”，而不是“生成”。
选择创建路由
选择与代理类型匹配的路由，然后按照其指南配置、测试和保存或部署代理。
| Route | 创建代理中的操作 | 下一篇指南 |
|---|---|---|
| 代理生成器 | 选择 “生成代理 ”以配置没有托管代理代码项目的提示代理。 | 创建提示代理。 |
| 托管代理示例 | 在 “对示例中的代理进行编码”下，选择框架或 “浏览所有示例”。 为方案选择示例。 | 对于基于代码的编排，创建托管代理。 对于其他场景，请遵循所选示例生成的 README.md。 |
| Copilot辅助编码 | 选择使用 Copilot 编写智能体，以使用 GitHub Copilot 和 Foundry 技能开发智能体代码。 | 在编码代理中使用 Microsoft Foundry 技能。 在部署之前查看生成的代码并对其进行测试。 |
代理生成器还支持本地存储的提示。 它们的存储、工具和评估选项不同于 Foundry 提示代理。 请参阅 “使用本地提示”。
选择如何协调或安排工作
对于基于代码的新工作流，请通过示例或Copilot路由使用 Microsoft Agent Framework。 若要按触发器或计划调用现有代理，请参阅 Foundry 代理服务中的例程（预览版）。
重要
Microsoft Foundry 中的声明性工作流处于预览状态，2026 年 12 月 1 日停用。 此停用不会影响托管代理中基于代码的业务流程。 若要使用现有的声明性工作流，请参阅 “使用和迁移声明性代理工作流”。
相关内容
在开发和集成代理时使用这些指南：