你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

通过 Microsoft Foundry Toolkit 使用和迁移声明性代理工作流

使用 Microsoft Foundry Toolkit for Visual Studio Code 来处理现有的声明性工作流，并为迁移做好准备。 可以测试已保存的工作流、编辑其导出的 YAML，并使用GitHub Copilot来帮助将定义转换为 Microsoft Agent Framework 代码。

重要

Microsoft Foundry 中的声明性工作流处于预览状态，2026 年 12 月 1 日停用。 使用 Microsoft Agent Framework 进行新的工作流开发。 此停用不会影响托管代理中基于代码的业务流程。 有关支持的迁移路径，请参阅 工作流迁移指南 。

先决条件

查看声明性代理工作流

在您的项目的整合后代理列表中找到该工作流。

  1. 在 Foundry 工具包 视图中的 “我的资源”下，确认所选的 Foundry 项目。
  2. 选择 “代理”，然后选择“ 工作流 ”选项卡。
  3. 选择工作流名称以打开其演练场。
  4. 使用版本选择器选择要检查的已保存版本。

操场显示工作流图和对话区域。 该图表为只读。 使用导出的 YAML 或 Foundry 门户网站编辑该定义。

编辑现有工作流定义

在编辑或迁移定义之前导出定义。 保留原始 YAML 的副本，以便将其与更改进行比较。

  1. 在 Foundry 门户中打开现有工作流。
  2. 在工作流设计器中，切换到 YAML 视图并复制或导出定义。 有关详细信息，请参阅 “导出工作流定义”。
  3. 将定义保存在本地工作区中，名称以结尾 .workflow.yaml，例如 support.workflow.yaml。
  4. 在Visual Studio Code中打开该文件并编辑 YAML。
  5. 保存文件。 本地文件更改不会更新 Foundry 中的工作流。

保存现有工作流的新版本

在停用之前，可以将编辑的定义部署到同一工作流。 确认项目和工作流名称以避免创建其他资源。

  1. 确认在 Foundry Toolkit 中选择了原始工作流的项目。
  2. 打开文件后 .workflow.yaml ，在编辑器工具栏中选择“ 部署 ”。
  3. 在 Enter 工作流名称中，输入现有工作流的名称。
  4. 等待部署成功通知。
  5. 从 代理>工作流 重新打开工作流并选择新版本。

使用现有工作流名称进行部署会创建新版本。 其他名称创建单独的工作流;不要使用此路径来启动新的工作流开发。

在操场中测试工作流

测试计划维护或迁移的已保存版本。 稍后使用相同的请求比较迁移的实现。

  1. 打开工作流演练场并选择所需的版本。
  2. 在 “操场 ”选项卡上，选择“ 新建 ”以启动新的操场会话。
  3. 输入一个用于测试该工作流的请求并发送。
  4. 查看响应和执行图。 确认预期的代理、分支和步骤均正常运行。
  5. 使用能够覆盖不同分支、缺少输入的情况以及工作流中任何审批步骤的请求重复进行测试。

演练场运行已保存的 Foundry 工作流。 它不会在本地 YAML 文件或Copilot生成的代码中运行未保存的更改。

将 YAML 工作流转换为代理框架代码

使用演练场中的代码生成操作，让 GitHub Copilot 转换所选的工作流定义。 生成的代码只是一个起点，你必须对其进行审查和测试。

  1. 在工作流演练场中，选择要迁移的版本。
  2. 选择“ 生成代码”。
  3. 选择Python或 C# 。
  4. 查看Copilot 对话助手中的转换请求，并按照其提示生成代码。
  5. 查看生成的项目、依赖项、模型连接、工具和身份验证配置。
  6. 将其编排与导出的 YAML 进行比较。 检查分支、变量、代理调用和人工审批步骤。
  7. 在本地运行代码，并使用用于原始工作流的请求对其进行测试。 使用代理检查器检查执行过程。
  8. 当代码按要求运行时，请按照 创建托管代理 来准备受支持的托管代理项目、部署它并测试已部署的版本。

代码转换不部署托管代理或保证等效行为。 保留原始定义，直到完成迁移并确认依赖应用程序使用替换。

有关其他迁移选择，包括代理框架声明性 YAML、Azure 逻辑应用和直接 A2A 连接，请参阅工作流迁移指南。

相关内容

使用以下指南选择并完成迁移：

  • Last updated on