Compartir a través de

Implementar y publicar agentes

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. Desplegar y publicar tu agente lo pone a disposición en toda tu organización, permitiendo a los equipos descubrir, crear instancias de agentes e interactuar con él a través de Microsoft 365.

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.

Información general

El proceso de implementación y publicación implica dos pasos clave:

  1. Desplegar - Desplega tu agente en Azure Web App (opcional, sáltate si tu agente ya está funcionando y es accesible)
  2. Publicación: publica el agente en el almacén del agente del Centro de administración de Microsoft 365

Después de publicar, completa la incorporación creando una instancia de agente a través de Microsoft Teams.

Importante

El create-instance comando se elimina temporalmente. Evitaba los pasos de registro requeridos, lo que limitaba la funcionalidad del agente. Este comando puede reintroducirse en una versión posterior cuando esté a la altura del flujo de trabajo recomendado. Utiliza el publish comando que sigue creando una instancia agente a través de Microsoft Teams.

Requisitos previos

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

Cuentas y permisos requeridos

  • Inquilino de Microsoft Entra con uno de los siguientes roles:
    • Administrador global
    • Administrador de id. de agente
    • Desarrollador de id. de agente
  • Suscripción de Azure con acceso de colaborador

Herramientas necesarias

Pasos de instalación obligatorios

Antes de implementar y publicar, asegúrese de completar estos pasos en orden:

  1. Plano de agente creado - Completa los pasos de configuración en Registrar agentes para crear tu plano de agente
  2. Agente probado localmente: compruebe que el agente funciona correctamente con el Área de juegos de agentes (consulte Probar agentes localmente)
  3. Archivos de configuración listos: asegúrese de que a365.config.json y a365.generated.config.json estén actualizados

Paso 1: Implementar en Azure

El comando a365 deploy implementa el agente en Azure Web App creada durante la instalación. Esto carga el código del agente en Azure, lo que hace que esté disponible para ejecutarse en la nube y gestionar solicitudes de Microsoft 365.

Implementar agente

Ejecute el comando de implementación:

a365 deploy

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

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

Paso 2: Publicar en el Centro de administración de Microsoft

El comando a365 publish publica el agente en el almacén del agente del Centro de administración de Microsoft 365, lo que hace que sea detectable e instalable. Este último paso pone a tu agente a disposición de las organizaciones para crear instancias de agente y usarlas dentro de su entorno Microsoft 365.

Publicar agente

Ejecute el comando de publicación:

a365 publish

El comando de publicación:

  • Extrae plantillas de manifiesto de recursos incrustados (si la carpeta manifest no existe)
  • Actualiza manifest.json con el id. de plano técnico del agente
  • Pausa para personalizar campos de manifiesto (versión, nombres, descripciones, información de desarrollador, iconos)
  • Agrupación de aplicaciones de paquetes (manifest.zip)
  • Carga en el almacén del agente del Centro de administración de Microsoft 365
  • Crea identidad federada para la integración de Teams
  • Asigna los permisos necesarios de Graph

Personalizar manifiesto

La CLI se pone en pausa durante la publicación para permitirle personalizar el manifiesto del agente:

=== CUSTOMIZE YOUR AGENT MANIFEST ===

Your manifest has been updated at: [path]\manifest\manifest.json

When you're done customizing, type 'continue' (or 'c') and press Enter to proceed:

Pasos manuales:

  1. Abrir manifest.json en el editor de texto

  2. Personaliza los campos requeridos:

    • Actualice el número de versión. Incremente desde anterior si vuelve a cargarse.
    • Establezca el nombre descriptivo del agente. Los nombres deben tener 30 caracteres o menos.
    • Escribir descripciones claras
    • Actualizar la información del desarrollador
    • Opcionalmente, reemplace los archivos de icono

  3. Guardar el archivo de manifiesto

  4. Vuelva a la CLI y escriba continue o c y presione Entrar.

La CLI completa el proceso de publicación y tu agente ya está disponible en Microsoft 365 Admin Center. Sin embargo, antes de poder probar tu agente o permitir que los usuarios creen instancias, necesitas configurar el blueprint del agente en el Portal de Desarrolladores.

Paso 3: Configurar el blueprint del agente en el Portal de Desarrolladores

Después de publicar, debes configurar el blueprint del agente en el Portal de Desarrolladores de Teams para conectar tu agente a la infraestructura de mensajería de Microsoft 365. Sin esta configuración, tu agente no recibirá mensajes de Teams, correo electrónico u otros servicios de Microsoft 365.

