在 Visual Studio Code 中新增宣告式代理工作流程

宣告式代理工作流程透過配置定義預先定義的行動序列，而非明確的程式邏輯。 在本文中，你會將 Foundry Agent 工作流程加入代理程式，並透過 Microsoft Foundry for Visual Studio Code （VS Code） 擴充功能進行測試。

在入口網站 的 Foundry Agent Service 中建立代理 後，你可以新增工作流程，將多個代理協調成預設的動作序列，以應對複雜的自動化情境。

這很重要

本文中標示為 (預覽) 的項目目前處於公開預覽狀態。 此預覽版是在沒有服務等級協定的情況下提供，不建議用於生產工作負載。 如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

先決條件

• 至少包含一個已部署代理程式的 Foundry 專案。 要在 Foundry 入口網站建立一個，請參見 快速入門：與代理人聊天。
• 在 Foundry 入口網站 至少建立了一個工作流程。 欲了解更多工作流程資訊，請參閱 Foundry Agent 工作流程。
• 安裝了 Microsoft Foundry for Visual Studio Code 擴充套件 。
• GitHub Copilot 訂閱（將 YAML 工作流程轉換為 Agent Framework 程式碼所必需）。

查看宣告式代理工作流程

要在 VS Code for the Web 中查看及編輯宣告式代理工作流程，請先在 Foundry 入口網站中導覽該工作流程：

1. 在 Foundry 入口網站中，打開包含工作流程的專案。
2. 從左側選單選擇 工作流程 標籤。
3. 選擇你想開啟的工作流程。

接著選擇以下選項之一，在 VS Code for the Web 中開啟工作流程。

在 VS Code for the Web 中開啟 YAML 工作流程

1. 選擇 「建構 」標籤，然後選擇右側的 YAML 按鈕。
2. 選擇「在 VS Code 網頁版中開啟」按鈕。 工作流程 YAML 檔案在 VS Code 的網頁編輯器中開啟，左側為 YAML 定義，右側為視覺化工作流程圖表。
3. 根據需要編輯 YAML，修改工作流程。 變更會反映在視覺編輯器中。
4. 完成後，從右上角的省略號選單（...）中選擇部署，以將變更存回 Foundry。

從 Foundry 入口開啟工作流程程式碼

1. 選擇 「建造 」標籤，然後選擇右側的 程式碼 按鈕。
2. 選擇 在 VS Code 網頁版開啟 按鈕。 工作流程程式碼檔案會在 VS Code for Web 編輯器中開啟，左側為程式碼定義，右側為視覺化工作流程圖表。
3. 根據需要修改程式碼來修改工作流程。 變更會反映在視覺編輯器中。
4. 完成後，從右上角的省略號選單（...）中選擇部署，以將變更存回 Foundry。

在遊樂場測試工作流程

你可以用 VS Code 擴充中的遠端代理遊樂場來測試你的宣告式代理工作流程。

1. 在 VS Code 擴充套件的 「我的資源 」區塊中，找到並選擇你的 Foundry 專案。
2. 選擇 宣告式代理。
3. 選擇你想測試的工作流程版本。
4. 遠端 代理人遊樂場 面板會打開並開始與您的代理人對話。
5. 在 遠端代理遊樂場 面板底部的輸入框中，輸入訊息並按下 Enter。
6. 查看代理人的回覆。 確認回應是否符合你的工作流程中定義的動作所期望的行為。

小提示

你也可以從工具子區開啟遠端代理遊樂場，並從下拉選單中選擇你的代理。

將 YAML 工作流程轉換為 Agent Framework 程式碼

若要自訂基於 YAML 的工作流程，請使用 GitHub Copilot 將其轉換為代理框架程式碼。

1. 在 VS Code 中開啟工作流程的 YAML 檔案。
2. 選擇 YAML 編輯器右上角的 「產生程式碼 」按鈕。
3. 選擇你想用的程式語言（Python 或 C#）。 GitHub Copilot 會開啟一個包含所選語言程式碼產生提示的窗格，並根據 YAML 定義生成 Agent Framework 程式碼。
4. 當 GitHub Copilot 詢問你是否想在本地執行產生的程式碼時，請選擇 「是 」以開啟本地視覺化工具。 你可以看到代理執行的每個步驟。
5. 檢視並修改產生的程式碼以符合您的需求。
6. 右鍵點擊產生的程式碼檔案，選擇 部署到 Foundry ，將程式碼部署到你的 Foundry 專案中。
7. 在 Foundry 入口網站，前往你的專案，確認程式碼是否出現在 代理 區塊。

相關內容

• Foundry Agent 工作流程