agent-framework-builder-dotnet
为兼容的编码代理提供由 Microsoft 维护的指导,用于构建 .NET(C#)Agent Framework 解决方案。
它可帮助代码代理选择适当的模式,并逐步加载针对任务的有针对性的指导。
该技能可指导处理以下内容:
- 普通代理、模型提供程序、工具、会话、历史记录、上下文提供程序和中间件。
- 为智能体配备待办事项、模式、记忆、批准、技能、后台智能体、Shell 工具、压缩和循环功能。
- 工作流和内置编排以及声明性定义。
- 评估、可观测性、自定义客户端、自定义代理和集成。
- 托管和部署。
该技能为外部编码代理提供开发指南。 它不是 NuGet 包,也不会在 Agent Framework 应用程序中运行。
Important
此编码代理技能不同于 运行时代理技能。 运行时技能在应用程序运行时由 Agent Framework 代理加载。 构建器技能可帮助编码代理创建或修改应用程序源代码。
Tip
将生成器技能与 Microsoft Learn MCP 服务器配对。 该技能提供以编码代理为中心的 Agent Framework 工作流和实现指南,而 Learn MCP 服务器则允许它在任务期间搜索当前Microsoft文档、提取完整文章和查找代码示例。 在兼容的编码代理中配置此公共的、未经身份验证的 Streamable HTTP 终结点:
https://learn.microsoft.com/api/mcp
先决条件
- 支持开放 代理技能规范的编码代理。
- 带有预览
skills命令的 GitHub CLI,或者如果使用跨代理gh skillCLI,则需 Node.js 22.20 或更高版本。 - 适用于新 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。
使用跨代理技能 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.
- 在包含该技能的带标签发行版推出之前,请使用
@main引用。 - 在安装之前预览技能内容,并在信任新脚本或说明之前查看更新。
有关源引用和重点参考资料,请参阅:
后续步骤
更深入:
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 服务器配对。 该技能提供以编码代理为中心的 Agent Framework 工作流和实现指南,而 Learn MCP 服务器则允许它在任务期间搜索当前Microsoft文档、提取完整文章和查找代码示例。 在兼容的编码代理中配置此公共的、未经身份验证的 Streamable HTTP 终结点:
https://learn.microsoft.com/api/mcp
先决条件
- 支持开放 代理技能规范的编码代理。
- 带有预览
skills命令的 GitHub CLI,或者如果使用跨代理gh skillCLI,则需 Node.js 22.20 或更高版本。 - Python 3.11 或更高版本。 代理框架 1.24 不再支持或测试 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。
使用跨代理技能 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 存储库标签中发布。 其技能元数据版本为 0.3.
- 将不带限定符的 install 命令用于最新标记的版本。
- 当可重现性很重要时,固定显示
@python-1.23.0。 - 仅当有意想要未发布的指南时使用
@main。 - 在安装之前预览技能内容,并在信任新脚本或说明之前查看更新。
有关源引用和重点参考资料,请参阅:
后续步骤
更深入:
Note
尚未提供适用于 Go 的 Microsoft Agent Framework 生成器技能。 使用 Go 入门教程 和 Agent Framework Go 示例,以获取最新指引。