Consigue tu ID de plano

Ejecuta el siguiente comando para mostrar tu configuración:

a365 config display -g

Copie el agentBlueprintId valor de la salida.

Abre tu navegador y ve a la página de configuración:

https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

Sustituye <your-blueprint-id> por el agentBlueprintId valor que copiaste.

Nota:

Si no tienes acceso al Portal del Desarrollador, contacta con el administrador de tu inquilino para que te conceda acceso o complete esta configuración en tu nombre.

Configuración del agente

En el Portal para Desarrolladores:

  1. Establecer el tipo de agente a basado en bots
  2. Establece ID de bot a tu agentBlueprintId valor
  3. Seleccione Guardar.

Captura de pantalla que muestra la página de configuración del Portal de Desarrolladores con el Tipo de Agente configurado como Basado en Bot y el campo ID del Bot relleno.

Esta configuración es necesaria antes de poder crear instancias de agente en Teams.

Para más información sobre los Planos de Identidad del Agente y la configuración del Portal de Desarrolladores, consulte Configurar el Plano de Identidad del Agente.

Paso 4: Prueba a tu agente desplegado

Después de implementar y publicar el agente, puede probarlo en Microsoft 365 para asegurarse de que funciona correctamente en producción. Una vez implementado, el agente se integra con los servicios de Microsoft 365, incluidos Teams (chats, canales, reuniones), correo electrónico y calendario (envío/recepción, programación), SharePoint y OneDrive (acceso a documentos, uso compartido de archivos) y herramientas de colaboración (presencia organizativa, tareas de Planner, comentarios de documentos).

Importante

Los usuarios de agente requieren licencias adecuadas de Microsoft 365 para acceder a estos servicios. Entre las licencias comunes se incluyen Microsoft 365 E5, Teams Enterprise y Microsoft 365 Copilot.

Ver el agente implementado en el Centro de administración

Después de la publicación, el agente aparece en el Centro de administración de Microsoft para contratar. Puede tardar algún tiempo en propagarse.

Navegue hasta el Centro de administración de Microsoft 365: Agentes para:

  • Ver el agente publicado
  • Administrar la configuración del agente
  • Supervisar el uso del agente
  • Configuración de permisos

Probar el agente en Teams

Después de desplegar, publicar, configurar el blueprint de tu agente y crear un usuario agente, puedes probar al usuario agente directamente en Microsoft Teams:

Nota:

Requisito de licencia: Asegúrate de tener la licencia "Microsoft Agent 365 Frontier" asignada a tu cuenta. Esta licencia es necesaria para crear instancias de agentes e interactuar con agentes en Microsoft Teams. Contacta con tu administrador de inquilinos si no tienes esta licencia.

Importante

Antes de probar, asegúrate de haber completado el Paso 3: Configurar el blueprint del agente en el Portal de Desarrolladores. Tu agente no recibirá mensajes hasta que esta configuración esté completa.

  1. Crear una instancia de agente en Teams

    • Abra Microsoft Teams con su cuenta
    • Ve a la tienda de aplicaciones de Teams y busca tu agente publicado
    • Crea una nueva instancia de agente a partir de tu blueprint de agente

  2. Comience las pruebas

    • Inicia un nuevo chat con tu instancia de agente recién creada
    • Enviar mensajes de prueba para comprobar la funcionalidad del agente

  3. Mensaje de prueba de ejemplo

    Envíe este mensaje para probar la funcionalidad de correo electrónico (actualice el correo electrónico del destinatario según sea necesario):

    Send an email to recipient@contoso.com with subject "Hello from Teams" and message "This is a test message from my agent!"

    El agente debe procesar la solicitud y enviar el correo electrónico sin requerir más confirmación.

Pasos siguientes

Enhorabuena. El agente ya está en directo en la nube y está listo para trabajar junto con los equipos en Microsoft 365. Lo que empezó como código local es ahora un asistente descubrible y listo para empresas donde los usuarios pueden crear instancias de agentes en toda tu organización.

A medida que el agente gestiona las solicitudes reales, tenga en cuenta los pasos siguientes:

  • 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

El recorrido del agente desde el desarrollo hasta la implementación está completo, pero su impacto es apenas inicial.

Contenido relacionado

  • Last updated on