用程式設計代理建立 Agent Framework 應用程式

適用於 .NET 的 Microsoft Agent Framework builder skill,agent-framework-builder-dotnet為相容的編碼代理程式提供由 Microsoft 維護的 .NET(C#)代理框架解決方案建置指引。 它幫助編碼代理選擇適當的模式,並逐步載入針對任務的指引。

這項技能可以用於下列工作:

  • 純代理、模型提供者、工具、會話、歷史、上下文提供者與中介軟體。
  • 利用 todos、模式、記憶體、審批、技能、背景代理、shell 工具、壓縮和迴圈來運用代理。
  • 工作流程、內建的協調流程,以及宣告式定義。
  • 評估、可觀察性、自訂客戶端、客製化代理與整合。
  • 託管與部署。

此技能為外部編碼代理提供開發指導。 它不是 NuGet 套件,也不會在你的 Agent Framework 應用程式中執行。

Important

這個編碼代理技能與 執行時的代理技能不同。 執行時技能會由 Agent Framework 代理程式載入,當你的應用程式執行時。 建構者技能幫助程式代理建立或修改你的應用程式原始碼。

Tip

將建構技能與 Microsoft Learn MCP Server 結合使用。 此技能為編碼代理提供專注的 Agent Framework 工作流程與實作指引,而學習 MCP 伺服器則能在任務中搜尋最新的 Microsoft 文件、擷取完整文章,並尋找程式碼範例。 請以相容的程式設計代理配置這個公開且未經驗證的 Streamable HTTP 端點:

https://learn.microsoft.com/api/mcp

Prerequisites

  • 支援開放式 Agent Skills specification 的程式碼代理。
  • GitHub CLI 搭配預覽 gh skill 指令,或 Node.js 22.20 或更新版本,若使用跨代理程式 skills CLI。
  • 適用於新 Agent Framework 應用程式的目前支援 .NET SDK。

GitHub CLI 技能管理目前處於預覽階段,可能會有變動。

使用 GitHub CLI 審閱並安裝

.NET 建構技能還沒有在已標記的發行版本中,因此你需要指定 @main ref。安裝前先預覽該技能:

gh skill preview microsoft/agent-framework agent-framework-builder-dotnet@main

安裝技能項目:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main

預設安裝以專案為範圍,並以非互動式使用 GitHub Copilot 為目標。 必要時選擇其他支援的程式碼代理或使用者範圍:

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-dotnet@main \
  --agent codex

關於目前的客戶及範圍選項,請參見 gh skill install。

使用 cross-agent skills CLI 安裝

作為替代方案,請使用跨代理 skills CLI 安裝此技能:

npx skills add microsoft/agent-framework --skill agent-framework-builder-dotnet

安裝前請檢視 CLI 支援的 程式碼代理 程式及執行時需求。

使用技能

自然地向程式設計代理下達提示。 相容客戶端會從其中繼資料中發現並啟用該技能;不要假設這是通用的斜線指令。

範例提示:

  • Build a .NET Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
  • Add approval-required tools and persistent conversation history to this Agent Framework application.
  • Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
  • Create a harness agent with todos, file access, and safe shell tooling.
  • Review this .NET Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for hosting in ASP.NET Core and add an evaluation plan.

包含限制條件,例如模型提供者、主機目標、持久性要求、安全邊界,以及目標 .NET 版本(如果你知道這些資訊)。

編碼代理應該做什麼

此技能指示程式碼代理執行下列操作:

  • 檢查現有解決方案,包括目標框架、SDK 版本、套件管理及已安裝 Microsoft.Agents.AI.* 套件。
  • 選擇最小且合適的模式,例如純代理、框架、工作流程、編排或宣告式定義。
  • 只載入相關且目前焦點的參考資料。
  • 只加入應用程式所需的狹窄套件集合,並在依賴前檢查每個套件的成熟度,因為有些套件是預發布的。
  • 從設定讀取端點、模型和金鑰,並優先使用權杖憑證,而非硬編碼的 API 金鑰。
  • 用儲存庫現有的測試和可執行的範例來驗證所產生的應用程式。

這項技能並不保證生成的程式碼就已可用於正式環境。 在核准前,請審查程式碼代理的計畫、套件選擇、安全邊界、指令及已產生的變更。

版本控制與信任

這項技能是一項公開、可安裝、由 Microsoft 維護的消費者技能。 其技能元資料版本為 0.1。

  • 在已標記的版本包含該 skill 之前,先使用 @main ref。
  • 安裝前先預覽技能內容,並在信任新腳本或新指示前檢視更新。

關於來源及重點參考,請參見:

下一步

深入探討:

Microsoft Agent Framework 建置技能(Python)agent-framework-builder-python為相容的程式碼代理提供 Microsoft 維護的 Python Agent Framework 解決方案建置指引。 它幫助編碼代理選擇適當的模式,並逐步載入針對任務的指引。

這項技能可以用於下列工作:

  • 一般代理程式、模型提供者、工具、核准、會話、歷史與上下文提供者。
  • 利用規劃、待辦事項、記憶、精簡、檔案、背景代理、shell 工具和迴圈來運用代理。
  • 函數式與圖形工作流程、內建編排與宣告式定義。
  • 評估、可觀察性、中介軟體、自訂客戶端、客製化代理程式與整合。
  • 自架與 Microsoft Foundry 託管代理程式開發。

這個技能僅限 Python。 它為外部編碼代理提供開發指導;它不是 Python 套件,也不是由 pip install agent-framework安裝,也不會在你的 Agent Framework 應用程式中執行。

Important

這個編碼代理技能與 執行時的代理技能不同。 執行時技能會由 Agent Framework 代理程式載入,當你的應用程式執行時。 建構者技能幫助程式代理建立或修改你的應用程式原始碼。

Tip

將建構技能與 Microsoft Learn MCP Server 結合使用。 此技能為編碼代理提供專注的 Agent Framework 工作流程與實作指引,而學習 MCP 伺服器則能在任務中搜尋最新的 Microsoft 文件、擷取完整文章,並尋找程式碼範例。 請以相容的程式設計代理配置這個公開且未經驗證的 Streamable HTTP 端點:

https://learn.microsoft.com/api/mcp

Prerequisites

  • 支援開放式 Agent Skills specification 的程式碼代理。
  • GitHub CLI 搭配預覽 gh skill 指令,或 Node.js 22.20 或更新版本,若使用跨代理程式 skills CLI。
  • 針對新的代理框架應用程式,使用 Python 3.11 或更新版本。 Agent Framework 1.23 仍支援 Python 3.10,但 Python 3.10 已達到上游終止生命週期。

GitHub CLI 技能管理目前處於預覽階段,可能會有變動。

使用 GitHub CLI 審閱並安裝

安裝前先預覽已發佈的技能:

gh skill preview microsoft/agent-framework agent-framework-builder-python@python-1.23.0

安裝最新標籤版本:

gh skill install microsoft/agent-framework agent-framework-builder-python

當你需要可重現的指引時,請先固定 Python 1.23 版本:

gh skill install microsoft/agent-framework agent-framework-builder-python@python-1.23.0

預設安裝以專案為範圍,並以非互動式使用 GitHub Copilot 為目標。 必要時選擇其他支援的程式碼代理或使用者範圍:

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent claude-code \
  --scope user

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent cursor

gh skill install microsoft/agent-framework agent-framework-builder-python \
  --agent codex

關於目前的客戶及範圍選項,請參見 gh skill install。

使用 cross-agent skills CLI 安裝

作為替代方案,請使用跨代理 skills CLI 安裝此技能:

npx skills add microsoft/agent-framework --skill agent-framework-builder-python

安裝前請檢視 CLI 支援的 程式碼代理 程式及執行時需求。

使用技能

自然地向程式設計代理下達提示。 相容客戶端會從其中繼資料中發現並啟用該技能;不要假設這是通用的斜線指令。

範例提示:

  • Build a Python Agent Framework agent with Microsoft Foundry, function tools, sessions, and tests.
  • Add approval-required tools and persistent conversation history to this Agent Framework application.
  • Convert this multi-agent design into an Agent Framework workflow and add checkpointing.
  • Create a harness agent with planning, todos, file access, and safe shell tooling.
  • Review this Python Agent Framework application for current APIs and package requirements.
  • Prepare this Agent Framework agent for Foundry hosting and add an evaluation plan.

包含限制條件,例如模型提供者、主機目標、持久性要求、安全邊界,以及支援的 Python 版本(如果已知)。

編碼代理應該做什麼

此技能指示程式碼代理執行下列操作:

  • 選擇最小且合適的模式,例如純代理、框架、工作流程、編排或宣告式定義。
  • 只載入相關且目前焦點的參考資料。
  • 偏好目前的 Microsoft Learn 指引、公開 API 參考、套件生命週期資訊,以及維護中的範例,以取得經常變動的詳細資訊。
  • 安裝精簡的套件集,而不是假設每個整合都是穩定或必需的。
  • 保持明確的會話、核准、認證和主機邊界。
  • 用儲存庫現有的測試、型別檢查和可執行的樣本來驗證所產生的應用程式。

這項技能並不保證生成的程式碼就已可用於正式環境。 在核准前,請審查程式碼代理的計畫、套件選擇、安全邊界、指令及已產生的變更。

版本控制與信任

此技能是一項公開、可安裝、由 Microsoft 維護的消費者技能,並以 python-1.23.0 repository 標籤釋出。 其技能元資料版本為 0.3。

  • 使用未限定的 install 指令來安裝最新的已標記發行版本。
  • 當重現性很重要時,請釘選@python-1.23.0。
  • 只有在你有意想要未發布指引時才使用 @main 。
  • 安裝前先預覽技能內容,並在信任新腳本或新指示前檢視更新。

關於來源及重點參考,請參見:

下一步

深入探討:

Note

適用於 Go 的 Microsoft Agent Framework builder 技能尚未開放。 請參考 Go 入門教學 和 Agent Framework Go 範例 作為目前的指引。