Crear instancias de agente

Importante

Debe formar parte del programa de versión preliminar 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.

Después de publicar tu agente y ponerlo a disposición en el centro de administración de Microsoft, puedes crear instancias de agentes y usuarios de agentes. Estas instancias y usuarios utilizan el blueprint del agente y el código del agente que has creado.

Este artículo desglosa el proceso en tres pasos principales:

1. Configurar agente en el portal de desarrolladores de Teams
2. Crear instancia de agente
3. Prueba a tu agente desplegado

Si tienes problemas, consulta la sección de Solución de Problemas .

Prerrequisitos

• La plantilla del agente está correctamente configurada según el paso de configuración de la plantilla del agente.
• La aplicación del agente se ha publicado correctamente según Publicar agente en el centro de administración de Microsoft.

1. Configurar el agente en el portal de desarrolladores de Teams

Después de publicarlo, configure el plano técnico del agente en el Portal para desarrolladores de Teams para conectar el agente a la infraestructura de mensajería de Microsoft 365. Sin esta configuración, el agente no recibe mensajes de Teams, correo electrónico u otros servicios de Microsoft 365.

1. Consigue tu ID de diseño

   Ejecutar el comando a365 config display -g para mostrar tu configuración:

   a365 config display -g
   

   Copie el agentBlueprintId valor de la salida.

2. Navegar al Portal de Desarrolladores

   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.

3. Configurar el agente

   En el Portal para Desarrolladores:

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

   

Necesitas esta configuración antes de poder crear instancias de agente en Teams.

Infórmese más sobre los Modelos de Identidad del Agente y la configuración del Portal de Desarrolladores.

2. Crear instancia de agente

Ahora puedes solicitar una instancia de tu blueprint de agente a través de Teams. Descubre más sobre cómo descubrir, crear e incorporar a un agente.

Cuando solicitas una instancia de agente, Teams envía la solicitud al administrador de tu tenant para su aprobación. Los administradores pueden revisar y aprobar solicitudes desde la página de Agentes Solicitados del centro de administración de Microsoft .

Después de que el administrador apruebe tu solicitud, Teams crea tu instancia de agente y la pone a disposición en Teams.

3. Prueba a tu agente desplegado

Después de crear una instancia del agente, pruóbela en Microsoft 365 para asegurarse de que funciona correctamente en producción.

Después de la implementación y con las notificaciones del agente habilitadas en el SDK del Agente 365, el agente se integra con los servicios de Microsoft 365. Funciona con Teams para chats, canales y reuniones; con correo electrónico y calendario para enviar, recibir y programar; y con SharePoint y OneDrive para el acceso a documentos y el uso compartido de archivos. También soporta funciones de colaboración como presencia organizativa, tareas de Planner y comentarios de documentos.

Importante

Al igual que los usuarios normales, los usuarios del agente también requieren licencias de Microsoft 365 adecuadas para acceder a los servicios. Entre las licencias comunes se incluyen Microsoft 365 E5, Teams Enterprise y Microsoft 365 Copilot.

Ver agente desplegado en el centro de administración

Después de publicar tu agente, este aparece en el centro de administración de Microsoft para su contratación. Puede tardar un tiempo en propagarse.

Vaya al centro de administración de Microsoft 365 - Agentes a:

• Ver tu agente publicado
• Administrar la configuración del agente
• Supervisión del uso del agente
• Configurar permisos

Probar el agente en Teams

Después de implementar, publicar y configurar el plano técnico del agente y crear un usuario del agente, pruebe el usuario del agente directamente en Microsoft Teams:

Nota:

Frontier requerido: Asegúrate de que Microsoft Agent 365 Frontier esté habilitado para tu cliente y que tu administrador te debe conceder acceso. Este acceso es necesario para crear instancias de agente e interactuar con agentes en Microsoft Teams mientras el Agente 365 está en versión preliminar. Aprende más sobre Frontier Contacta con tu administrador del inquilino si no tienes acceso.

Comience las pruebas

1. Busca tu nuevo usuario agente en Teams

   Nota:

   El proceso de creación de usuarios agentes es asincrónico y puede tardar de unos minutos a unas horas en que el usuario agente sea buscable una vez creado.

