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 encuentra desafíos, consulte la sección Solución de problemas .

Prerrequisitos

• El plan del agente se configura correctamente como se describe en el paso de configuración del plan del agente.
• La aplicación del agente se publicó correctamente como se describe en Publicación del 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. Establece Tipo de Agente a Basado en API

   2. Establezca URL de notificación al endpoint de mensajería de su agente. Ejecute el siguiente comando para obtener el valor:

      a365 config display -g --field messagingEndpoint
      

   3. Haga clic en 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 puede solicitar una instancia de su plano técnico de agente desde 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
• Supervisar el 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:

Frontera requerida: Asegúrese de que Microsoft Agent 365 Frontier está habilitado para el inquilino y el administrador le concede acceso. Necesita este acceso para crear instancias de agente e interactuar con agentes en Microsoft Teams, mientras que 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 del agente es asincrónico. Puede tardar desde unos minutos hasta unas horas para que el usuario del agente se vuelva visible en búsquedas después de crearlo.

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 de administración

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.

✅ El tipo de agente muestra: Basado en API
✅ La dirección URL de notificación coincide con el punto de conexión de mensajería del agente
✅Muestra el mensaje de Guardado correctamente

Verificar que el agente aparece en Teams

1. Abra las >aplicaciones 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

Comprobar que el usuario 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

✅ Su solicitud de instancia de agente aparece en la lista con el estado como pendiente de revisión
✅ El administrador puede aprobar la instancia del agente para su uso
✅ El usuario puede crear una instancia de Teams y asignarle 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 lo que hace el agente, compruebe los registros de la aplicación mediante 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 su 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: sdk del agente 365 en Node.js.
• SDK de Python: sdk del agente 365 en Python.
• SDK de .NET: sdk del agente 365 en C# (.NET).
• CLI de DevTools del Agente 365: una CLI que le ayudará a través de todo el ciclo de vida de desarrollo del Agente 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. Obtener su id. de plano técnico:

   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 Tipo de Agente a Basado en API

   3. Establezca la URL de notificación en el endpoint de mensajería del agente. Ejecute el siguiente comando para obtener el valor:

      a365 config display -g --field messagingEndpoint
      

   4. Haga clic en 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 se puede agregar ni crear una instancia; El botón Request Instance (Instancia de solicitud ) no funciona.

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

Solución: Póngase en contacto con el administrador de inquilinos para comprobar que Microsoft Agent 365 Frontier está habilitado para el inquilino.

Más información 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: Crea una instancia del agente, pero no responde a los mensajes. No verá ningún registro 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 nube > problema de implementación

Soluciones comunes

• Punto de conexión de mensajería incorrecto: Actualice en Azure Portal y portal para desarrolladores.
• Aplicación web detenida: Inícielo mediante Azure Portal o la CLI.
• Token expirado: Actualizar tokens en variables de entorno de Web App.
• Faltan variables de entorno: Compruebe la configuración de la aplicación en Azure Portal.
• Problemas del servidor MCP: Compruebe la entidad de servicio y los permisos.
• Errores de código: Compruebe los registros de aplicaciones para ver las 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:

• Solución de problemas de implementación de un agente en Amazon Web Services.
• Solución de problemas de implementación de 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. Ve 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 entidad de 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.

Es posible que también quiera 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 una licencia a un usuario agente. Verá 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:

   • Consulte >Facturación>Licencias del centro de administración de Microsoft 365.
   • Asegúrese de que Microsoft Agent 365 Frontier está habilitado para el inquilino.

2. Asignar la licencia manualmente:

   • Vaya al Centro > de administración de Microsoft 365 Usuarios.
   • Busque el usuario agente.
   • Asigne la licencia adecuada.

3. Licencias requeridas para la funcionalidad completa:

   • Microsoft 365 E5 (o equivalente).
   • Teams Enterprise.
   • Microsoft 365 Copilot (para las funciones de Copilot).

Comprobación

Compruebe que el perfil de usuario en el Centro de administración muestra licencias asignadas.