Usa Microsoft Foundry Skill en agentes de programación

El Microsoft Foundry Skill proporciona instrucciones reutilizables a los agentes de codificación para los flujos de trabajo del agente Foundry. Utilícela para ayudar a estandarizar la implementación, evaluación, optimización rápida, conservación de conjuntos de datos de seguimientos y tareas de solución de problemas en entornos de desarrollo habilitados para agente.

Prerequisites

  • Una cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta gratuita de Azure.

  • Un host de agente de codificación, como GitHub Copilot en Visual Studio Code, Copilot CLI o Claude Code.

  • Node.js 18 o una versión posterior en su PATH. El complemento usa npx para iniciar servidores MCP en hosts compatibles.

  • Git, por lo que el host puede descargar el complemento y el contenido de aptitudes.

  • CLI de Azure instalado y autenticado:

    az login

  • Azure Developer CLI instalado y autenticado si tiene previsto usar flujos de trabajo de implementación de azd:

    azd auth login

  • Un proyecto de Microsoft Foundry si desea que el agente inspeccione o modifique los recursos con ámbito del proyecto. Para conocer los pasos de configuración, consulte Creación de un proyecto.

Lo que ofrece la habilidad Foundry

La capacidad microsoft-foundry es una metacapacidad para el trabajo con Foundry. Ayuda a un agente de codificación a elegir el flujo de trabajo de Foundry correcto, cargar la sub-aptitud coincidente, inspeccionar las herramientas de MCP de Foundry disponibles y mantener el contexto de implementación y evaluación coherente entre turnos.

Úselo cuando desee que el agente le ayude con estas áreas de funcionalidad:

Área de funcionalidad Lo que la habilidad permite al agente hacer
Incorporación a Foundry Cree o conéctese a un proyecto foundry, aprovisione un recurso Foundry, elija una configuración pública o aislada de red y prepare el área de trabajo para el desarrollo del agente.
Acceso y capacidad Compruebe las asignaciones de RBAC, las identidades administradas, las entidades de servicio, la cuota, la disponibilidad del modelo, la capacidad de la región y los requisitos previos de implementación.
Implementación del modelo Implemente modelos con configuraciones predefinidas rápidas o ajustes personalizados, como versión, SKU, capacidad y configuración de IA responsable.
Personalización de modelos Ajuste los modelos mediante flujos de trabajo de ajuste fino supervisado, optimización directa de preferencias o ajuste fino por refuerzo.
Creación de agentes Cree aplicaciones de agente alojadas que usan Microsoft Agent Framework, LangGraph o frameworks personalizados en Python o C#.
Implementación de agentes Contenerice un agente, compile y publique imágenes en Azure Container Registry, cree o actualice implementaciones de agentes hospedados y vuelva a implementar tras realizar cambios en el código.
Invocación y pruebas Envíe mensajes de uno o varios turnos a agentes implementados, agentes de indicaciones de prueba y agentes hospedados de prueba que utilizan protocolos basados en HTTP o WebSocket.
Evaluación y optimización Ejecute evaluaciones por lotes, configure la evaluación continua, compare versiones, optimice las indicaciones, mejore las instrucciones del agente y prepare los trabajos del optimizador de agentes.
Trabajo de seguimiento y conjunto de datos Realice seguimientos de consultas, analice la latencia o los errores, ponga en correlación los resultados de evaluación con las respuestas y organice los conjuntos de datos de evaluación a partir de seguimientos de producción.
Solución de problemas Inspeccione los registros del agente hospedado, consulte la telemetría, diagnostique errores de implementación o tiempo de ejecución y planee un bucle de reparación y reimplementación.

La habilidad instalada incluye subhabilidades especializadas para esas áreas. Normalmente no es necesario asignar un nombre a la sub-aptitud directamente. Indique el resultado que desea y el agente de codificación utilizará las instrucciones de la habilidad para enrutar la tarea.

Installation

La extensión Foundry Toolkit para VS Code viene con Foundry Skill. Para instalar la extensión, consulte Trabajar con la extensión de Microsoft Foundry para Visual Studio Code.

Después de la instalación, vuelva a cargar Visual Studio Code si se le solicita. Abra Copilot Chat, cambie al modo de agente y confirme que las aptitudes de Foundry están disponibles. Cuando se le solicite, inicie sesión con la cuenta de Azure que tenga acceso al proyecto foundry.

Para obtener más información sobre la configuración de MCP en Visual Studio Code, vea Get started with the Azure MCP Server and Get started with Foundry MCP Server.

Si el host ya tiene la configuración del servidor MCP y solo necesita el contenido de la aptitud, instale la capacidad microsoft-foundry directamente:

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