2. Inicia un nuevo chat con tu nueva instancia de agente creada.

3. Envía mensajes de prueba para verificar la funcionalidad del agente.

Ejemplo de mensaje de prueba

Si configuraste el agente con Email, envía este mensaje para probar la funcionalidad del correo. Actualiza el valor del correo del destinatario recipient@contoso.com .

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

El agente procesa la solicitud y envía el correo sin requerir más confirmación.

Lista de comprobación

Después de crear tu instancia de agente, verifica que funciona correctamente en Teams.

✅ Configuración del portal de desarrolladores guardada
✅ Agente aparece en la búsqueda de aplicaciones de Teams
✅ Puedes crear un agente de instancia en Teams
✅ Instancia del agente creada
✅ El usuario agente aparece en la organización
✅ Agente responde a los mensajes
✅ El agente puede realizar acciones
✅ Los registros de aplicaciones no muestran errores
✅ Observabilidad trabajando en un centro administrativo

Si tu instancia de agente no funciona como esperas, consulta la sección de Solución de problemas para soluciones detalladas a problemas comunes.

Verifica que la configuración del portal de desarrolladores esté guardada

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

✅ Tipo de agente : Basado en bot
✅ El ID del bot coincide con tu agentBlueprintId
✅Muestra el mensaje de Guardado correctamente

Verificar que el agente aparece en Teams

1. >Abrir Apps de Teams

2. Busca el nombre de tu agente

   ✅ El agente aparece en los resultados de búsqueda
   ✅ Muestra el icono y la descripción de tu agente

Verifica que puedes crear un instance agent para Teams

Selecciona tu agente en Apps de Teams

✅ El botón Solicitar Instancia/Crear Instancia está activado
✅ Puede solicitar una instancia sin errores

Verificar instancia de agente creada

Después de seleccionar Instancia de Solicitud:

✅ Solicitud enviada correctamente al administrador

Verificar que el usuario del agente aparece en la organización

En el Centro de administración de Microsoft 365

1. Vaya a: https://admin.cloud.microsoft/#/agents/all
2. Navega a la pestaña de Todos los Agentes Solicitudes

✅ Tu solicitud de instancia de agente figura en estado de pendiente de revisión
✅ El administrador puede aprobar la instancia del agente para su uso
✅ El usuario puede entonces crear una instancia desde Teams y ponerle un nombre.

Verificar que el agente responde a los mensajes

En el chat de Teams con tu agente - Envía un mensaje de prueba: Hello!

✅ El agente muestra el indicador de escritura
✅ El agente responde en pocos segundos
✅ La respuesta es coherente y relevante

Verificar que el agente puede realizar acciones

Si las herramientas están configuradas, prueba la funcionalidad de la herramienta. Por ejemplo, si añadiste el servidor Mail MCP, envíate un correo de prueba a ti mismo.

El agente debe:

✅ Confirma la petición
✅ Ejecutar la llamada a la herramienta
✅ Confirmar la finalización exitosa

Deberías verificar que el correo electrónico llega a tu bandeja de entrada.

Comprobación de la funcionalidad

La siguiente lista de comprobación ofrece un enfoque sistemático de pruebas para tu agente:

Funcionalidad básica:

✅ El agente responde a saludos sencillos.
✅ El agente gestiona conversaciones en varios pasos.
✅ El agente proporciona respuestas relevantes.

Funcionalidad de la herramienta:

Depende de la configuración del servidor MCP

✅ Puede enviar correos electrónicos.
✅ Se puede acceder al calendario.
✅ Puede buscar en documentos.
✅ Puede realizar acciones configuradas.

Control de errores:

✅ Gestiona las solicitudes inválidas con elegancia.
✅ Proporciona mensajes de error útiles.
✅ No falla por entrada inesperada.

Rendimiento:

✅ Responde en unos segundos.
✅ No hay errores de tiempo de espera.
✅ Tiempos de respuesta consistentes.

Verificar los registros de aplicaciones

Para ver qué está haciendo tu agente, revisa los registros de la aplicación usando el comando az webapp log tail.

# Real-time logs from Azure
az webapp log tail --name <your-web-app> --resource-group <your-resource-group>

