使用 Microsoft Foundry Toolkit for Visual Studio Code，與現有的宣告式工作流程合作並為遷移做準備。 你可以測試已儲存的工作流程，編輯匯出的 YAML，並使用 GitHub Copilot 協助將定義轉換成 Microsoft Agent Framework 程式碼。
這很重要
Microsoft Foundry 中的宣告式工作流程目前處於預覽階段，將於 2026 年 12 月 1 日正式退休。 使用 Microsoft Agent Framework 進行新的工作流程開發。 這次退休不會影響託管代理程式中的程式碼編排。 請參閱 工作流程遷移指南 以了解支援的遷移路徑。
先決條件
- 安裝 Microsoft Foundry Toolkit for Visual Studio Code。
- 選擇包含你現有宣告式工作流程的 Foundry 專案。
- 存取並執行該工作流程及其參考代理。 要儲存變更，你也需要在專案中建立代理版本的權限。 參見 Foundry 基於角色的存取控制。
- 若要轉換程式碼，請使用Visual Studio Code中的GitHub Copilot。
查看宣告式代理工作流程
在專案的整合代理人名單中找到工作流程。
- 在 Foundry 工具包 檢視中，在 「我的資源」中確認所選的 Foundry 專案。
- 選擇代理人，然後選擇工作流程標籤。
- 選擇工作流程名稱以開啟遊樂場。
- 使用版本選擇器選擇你想檢查的已儲存版本。
遊樂場會顯示工作流程圖和對話區。 此圖表為唯讀。 請使用匯出的 YAML 或 Foundry 入口網站來編輯定義。
編輯現有的工作流程定義
編輯或遷移前，請先匯出定義。 保留原始 YAML 的副本，方便你與變更時做比較。
- 在 Foundry 入口網站開啟現有的工作流程。
- 在工作流程設計器中，切換到 YAML 視圖，複製或匯出定義。 詳情請參見 匯出您的工作流程定義。
- 將該定義儲存至本機工作區，並命名為以
.workflow.yaml結尾的名稱，例如support.workflow.yaml。 - 在 Visual Studio Code 中開啟檔案並編輯 YAML。
- 儲存檔案。 本地檔案變更不會更新 Foundry 的工作流程。
儲存現有工作流程的新版本
退休前，你可以將修改過的定義部署到相同的工作流程。 確認專案名稱和工作流程名稱，以避免建立不同的資源。
- 確認原始工作流程的專案已在 Foundry 工具包中被選取。
- 打開
.workflow.yaml檔案後，在編輯器工具列中選擇 部署 。 - 在 輸入工作流程名稱時，輸入現有工作流程的名稱。
- 等待部署成功通知。
- 從 代理人>工作流程 重新開啟工作流程並選擇新版本。
使用現有工作流程名稱部署會產生新版本。 不同名稱會產生獨立的工作流程;不要用這條路徑來開始新的工作流程開發。
在遊樂場測試工作流程
測試你打算維護或遷移的已儲存版本。 之後再用同樣的請求來比較遷移後的實作。
- 打開工作流程的遊樂場，選擇所需的版本。
- 在 Playground 索引標籤上，選取 新增 以開始新的 Playground 工作階段。
- 輸入一個符合工作流程的請求並發送。
- 檢視回應與執行圖。 確認預期的代理程式、分支和步驟皆有執行。
- 針對可涵蓋不同分支、缺少輸入，以及工作流程中任何核准步驟的請求，重複執行此操作。
遊樂場執行已儲存的 Foundry 工作流程。 它不會執行你本地 YAML 檔案或 Copilot 產生的程式碼中未儲存的變更。
將 YAML 工作流程轉換為 Agent Framework 程式碼
使用 Playground 的程式碼產生動作，請 GitHub Copilot 轉換所選的工作流程定義。 產生的程式碼是你必須檢視和測試的起點。
- 在工作流程遊樂場中，選擇要遷移的版本。
- 選擇 產生程式碼。
- 選擇 Python 或 C#。
- 請在 Copilot Chat 中檢視轉換請求，並依照提示生成程式碼。
- 檢視已產生的專案、相依關係、模型連結、工具及認證設定。
- 比較它的協調方式與輸出的 YAML。 檢查分支、變數、代理程式呼叫和人工核准步驟。
- 在本地執行程式碼，並用你原本工作流程的請求來測試。 使用 Agent Inspector 來檢查執行。
- 當程式碼符合需求時，請依照 建立託管代理程式（Create hosted agents） 準備一個支援的託管代理專案，部署並測試已部署的版本。
程式碼轉換並不代表會部署託管代理，也不保證有同等的行為。 保留原始定義，直到你完成遷移並確認受依應用程式使用替換。
關於其他遷移選項，包括 Agent Framework 宣告式 YAML、Azure Logic Apps 及直接 A2A 連線，請參閱工作流程遷移指南。
相關內容
請參考這些指南來選擇並完成你的遷移：