La ruta exclusiva de capacidades descarga las instrucciones del flujo de trabajo de Foundry. Use el complemento Azure Skills cuando quiera instalar conjuntamente la habilidad, la configuración del servidor MCP de Azure y la configuración del servidor MCP de Foundry.

Comprobación de la configuración

Después de la instalación, pruebe estas comprobaciones desde el agente de codificación:

  • Pregunta a What AI models are available in Microsoft Foundry? La respuesta debe utilizar herramientas de Foundry en lugar de un resumen genérico.
  • Preguntar a List my Azure resource groups. La respuesta debe usar las herramientas MCP de Azure después de autenticarse.
  • En un proyecto del agente foundry, pregunte Use the Microsoft Foundry Skill to review this agent for deployment readiness. La respuesta debe identificar comprobaciones de flujo de trabajo, como la configuración, el acceso al proyecto, la implementación del modelo, los datos de evaluación y la validación de la implementación.

Si se produce un error en una comprobación, vuelva a cargar el host, confirme que el complemento se ha instalado correctamente y compruebe que az login usa la suscripción que contiene los recursos de Foundry.

Uso de la aptitud en un proyecto

Abra la carpeta que contiene el código de su agente de Foundry. Pida el resultado que desee e incluya el proyecto de destino, el entorno, la carpeta del agente o el nombre de implementación si ya lo conoce.

Usa estos patrones de prompts para invocar las funcionalidades de la habilidad:

Objetivo Mensaje de ejemplo Flujo de trabajo típico
Configuración de Foundry para un nuevo agente Use the Microsoft Foundry Skill to create a public Foundry project, deploy a model, and scaffold a hosted agent. Configuración del proyecto, implementación de modelos, creación de agentes, implementación e invocación.
Configuración de un entorno privado Use the Microsoft Foundry Skill to plan a network-isolated Foundry deployment for this project. Planeamiento de red privada, selección de plantillas, comprobaciones de implementación y validación.
Implementación de un agente hospedado existente Use the Microsoft Foundry Skill to prepare this hosted agent for deployment to my dev environment. Resolución del contexto del espacio de trabajo, compilación del contenedor, publicación en ACR, implementación de un agente hospedado y prueba de humo.
Reimplementación después de los cambios de código Use the Microsoft Foundry Skill to redeploy this agent and verify it still responds correctly. Actualización de despliegue, invocación y seguimiento de la evaluación.
Prueba un agente Use the Microsoft Foundry Skill to invoke this agent with a short multi-turn test conversation. Búsqueda e invocación del agente, y revisión de su respuesta.
Evaluación de la calidad Use the Microsoft Foundry Skill to create an evaluation plan for this agent from eval.yaml. Configuración del conjunto de evaluaciones, comprobaciones de conjuntos de datos y evaluadores, evaluación por lotes y resumen de resultados.
Instrucciones de optimización Use the Microsoft Foundry Skill to improve the agent instructions based on recent evaluation results. Análisis de evaluación, optimización rápida, revisión de candidatos y evaluación de seguimiento.
Creación de un conjunto de datos de evaluación Use the Microsoft Foundry Skill to create an evaluation dataset from the last seven days of production traces. Trazado de consultas, curación de conjuntos de datos, control de versiones y seguimiento del linaje de los datos.
Solucionar un fallo Use the Microsoft Foundry Skill to troubleshoot why this hosted agent deployment is failing. Comprobación de invocación, registros, telemetría, análisis de causa raíz, plan de reparación, reimplementación y prueba.
Comprobación del acceso o la capacidad Use the Microsoft Foundry Skill to check RBAC and quota blockers before I deploy this model. Revisión de la asignación de roles, búsqueda de cuotas, planeamiento de capacidad y pasos de corrección.
Ajuste de un modelo Use the Microsoft Foundry Skill to plan a supervised fine-tuning workflow for this training dataset. Preparación del conjunto de datos, configuración de entrenamiento, revisión de puntos de comprobación, implementación de modelos y evaluación.

Antes de aprobar los cambios o comandos, revise el plan, los archivos generados y Azure recursos que el agente propone crear o modificar. Para las tareas de implementación, ajuste y aprovisionamiento, confirme las asignaciones de roles y los recursos de costo antes de que el agente ejecute comandos.

Uso de aptitudes de Foundry Toolkit en VS Code