Qué buscar en los registros:

✅ Solicitudes entrantes de Teams
✅ Autenticación exitosa
✅ Llamadas a herramientas en ejecución
✅ Se están enviando respuestas
❌ Mensajes de error o excepciones

Verificar la observabilidad en el centro administrativo

Después de que tu agente empiece a ejecutarse:

1. Vaya a: https://admin.cloud.microsoft/#/agents/all

2. Selecciona tu agente y abre la pestaña Actividad .

   Debería ver lo siguiente:

   ✅ Sesiones que aparecen.
   ✅ Cada sesión muestra desencadenantes y acciones.
   ✅ Las llamadas a herramientas se registran con marcas de tiempo.

Pasos siguientes

El agente ahora está en vivo en la nube y está listo para trabajar junto con su equipo 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.

El ciclo de desarrollo de tu agente está completo, pero su impacto acaba de empezar. Gran parte de lo que ha construido en el ciclo de vida del desarrollador del agente 365 es de código abierto y da la bienvenida a las contribuciones de la comunidad. Denunciar errores, solicitudes de funcionalidades y pull requests:

• Muestras de Agent 365: ¿Tienes agentes de muestra interesantes y divertidos? Comparta el código del agente con la comunidad de open source aquí!
• Node.js SDK: El SDK del Agente 365 en Node.js
• Python SDK: Sdk del agente 365 en Python
• .NET SDK: El SDK del Agente 365 en C# (.NET)
• Agent 365 DevTools CLI: Una CLI para ayudarte durante todo el ciclo de desarrollo del Agent 365

Solución de problemas

Esta sección contiene problemas comunes al crear y probar instancias de agentes.

Sugerencia

La Guía de Resolución de Problemas del Agente 365 contiene recomendaciones de alto nivel para la solución de problemas, mejores prácticas y enlaces a contenido de solución de problemas para cada parte del ciclo de vida del desarrollo del Agente 365.

El agente no aparece en Teams

Síntoma: El agente aparece en el centro de administración pero no lo encuentra en las aplicaciones de Teams.

Causa raíz: Falta la configuración del Portal para Desarrolladores.

Solution:

1. Consigue tu ID de plano:

   a365 config display -g
   # Copy the agentBlueprintId value
   

2. Configurar en el Portal de Desarrolladores:

   1. Vaya a: https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration
   2. Establecer el tipo de agente en Basado en Bot
   3. Establece el ID del bot a tu agentBlueprintId
   4. Seleccione Guardar.

3. Espera 5-10 minutos para la propagación.

Comprobación:

• Abre las aplicaciones de Teams > Busca a tu agente >
• El agente aparece y está disponible para agregar

No puedo crear una instancia de agente en Teams

Síntoma: El agente aparece en Teams pero no puede añadir ni crear instancias; El botón de Solicitar Instancia no funciona.

Causa raíz: Microsoft Agent 365 Frontier no está habilitado para el tenant.

Solución: Contacta con tu administrador de inquilinos para verificar que Microsoft Agent 365 Frontier esté habilitado para el inquilino

Descubre más sobre Frontier

Comprobación:

Las características de Frontier aparecen dentro de Microsoft 365 Copilot y aplicaciones de Microsoft 365 una vez que la licencia y la configuración de administrador lo permiten.

Agente que no responde a los mensajes

Síntoma: Creé la instancia del agente pero no responde a los mensajes; No hay registros en la aplicación.

Causa raíz: Múltiples causas posibles: problemas con los endpoints de mensajería, problemas de autenticación o errores de configuración.

Solución básica de problemas

1. Verifica que la aplicación web esté funcionando:

   az webapp show --name <your-app-name> --resource-group <your-resource-group> --query state
   # Should be: "Running"
   

2. Comprueba el punto final de mensajería:

   • Debería ser: https://<your-app-root-url>/api/messages
   • Verifícalo en a365.config.json y a365.generated.config.json

3. Prueba directamente el endpoint:

   curl https://<your-app-root-url>/api/messages
   # Should not return 404
   

4. Consulta los registros de solicitudes:

   az webapp log tail --name <your-app-name> --resource-group <your-resource-group>
   # Look for incoming requests and errors
   

