Deploy agent to Azure

Importante

Debe formar parte del programa de versión preliminar de Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier le conecta directamente con las innovaciones de inteligencia artificial más recientes de Microsoft. Las versiones preliminares de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Dado que estas características siguen en desarrollo, su disponibilidad y funcionalidades pueden cambiar con el tiempo.

Ha creado el agente y lo ha probado localmente: ahora es el momento de llevarlo a la vida en la nube. Este paso es opcional y se puede saltar si ya has desplegado tu agente en alguna nube (ni siquiera tiene que ser Azure).

Esta guía le guía a través de la implementación del código del agente en Azure y su publicación en el Centro de administración de Microsoft, donde se convierte en un activo reconocible para su organización.

También hay recursos disponibles para mostrar cómo puedes actualizar el endpoint de mensajería si, en lugar de Azure, ya has desplegado tu agente a otros proveedores de nube como AWS o GCP:

• Utiliza código de agente desplegado en AWS
• Utiliza el código del agente desplegado en GCP

Prerrequisitos

Antes de comenzar, asegúrese de que tiene lo siguiente:

Cuentas y permisos requeridos

• Suscripción Azure con acceso de contribuyente.
• Código de agente trabajando con un punto final de mensajería válido y accesible. Por favor, asegúrate de haber probado esto localmente y verifica que el código del agente pueda construirse y ejecutarse.
• Completa el paso de configuración del plano del agente para tener un plano válido del agente.
• Asegúrate de que los archivos a365.config.jsona365.generated.config.json de configuración y el archivo de configuración en el código (por ejemplo, el archivo .env) estén actualizados.

Herramientas necesarias

• CLI de Azure instalada y autenticada (Instalar CLI de Azure)
• CLI de A365 instalada (CLI de Agent 365)

Implementación en Azure

El a365 deploy comando despliega tu agente en la aplicación web de Azure creada durante la configuración. Esto sube tu código de agente a Azure, poniéndolo disponible para ejecutarlo en la nube y gestionar cualquier solicitud agente a ese endpoint.

Implementar agente

Ejecute el comando de implementación:

a365 deploy

Nota:

a365 deploy -h muestra todas las opciones para ejecutar este comando, incluidos los subcomandos.

.NET

Comando de implementación para agentes de .NET:

• Detecta archivos de proyecto de .NET (*.csproj, *.fsprojo *.vbproj)
• Restaura paquetes NuGet mediante dotnet restore
• Publica la aplicación mediante dotnet publish con la configuración de la versión
• Crea un manifiesto Oryx con el comando DLL de punto de entrada (por ejemplo, dotnet YourApp.dll)
• Configura el runtime de Azure en función de la versión de .NET detectada (valor predeterminado: DOTNET|8.0)
• Implementaciones mediante zip con progreso en tiempo real

Python

Comando de implementación para agentes de Python:

• Detecta la estructura del proyecto de Python (archivos pyproject.toml, requirements.txt y *.py)
• Compila paquetes mediante uv build si pyproject.toml existe
• Convierte .env en configuración de aplicación de Azure automáticamente
• Detección de inicio inteligente: busca puntos de entrada de Agent 365.
• Configura el entorno de ejecución de Azure para PYTHON|3.11
• Implementaciones mediante zip con progreso en tiempo real

Node.js

El comando de implementación para agentes de Node.js:

• Detecta la estructura del proyecto de Node.js (archivo package.json)
• Instala las dependencias mediante npm ci (vuelve a npm install si es necesario)
• Ejecuta el script de compilación (npm run build) si se define en package.json
• Copia los archivos de aplicación: salida compilada (distribución/compilación) o archivos de código fuente
• Copias node_modules para la implementación en Azure
• Crea un manifiesto de Oryx con el comando de inicio desde package.json (o detecta el punto de entrada)
• Configura el runtime de Azure en función de la versión de Node detectada (valor predeterminado: NODE|18)
• Implementaciones mediante zip con progreso en tiempo real

Advertencia

Administración de secretos: al implementar, las variables de entorno (incluidas las claves de API y los secretos) se almacenan como configuración de aplicación de Azure. Aunque las variables de entorno se usan normalmente para la configuración, se almacenan en texto sin formato. Para entornos de producción, Microsoft recomienda usar Azure Key Vault para secretos confidenciales. Para obtener más información, consulte Almacenamiento seguro de secretos de aplicaciones en desarrollo en ASP.NET Core y Proveedor de configuración de Azure Key Vault. Nunca confirme archivos .env con información confidencial en el control de código fuente.

Comprobación de la implementación

Una vez completada la implementación:

1. Navegue hasta su aplicación web en Azure Portal
2. Vaya a Configuración>Configuración para comprobar la configuración de la aplicación
3. Comprobar los registros de implementación en el Centro de implementación

Pasos siguientes

A continuación, publica tu aplicación de agente en Microsoft Admin Center para que las instancias de agentes y los usuarios puedan crearse desde él: Publicar el agente en Microsoft Admin Center

Tu agente está ahora en la nube y listo para responder a las solicitudes del agente. Mientras tu agente gestiona solicitudes reales, considera estos siguientes pasos en tu código:

• Supervisar el rendimiento: use características de observabilidad para realizar un seguimiento del comportamiento del agente y optimizar las respuestas
• Agregar más herramientas: explore el catálogo de herramientas para expandir las funcionalidades del agente
• Iterar y mejorar: actualice el código del agente, vuelva a implementar y vuelva a publicar (recuerde incrementar el número de versión).
• Escalar en toda su organización: comparta las historias de éxito del agente para impulsar la adopción