Foundry Toolkit para Visual Studio Code también hace que las aptitudes específicas de Foundry estén disponibles en VS Code. Estas aptitudes, como vscode-microsoft-foundry y foundrytk-quick-start, se centran en la experiencia de desarrollo de VS Code: incorporación a Foundry Toolkit, exploración de modelos, creación de agentes, selección de un modelo, implementación de un agente, evaluación del rendimiento y administración de cuadros de herramientas. Se diferencian de la competencia principal microsoft-foundry, que proporciona una base de conocimientos más amplia y detalles concretos sobre los flujos de trabajo para la administración de recursos de Foundry, RBAC, cuotas, despliegue de modelos, despliegue de agentes hospedados, evaluación, trazabilidad y solución de problemas. Instale Foundry Toolkit para VS Code para que estas aptitudes proporcionadas por la extensión estén disponibles en la experiencia del agente de VS Code.

Funcionamiento de la capacidad

Cuando un agente de codificación usa la aptitud Microsoft Foundry, sigue algunos patrones comunes:

  1. Comienza con la detección de MCP de Foundry para saber qué herramientas y parámetros de Foundry están disponibles en su entorno.
  2. Carga la subcompetencia que se ajusta a tu flujo de trabajo, como creación, despliegue, invocación, evaluación, trazabilidad, solución de problemas, RBAC, cuota o despliegue de modelos.
  3. Resuelve el contexto del proyecto y del agente del área de trabajo antes de proponer cambios o comandos.
  4. Prefiere las herramientas estructuradas de Foundry y de Azure MCP cuando estén disponibles.
  5. Solo pide los valores que faltan cuando no pueden resolverse a partir de tu solicitud, los archivos del área de trabajo o el contexto autenticado de Azure.

La capacidad admite dos tipos comunes de agente:

Tipo de agente Caso de uso
Agente de indicaciones Un agente basado en un LLM que usa un agente de implementación y la configuración de la indicación.
Agente alojado en servidor Un agente basado en contenedores que ejecuta código personalizado en el servicio foundry Agent.

Para los flujos de trabajo de agentes alojados, la habilidad también puede funcionar con agentes que utilizan los protocolos responses, invocations o invocations_ws. Se usa invocations_ws para escenarios de WebSocket en tiempo real o dúplex, como agentes de voz o interacciones de streaming.

Archivos del espacio de trabajo que usa la capacidad

La capacidad busca el proyecto de Foundry y el contexto del agente en los archivos comunes del espacio de trabajo. Mantenga estos archivos actualizados para que el agente de codificación pueda realizar recomendaciones específicas y repetibles.

Archivo o carpeta Cómo lo usa la capacidad
azure.yaml Encuentra azd servicios, carpetas de proyecto del agente, configuración del host de implementación y vinculaciones de entorno.
.azure/<environment>/.env Resuelve los valores de entorno autenticados de azd, como la suscripción, el grupo de recursos, el punto de conexión del proyecto, el nombre del agente, el registro y la cadena de conexión de Application Insights.
.foundry/agent-metadata.yaml Almacena el estado de superposición específico de Foundry, como referencias del conjunto de evaluación, referencias de conjuntos de datos, rutas de caché local, resúmenes de resultados y anulaciones no-azd.
.foundry/agent-metadata.<env>.yaml Almacena el estado de superposición específico del entorno para un destino como producción o CI.
agent.yaml Proporciona la configuración del agente local para crear, implementar, invocar y evaluar flujos de trabajo.
eval.yaml Define la intención de evaluación local, como el archivo de conjunto de datos, los nombres del evaluador, el umbral de paso, el recuento de muestras, la búsqueda de seguimiento y las instrucciones de generación.

Para los flujos de trabajo de despliegue y evaluación, prefiera .foundry/agent-metadata.yaml para el estado de superposición no secreto. No almacene secretos en .foundry archivos. Si azd ya proporciona un valor de implementación, como un punto de conexión de proyecto o un registro, deje que el agente de codificación use el azd valor en lugar de duplicarlo en metadatos.

Solución de problemas

Cuestión Resolution
El host no encuentra la capacidad. Confirme que el complemento se ha instalado correctamente y, a continuación, vuelva a cargar o reinicie el host para que vuelva a indexar el contenido del complemento.
Las herramientas de MCP no aparecen. Confirme que Node.js está instalado, npx funciona y se agregaron las entradas del servidor MCP de Azure y Foundry para el host.
Las solicitudes de Azure fallan con errores de autenticación. Vuelva a ejecutar az login . Para los flujos de trabajo de azd, ejecute también azd auth login.
El agente usa la suscripción incorrecta. Establezca la suscripción de Azure deseada en la CLI de Azure antes de volver a intentar la solicitud.
Las operaciones del proyecto Foundry devuelven un error. Confirme que su cuenta tiene acceso al proyecto Foundry y a los roles de Azure RBAC necesarios.

Contenido relacionado

  • Last updated on