在程式設計代理程式中使用 Microsoft Foundry Skill

Microsoft Foundry 技能為編碼代理提供可重複使用的 Foundry 代理工作流程指引。 使用它來協助在支援代理的開發環境中，將部署、評估、提示詞最佳化、根據追蹤記錄整理資料集，以及疑難排解等工作加以標準化。

先決條件

  • 一個有有效訂閱的 Azure 帳號。 如果您沒有帳戶，請 建立免費的 Azure 帳戶。

  • 程式碼代理主機，例如 Visual Studio Code 中的 GitHub Copilot、Copilot CLI 或 Claude Code。

  • 您的 上的 PATH 18 或更新版本。 外掛程式使用npx在相容主機上啟動 MCP 伺服器。

  • Git，讓主機可以下載外掛和技能內容。

  • Azure CLI安裝並驗證：

    az login

  • 若你打算使用 部署工作流程，請先安裝並完成驗證 azd：

    azd auth login

  • 如果你想讓代理程式檢查或修改專案範圍的資源，可以使用 Microsoft Foundry 專案。 關於設定步驟，請參見 「建立專案」。

Foundry 技能提供的功能

這個 microsoft-foundry 技能是鑄造廠工作中的一個元技能。 它幫助程式代理選擇合適的 Foundry 工作流程、載入匹配的子技能、檢視可用的 Foundry MCP 工具，並保持部署與評估上下文在各回合間的一致性。

當您希望代理程式協助處理以下能力範疇時，請使用它：

能力領域 技能幫助代理人做什麼
Foundry 上線 建立或連接 Foundry 專案，提供 Foundry 資源，選擇公開或網路隔離的設置，並為代理開發準備工作空間。
存取與容量 檢查 RBAC 指派、管理身份、服務主體、配額、模型可用性、區域容量及部署前置條件。
模型部署 部署具備快速預設或自訂設定的模型，如版本、SKU、容量及負責任的 AI 配置。
模型自訂 透過監督式微調、直接偏好優化或強化微調工作流程來微調模型。
代理程式建立 建立使用 Microsoft Agent Framework、LangGraph，或以 Python 或 C# 自訂框架的託管代理應用程式。
代理程式部署 容器化代理程式，建置並推送映像檔至 Azure Container Registry，建立或更新託管代理部署，並在程式碼變更後重新部署。
召喚與測試 向已部署的代理發送單回合或多回合訊息，測試提示代理，以及測試使用 HTTP 或 WebSocket 協定的託管代理。
評估與優化 執行批次評估、設定持續評估、比較版本、優化提示、改進代理指令，並準備代理優化器工作。
追蹤與資料集工作 查詢追蹤、分析延遲或失敗、將評估結果與回應相關聯，並從生產痕跡中整理評估資料集。
Troubleshooting 檢查託管代理日誌、查詢遙測、診斷部署或執行時故障，並規劃修復與重新部署循環。

內建的技能包含針對這些領域的專門子技能。 通常不需要直接命名子技能。 提出你想要的結果，程式代理會用技能指示來分配任務。

Installation

VS Code 的 Foundry 工具包擴充套件隨附 Foundry 技能。 若要安裝擴充功能，請參閱 使用 Microsoft Foundry for Visual Studio Code 擴充功能。

安裝完成後，如有提示，請重新載入 Visual Studio Code。 打開 Copilot Chat，切換到特工模式，確認 Foundry 技能是否可用。 當被要求時，請使用擁有 Foundry 專案存取權限的 Azure 帳號登入。

欲了解更多關於 Visual Studio Code 中 MCP 設定的資訊，請參見 開始使用 Azure MCP Server 以及 Get started with Foundry MCP Server。

僅安裝 Foundry Skill

如果你的主機已經有 MCP 伺服器設定，而你只需要技能內容，請直接安裝 microsoft-foundry 技能：

npx skills add https://github.com/microsoft/azure-skills --skill microsoft-foundry

僅技能路徑會下載 Foundry 工作流程指引。 當你想同時安裝技能、Azure MCP 伺服器設定和 Foundry MCP Server 設定時，請使用 Azure Skills 插件。

確認設定

安裝完成後，請透過你的程式設計代理嘗試執行以下檢查：

  • 詢問 What AI models are available in Microsoft Foundry? 回答應該使用 Foundry 工具，而非通用摘要。
  • 詢問 List my Azure resource groups. 驗證後，回應應該使用 Azure MCP 工具。
  • 在 Foundry 代理專案中，請問 Use the Microsoft Foundry Skill to review this agent for deployment readiness. 回應應指出工作流程檢查，如設定、專案存取、模型部署、評估資料及部署驗證。

如果檢查失敗，請重新載入主機，確認外掛已成功安裝，並確認是否 az login 使用包含你 Foundry 資源的訂閱。

在專案中運用這項技能

打開包含你 Foundry 代理代碼的資料夾。 詢問你想要的結果，並包含目標專案、環境、代理資料夾或部署名稱（如果你已經知道的話）。

利用以下提示模式來啟動該技能的能力：

