Introducción a la extensión del agente de Microsoft Foundry

La CLI para desarrolladores de Azure (azd), la extensión de agente de Microsoft Foundry, genera el código base, aprovisiona e implementa agentes en Microsoft Foundry desde el terminal o el editor. Combina las capacidades de agente de Foundry con comandos de ciclo de vida de azd para un flujo de trabajo uniforme del entorno local a la nube. Puede pasar de un agente de ejemplo a un punto de conexión implementado y invocable con algunos comandos.

En este artículo se presenta la extensión. Para obtener instrucciones paso a paso completas, consulte la documentación de los agentes hospedados de Microsoft Foundry.

Características clave

Feature Description
Estructura de proyecto Configura proyectos de agente completos, incluida la infraestructura como plantillas de código, definiciones de agente y configuración, por lo que puede iniciar la iteración inmediatamente.
Configuración declarativa Define servicios, recursos e implementaciones de modelos en un azure.yaml archivo para entornos coherentes.
Aprovisionamiento y implementación unificados Se ejecuta azd up para compilar contenedores, insertar imágenes, crear recursos, implementar modelos y publicar el agente en un paso.
Gestión de la definición del agente Importa definiciones de agente de catálogos, GitHub o rutas de acceso locales y asigna parámetros necesarios a variables de entorno.
Seguridad predeterminada Configura las identidades administradas y la seguridad de línea de base automáticamente sin controlar las credenciales manualmente.
Aprovisionamiento de modelos escalables Especifica los nombres de modelo, las versiones y la capacidad, e los implementa de forma coherente en todos los entornos.

Exploración del flujo de trabajo

La extensión sigue un ciclo de vida conocido azd desde la generación de la estructura base hasta un agente en ejecución:

  1. Scaffolding: inicialice un proyecto de agente de ejemplo, incluida la infraestructura como código, una definición de agente y la configuración.
  2. Aprovisionamiento e implementación: cree la cuenta y el proyecto foundry, implemente modelos, compile e inserte el contenedor del agente y publique el agente.
  3. Ejecutar localmente: Itera en el agente en tu equipo local mientras te conectas a recursos remotos de Azure.
  4. Invocación y supervisión: envíe mensajes al agente implementado y transmita registros en directo.
  5. Desmontaje: quite todos los recursos aprovisionados cuando haya terminado.

Pruébelo

Pruebe a implementar un agente de ejemplo con el flujo de trabajo mínimo. En este ejemplo se usa el ejemplo básico de Agent Framework de la documentación de Microsoft Foundry.

  1. Generar la estructura base de un proyecto de ejemplo de agente en una carpeta vacía:

    azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yaml

  2. Aprovisione los recursos e implemente el agente en un paso:

    azd up

    Tip

    También puede dividir este paso en azd provision y azd deploy para obtener más control sobre cada fase.

  3. Quite todos los recursos aprovisionados cuando haya terminado:

    azd down

    Advertencia

    azd down elimina permanentemente todos los recursos del grupo de recursos. Úselo con cuidado en entornos compartidos o de producción.

Para conocer los requisitos previos, la selección de modelos, las pruebas locales y la solución de problemas, consulte Inicio rápido: Implementación del primer agente hospedado.

Cuándo usar la extensión del agente

Microsoft Foundry admite varias maneras de compilar e implementar agentes hospedados, incluido el SDK de Python, Visual Studio Code y el portal. La extensión del agente azd es la opción más adecuada cuando quieres:

  • Trabajar principalmente desde la terminal o el editor con un flujo de trabajo scriptable y repetible.
  • Administre la infraestructura y los agentes juntos mediante archivos declarativos azure.yaml y Bicep bajo control de código fuente.
  • Mueva de forma coherente de local a nube mediante los mismos azd comandos de ciclo de vida (azd init, azd up, azd down) que ya usa para otras aplicaciones de Azure.
  • Normalice las implementaciones en entornos (desarrollo, pruebas y producción) y automatice las implementaciones en CI/CD.

Para obtener una experiencia del portal guiado o crear agentes con el SDK de Python, comience con la documentación de agentes hospedados de Microsoft Foundry en su lugar.

Recursos adicionales

  • Last updated on