使用编码代理构建 Agent Framework 应用

Note

.NET的Microsoft代理框架生成器技能尚不可用。在跟踪.NET builder-skill work期间，请使用.NET 入门教程和.NET 示例。

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 skill CLI，则需 Node.js 22.20 或更高版本。
新的 Agent Framework 应用程序需要 Python 3.11 或更高版本。代理框架 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。

使用跨代理技能 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 。
在安装之前预览技能内容，并在信任新脚本或说明之前查看更新。

有关源引用和重点参考资料，请参阅：

后续步骤

创建第一个代理

更深入：