Diagnósticos avanzados

1. Verificar autenticación:

   • Comprueba si los tokens están caducados. Renuévalos si es necesario.
   • Verifica las credenciales en la configuración de la aplicación web.

2. Comprobar configuración de herramientas/MCP:

   • Verifica que los servidores MCP estén configurados.
   • Verifique que se hayan concedido los permisos.

3. Prueba localmente:

   • Ejecuta el agente localmente con la misma configuración.
   • Prueba con Agents Playground.
   • Funciona localmente, pero no en la implementación en la nube >, problema de despliegue

Soluciones comunes

• Punto final de mensajería incorrecto: Actualizar en el portal de Azure y el Portal de Desarrolladores
• Aplicación web detenida: Iníciala usando el portal de Azure o CLI
• Token expirado: Actualiza los tokens en variables de entorno de aplicación web
• Variables de entorno faltantes: Comprobar la configuración de la aplicación en el portal de Azure
• Problemas con el servidor MCP: Verificar el principal de servicio y los permisos
• Errores de código: Revisa los registros de aplicaciones en busca de excepciones

Comprobación

Envía un mensaje a tu agente en Teams y revisa los registros de solicitudes para ver si llegan solicitudes entrantes.

También podrías probar:

• Resolución de problemas despliegando un agente en Amazon Web Services
• Resolución de problemas para desplegar un agente en Google Cloud Platform

Fallos en las invocaciones a herramientas

Síntoma: El agente responde a los mensajes pero las llamadas a herramientas fallan. Ves errores de permiso denegado o de tiempo de espera.

Causa raíz: Permisos de servidor MCP ausentes, principal de servicio no configurado, problemas de conectividad de red o configuración incorrecta de la herramienta.

Soluciones

Prueba las siguientes soluciones cuando fallen las consultas a herramientas:

• Verifica permisos en el centro de administración

  Revisa y aprueba los permisos necesarios del servidor MCP:

  • Vaya a: https://admin.cloud.microsoft/#/agents/all
  • Selecciona tu agente > Permisos
  • Asegúrate de que la lista incluya y apruebe los servidores MCP requeridos

• Comprobar el principal del servicio

  Ejecuta el script de configuración de una sola vez si no lo ejecutaste antes:

  # Download and run:
  # https://github.com/microsoft/Agent365-devTools/blob/main/scripts/cli/Auth/New-Agent365ToolsServicePrincipalProdPublic.ps1
  

• Verificar la configuración del punto final MCP

  Asegúrate de usar el endpoint MCP de producción:

  # Should be production endpoint, not mock
  MCP_PLATFORM_ENDPOINT=https://agent365.svc.cloud.microsoft
  

• Comprobar identidad gestionada

  Verifica que la identidad gestionada esté habilitada en tu aplicación web:

  # Verify managed identity is enabled
  az webapp identity show --name <your-app-name> --resource-group <your-resource-group>
  

Comprobación

Prueba llamadas a herramientas a través de Teams y revisa los registros para ver si la ejecución es exitosa.

También podrías probar estos pasos:

• Herramientas de solución de problemas
• Solucionar problemas del servidor de herramientas de simulación

Fallo en la cesión de licencias

Síntoma: No se puede asignar licencia al usuario agente; Errores de licencia en el Centro de Administración.

Causa raíz: Licencias insuficientes disponibles, tipo de licencia incorrecto o emisión de permisos.

Soluciones

Prueba las siguientes soluciones cuando falle la cesión de licencias:

1. Verifica que las licencias estén disponibles:

   • Compruebe Microsoft 365 centro de administración >Billing>Licenses
   • Asegúrate de que Microsoft Agent 365 Frontier esté habilitado para el tenant

2. Asignar la licencia manualmente:

   • Vaya al Centro de administración de Microsoft 365 >Usuarios
   • Encontrar al usuario proactivo
   • Asignar la licencia correspondiente

3. Licencias requeridas para la funcionalidad completa:

   • Microsoft 365 E5 (o equivalente)
   • Equipos Enterprise
   • Microsoft 365 Copilot (para las funcionalidades de Copilot)

Comprobación

Consulta el perfil de usuario en el centro de administración y muestra las licencias asignadas.