目標 範例提示 典型工作流程
為新的代理程式設定 Foundry Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. 專案設定、模型部署、代理程式建立、部署及叫用。
建立一個私人環境 Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. 私有網路規劃、範本選擇、部署檢查與驗證。
部署現有的託管代理 Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. 工作區上下文解析、容器建置、ACR 推送、託管代理部署，以及煙霧測試。
程式碼變更後重新部署 Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. 部署更新、叫用和評估後續追蹤。
測試代理程式 Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. Agent 查找、叫用與回覆審查。
評估品質 Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. 評估套件設定、資料集與評估器檢查、批次評估及結果摘要。
優化指令 Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. 評估分析、提示最佳化、候選人審查及後續評估。
建立評估資料集 Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. 追蹤查詢、資料集整理、版本管理與血統追蹤。
疑難排解失敗 Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. 呼叫檢查、日誌、遙測、根本原因分析、修復計畫、重新部署及重新測試。
檢查存取權或容量 Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. 角色分配審查、配額查詢、容量規劃及補救步驟。
微調模型 Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. 資料集準備、訓練設置、檢查點審查、模型部署與評估。

在核准變更或指令前，先檢視計畫、產生的檔案，以及代理程式擬建或修改的 Azure 資源。 對於部署、微調與配置任務，請在代理執行指令前確認角色指派及成本相關資源。

在 VS Code 中使用 Foundry Toolkit 技能

Foundry Toolkit for Visual Studio Code 也提供 Foundry 專屬技能於 VS Code 中。 這些技能，如 vscode-microsoft-foundry 和 foundrytk-quick-start，著重於 VS Code 開發經驗：導入 Foundry 工具包、探索模型、建立代理程式、選擇模型、部署代理程式、評估效能及管理工具箱。 它們與核心 microsoft-foundry 技能不同，核心技能提供更廣泛的知識基礎與具體工作流程細節，涵蓋 Foundry 資源管理、RBAC、配額、模型部署、託管代理部署、評估、追蹤及故障排除。 安裝 Foundry Toolkit for VS Code，讓你的 VS Code 代理體驗中能使用這些擴充套件提供的技能。

技能運作原理

當程式代理使用 Microsoft Foundry 技能時，會遵循幾個常見模式：

  1. 它從 Foundry MCP 發現開始，這樣它就能知道你環境中有哪些 Foundry 工具和參數可用。
  2. 它載入與你工作流程相符的子技能，例如建立、部署、調用、評估、追蹤、故障排除、RBAC、配額或模型部署。
  3. 它會在提出變更或指令前，先從你的工作空間解析專案和代理的上下文。
  4. 它偏好結構化的 Foundry 和 Azure MCP 工具（如果有的話）。
  5. 只有在無法從你的提示、工作區檔案或已驗證的 Azure 內容判定缺少的值時，它才會要求你提供這些值。

此技能支援兩種常見的代理人類型：

代理人類型 應用案例
提示 Agent 一個以 LLM 為基礎的代理，採用模型部署與提示設定。
託管代理 一個基於容器的代理程式，能在 Foundry Agent Service 中執行自訂程式碼。

對於託管代理的工作流程，這項技能也能適用於使用 responses、 invocations或 invocations_ws 協定的代理。 將 invocations_ws 用於即時或雙向 WebSocket 場景，例如語音代理或串流互動。

技能使用的工作區檔案

這項技能會在常見的工作區檔案中尋找 Foundry 專案與代理的上下文。 保持這些檔案的最新狀態，讓你的程式設計師能提出具體且可重複的建議。

檔案或資料夾 技能如何使用它
azure.yaml 尋找 azd 服務、代理專案資料夾、部署主機設定、環境綁定，以及建立、部署、呼叫與評估工作流程的本地代理設定。
.azure/<environment>/.env 解析已通過驗證的 azd 環境值，例如訂閱、資源群組、專案端點、代理程式名稱、登錄，以及 Application Insights 連線字串。
.foundry/agent-metadata.yaml 儲存 Foundry 特定的疊加狀態，例如評估套件參照、資料集參照、本機快取路徑、結果摘要，以及非azd覆寫。
.foundry/agent-metadata.<env>.yaml 儲存針對生產環境或 CI 等目標的環境專屬疊加狀態。
eval.yaml 定義局部評估意圖，例如資料集檔案、評估器名稱、通過閾值、樣本計數、追蹤回溯及產生指令。

對於部署與評估工作流程中的非機密覆蓋狀態，建議優先使用 .foundry/agent-metadata.yaml。 不要把秘密存進 .foundry 檔案裡。 如果 azd 已經提供部署值，例如專案端點或登錄檔，讓編碼代理使用該 azd 值，而非在元資料中重複。

Troubleshooting

Issue Resolution
主機找不到技能。 確認外掛成功安裝，然後重新載入或重啟主機，讓它重新索引外掛內容。
MCP 工具不顯示。 確認 Node.js 已安裝、npx 正常運作，且你的主機已新增 Azure 和 Foundry MCP 伺服器條目。
Azure 請求會因認證錯誤而失敗。 再次執行 az login。 對於 azd 工作流程，也請執行 azd auth login。
客服使用了錯誤的訂閱。 在重新嘗試提示前，先在 Azure CLI 設定預期的 Azure 訂閱。
鑄造廠專案運作失敗。 確認你的帳號是否能存取 Foundry 專案及所需的 Azure RBAC 角色。

相關內容

  • Last updated on