Crear aplicaciones de Agent Framework con un agente de codificación

La skill del generador de Microsoft Agent Framework para .NET, agent-framework-builder-dotnet, proporciona a los agentes de codificación compatibles instrucciones mantenidas por Microsoft para crear soluciones de Agent Framework de .NET (C#). Ayuda al agente de codificación a elegir un patrón adecuado y a cargar progresivamente instrucciones centradas en la tarea.

La habilidad puede guiar el trabajo con:

  • Agentes simples, proveedores de modelos, herramientas, sesiones, historial, proveedores de contexto y middleware.
  • Aproveche agentes con tareas, modos, memoria, aprobaciones, aptitudes, agentes en segundo plano, herramientas de shell, compactación y bucles.
  • Flujos de trabajo y orquestaciones integradas y definiciones declarativas.
  • Evaluación, observabilidad, clientes personalizados, agentes personalizados e integraciones.
  • Alojamiento y despliegue.

La habilidad proporciona instrucciones de desarrollo para un agente de codificación externo. No es un paquete NuGet y no se ejecuta dentro de la aplicación Agent Framework.

Importante

Esta habilidad del agente de codificación es diferente de las habilidades del agente en tiempo de ejecución. Las habilidades en tiempo de ejecución se cargan mediante un agente de Agent Framework mientras se ejecuta la aplicación. La habilidad Builder ayuda a un agente de codificación a crear o modificar el código fuente de su aplicación.

Tip

Empareje la habilidad Builder con el servidor MCP de Microsoft Learn. La aptitud ofrece al agente de codificación una guía centrada en el flujo de trabajo y la implementación de Agent Framework, mientras que Learn MCP Server le permite buscar la documentación actual de Microsoft, obtener artículos completos y encontrar ejemplos de código durante la tarea. Configure este punto de conexión HTTP público y no autenticado streamable en un agente de codificación compatible:

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

Prerequisites

  • Agente de codificación que admite la especificación open Agent Skills.
  • GitHub CLI con los comandos preliminares gh skill, o Node.js 22.20 o posterior si usa la CLI skills entre agentes.
  • Un SDK de .NET actualmente compatible para las nuevas aplicaciones de Agent Framework.

La administración de aptitudes de GitHub CLI está en versión preliminar y está sujeta a cambios.

Revisa e instala con la CLI de GitHub

La skill de builder de .NET aún no está en una versión etiquetada, por lo que debe especificar la referencia @main. Previsualice la skill antes de instalarla:

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

Instale la aptitud:

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

La instalación predeterminada tiene ámbito de proyecto y está dirigida a GitHub Copilot para uso no interactivo. Seleccione otro agente de codificación compatible o un ámbito de usuario cuando lo necesite:

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

Para conocer las opciones actuales de cliente y ámbito, consulte gh skill install.

Instala con la CLI de skills cross-agent

Como alternativa, instale la skill con la CLI cross-agent skills:

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

Revise los requisitos de tiempo de ejecución y los agentes de codificación admitidos de la CLI antes de la instalación.

Usar la aptitud

Indique al agente de codificación con naturalidad. Los clientes compatibles detectan y activan la aptitud desde sus metadatos; no dé por hecho que exista un comando de barra diagonal universal.

Ejemplos de instrucciones:

  • 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.

Incluya restricciones como el proveedor de modelos, el destino de hospedaje, los requisitos de persistencia, el límite de seguridad y la versión de .NET de destino cuando los conozca.

Qué debe hacer el agente de codificación

La aptitud indica al agente de codificación que:

  • Inspeccione la solución existente, incluidos los marcos de destino, la versión del SDK, la administración de paquetes y los paquetes instalados Microsoft.Agents.AI.* .
  • Elija el patrón adecuado más pequeño, como un agente simple, un armazón, un flujo de trabajo, una orquestación o una definición declarativa.
  • Cargue únicamente las referencias centradas pertinentes.
  • Agregue solo el conjunto estrecho de paquetes que necesita la aplicación y compruebe la madurez de cada paquete antes de depender de él, ya que algunos paquetes son versión preliminar.
  • Lea puntos de conexión, modelos y claves de la configuración y prefiera las credenciales de token en lugar de las claves de API codificadas de forma rígida.
  • Valide la aplicación generada con las pruebas existentes del repositorio y ejemplos ejecutables.

La aptitud no garantiza que el código generado esté listo para producción. Revise el plan del agente de codificación, las opciones de paquete, los límites de seguridad, los comandos y los cambios generados antes de la aprobación.

Control de versiones y confianza

La skill es una skill de consumidor pública, instalable y mantenida por Microsoft. Su versión de metadatos de habilidad es 0.1.

  • Use la referencia @main hasta que una versión etiquetada incluya la aptitud.
  • Ver el contenido de la skill antes de instalarla y revisar las actualizaciones antes de confiar en nuevos scripts o instrucciones.

Para el origen y las referencias centradas, vea:

Pasos siguientes

Creación del primer agente

Vaya más profundamente:

La aptitud del generador de Microsoft Agent Framework para Python, agent-framework-builder-python, proporciona a los agentes de codificación compatibles una guía mantenida por Microsoft para crear soluciones de Python Agent Framework. Ayuda al agente de codificación a elegir un patrón adecuado y a cargar progresivamente instrucciones centradas en la tarea.

La habilidad puede guiar el trabajo con:

  • Agentes simples, proveedores de modelos, herramientas, aprobaciones, sesiones, historial y proveedores de contexto.
  • Aproveche los agentes con planificación, tareas, memoria, compactación, archivos, agentes en segundo plano, herramientas de shell y bucles.
  • Flujos de trabajo funcionales y de grafos, orquestaciones integradas y definiciones declarativas.
  • Evaluación, observabilidad, middleware, clientes personalizados, agentes personalizados e integraciones.
  • Desarrollo de agentes hospedados en Microsoft Foundry y autohospedados.

La aptitud solo está disponible para Python. Proporciona instrucciones de desarrollo para un agente de codificación externo; no es un paquete de Python, no lo instala pip install agent-frameworky no se ejecuta dentro de la aplicación Agent Framework.

Importante

Esta habilidad del agente de codificación es diferente de las habilidades del agente en tiempo de ejecución. Las habilidades en tiempo de ejecución se cargan mediante un agente de Agent Framework mientras se ejecuta la aplicación. La habilidad Builder ayuda a un agente de codificación a crear o modificar el código fuente de su aplicación.

Tip

Empareje la habilidad Builder con el servidor MCP de Microsoft Learn. La aptitud ofrece al agente de codificación una guía centrada en el flujo de trabajo y la implementación de Agent Framework, mientras que Learn MCP Server le permite buscar la documentación actual de Microsoft, obtener artículos completos y encontrar ejemplos de código durante la tarea. Configure este punto de conexión HTTP público y no autenticado streamable en un agente de codificación compatible:

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

Prerequisites

  • Agente de codificación que admite la especificación open Agent Skills.
  • GitHub CLI con los comandos preliminares gh skill, o Node.js 22.20 o posterior si usa la CLI skills entre agentes.
  • Python 3.11 o posterior. Agent Framework 1.24 ya no admite ni prueba Python 3.10, aunque los metadatos del paquete todavía permiten la instalación.

La administración de aptitudes de GitHub CLI está en versión preliminar y está sujeta a cambios.

Revisa e instala con la CLI de GitHub

Previsualice la skill publicada antes de instalarla:

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

Instale la versión etiquetada más reciente:

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

Fije la versión 1.23 de Python cuando necesite orientación reproducible:

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

La instalación predeterminada tiene ámbito de proyecto y está dirigida a GitHub Copilot para uso no interactivo. Seleccione otro agente de codificación compatible o un ámbito de usuario cuando lo necesite:

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

Para conocer las opciones actuales de cliente y ámbito, consulte gh skill install.

Instala con la CLI de skills cross-agent

Como alternativa, instale la skill con la CLI cross-agent skills:

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

Revise los requisitos de tiempo de ejecución y los agentes de codificación admitidos de la CLI antes de la instalación.

Usar la aptitud

Indique al agente de codificación con naturalidad. Los clientes compatibles detectan y activan la aptitud desde sus metadatos; no dé por hecho que exista un comando de barra diagonal universal.

Ejemplos de instrucciones:

  • 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.

Incluya restricciones como el proveedor de modelos, el destino de hospedaje, los requisitos de persistencia, el límite de seguridad y la versión admitida Python cuando los conozca.

Qué debe hacer el agente de codificación

La aptitud indica al agente de codificación que:

  • Elija el patrón adecuado más pequeño, como un agente simple, un armazón, un flujo de trabajo, una orquestación o una definición declarativa.
  • Cargue únicamente las referencias centradas pertinentes.
  • Prefiere las instrucciones actuales de Microsoft Learn, las referencias de API públicas, la información del ciclo de vida del paquete y los ejemplos mantenidos para detalles sujetos a cambios.
  • Instale conjuntos reducidos de paquetes en lugar de asumir que cada integración es estable o necesaria.
  • Conserve los límites explícitos de sesión, aprobación, autenticación y hospedaje.
  • Valide la aplicación generada con las pruebas existentes del repositorio, las comprobaciones de tipos y los ejemplos ejecutables.

La aptitud no garantiza que el código generado esté listo para producción. Revise el plan del agente de codificación, las opciones de paquete, los límites de seguridad, los comandos y los cambios generados antes de la aprobación.

Control de versiones y confianza

La skill es una skill pública, instalable y mantenida por Microsoft para consumidores, lanzada con la etiqueta del repositorio python-1.23.0. Su versión de metadatos de habilidad es 0.3.

  • Use el comando de instalación sin cualificar para la última versión etiquetada.
  • Fijar @python-1.23.0 cuando la reproducibilidad es importante.
  • Use @main solo cuando desee intencionadamente la guía no publicada.
  • Ver el contenido de la skill antes de instalarla y revisar las actualizaciones antes de confiar en nuevos scripts o instrucciones.

Para el origen y las referencias centradas, vea:

Pasos siguientes

Creación del primer agente

Vaya más profundamente:

Note

Todavía no hay disponible una aptitud del generador de Microsoft Agent Framework para Go. Usa el tutorial de introducción de Go y los ejemplos de Agent Framework Go para obtener instrucciones actuales.

  • Se actualizó por última vez el