Crear instancias del agente

Una vez que haya publicado su agente y lo haya puesto a disposición en el Centro de administración de Microsoft, podrá crear instancias de agentes y usuarios de agentes. Estas instancias y usuarios utilizan el plano técnico de agente y el código de agente que creó.

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

1. Configurar el agente en el portal para desarrolladores de Teams
2. Crear instancia de agente
3. Probar el agente implementado

Si encuentra problemas, consulte la sección de solución de problemas.

Requisitos previos

• El plano técnico del agente está correctamente configurado según el paso de configuración del plano técnico del agente.
• La aplicación del agente está correctamente publicada como se describe en Publicar agente en el Centro de administración de Microsoft.

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

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

1. Obtener su id. de plano técnico

   Abra a365.generated.config.json en su directorio de trabajo y copie el valor agentBlueprintId.

2. Vaya al Portal para desarrolladores

   Abra el explorador y vaya a la página de configuración:

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

   Reemplace <your-blueprint-id> con el valor agentBlueprintId que copió.

   Nota

   Si no tiene acceso al Portal para desarrolladores, contacte con el administrador de su inquilino para que le conceda acceso o complete esta configuración en su nombre.

3. Configurar el agente

   En el Portal para desarrolladores:

   1. Establezca el Tipo de agente en Basado en API

   2. Establezca la URL de notificación al punto de conexión de mensajería de su agente. Busque el valor messagingEndpoint en a365.generated.config.json.

   3. Seleccione Guardar.

   

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

Infórmese más sobre los planos de identidad de los agentes y la configuración del Portal para desarrolladores.

2. Crear instancia de agente

Ahora puede solicitar una instancia de su plano técnico de agente desde Teams. Obtener más información sobre cómo detectar, crear e incorporar un agente.

Cuando solicita una instancia de agente, Teams envía la solicitud al administrador de su inquilino para su aprobación. Los administradores pueden revisar y aprobar solicitudes desde la página Centro de administración de Microsoft - Agentes Solicitados.

Después de que el administrador apruebe su solicitud, Teams crea su instancia de agente y la hace disponible en Teams.

3. Probar el agente implementado

Después de crear una instancia de agente, realice pruebas en Microsoft 365 para asegurarse de que funcione correctamente en producción.

Después de la implementación, y con las notificaciones de agente activadas en el SDK de Agent 365, su agente se integra con los servicios de Microsoft 365. Se integra con Teams para chats, canales y reuniones; con correo electrónico y calendario para enviar, recibir y programar; y con SharePoint y OneDrive para obtener acceso a documentos y compartir archivos. También admite características de colaboración como la presencia organizacional, tareas de Planner y comentarios de documentos.

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.

Vaya al 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 implementar, publicar y configurar el plano técnico de agente y crear un usuario agente, prueba el usuario agente directamente en Microsoft Teams:

Iniciar prueba

1. Busque su nuevo usuario agente en Teams.

   Nota

   El proceso de creación del usuario agente es asincrónico. Puede tardar desde unos minutos hasta varias horas para que el usuario agente esté disponible para búsqueda después de crearlo.

2. Iniciar un nuevo chat con la instancia de agente recién creada

3. Envíe mensajes de prueba para comprobar la funcionalidad del agente.

Mensaje de prueba de ejemplo

Si configuró el agente con correo electrónico, envíe este mensaje para probar la funcionalidad del correo electrónico. Actualice el valor de la dirección de correo electrónico 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 electrónico sin requerir más confirmación.

Lista de comprobación

Después de crear su instancia de agente, verifique que funcione correctamente en Teams.

✅ Configuración del portal para desarrolladores guardada
✅ El agente aparece en la búsqueda de aplicaciones de Teams
✅ Puede crear una instancia de agente en Teams
✅ Instancia del agente creada
✅ El usuario agente aparece en la organización
✅ El 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 su instancia de agente no funciona como espera, consulte la sección de Solución de problemas para soluciones detalladas para problemas comunes.

Verifique que la configuración del Portal para desarrolladores esté guardada

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

✅ Tipo de agente muestra: La URL de notificación✅basada en la API concuerda con el punto de conexión de mensajes del agente ✅ Muestra el mensaje Guardado correctamente

Verifique que el agente aparezca en Teams

1. Abra las >aplicaciones Teams

2. Busque el nombre del agente

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

Verifique que puede crear una instancia de agente en Teams

Seleccione su agente en aplicaciones de Teams

✅ El botón Solicitar instancia/Crear instancia está habilitado ✅ Se puede solicitar instancia sin errores

Verifique que la instancia de agente se haya creado

Después de seleccionar Solicitar instancia:

✅ La solicitud se envía 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. Navegar a la pestaña de Solicitudes de Todos los agentes

✅ La solicitud de instancia de agente aparece con el estado de revisión pendiente ✅ El administrador puede aprobar la instancia de agente para su uso ✅ El usuario puede crear una instancia desde Teams y asignarle un nombre.

Verifique que el agente responda a los mensajes

En el chat de Teams con su agente - Envíe 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 pueda realizar acciones

Si configura herramientas, verifique su funcionamiento. Por ejemplo, si agrega el servidor Mail MCP, envía un correo de prueba a ti mismo.

El agente debe:

✅ Reconocer la solicitud. ✅ Ejecutar la llamada a la herramienta. ✅ Confirmar la finalización correcta

Debe verificar que el correo electrónico llegue a su bandeja de entrada.

Comprobación de la funcionalidad

La siguiente lista de comprobación proporciona un enfoque sistemático de pruebas para su 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. ✅ Puede obtener acceso al calendario. ✅ Puede buscar documentos. ✅ Puede realizar acciones configuradas.

Control de errores:

✅ Gestiona las solicitudes no válidas de forma adecuada. ✅ Proporciona mensajes de error útiles. ✅ No se bloquea por entrada inesperada.

Rendimiento:

✅ Responde en pocos segundos. ✅ Sin errores de tiempo de espera. ✅ Tiempos de respuesta consistentes.

Comprobar los registros de la aplicación

Para ver qué está haciendo su agente, revise 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 desde Teams ✅ Autenticación correcta ✅ Llamadas a herramientas ejecutadas ✅ Respuestas enviadas ❌ Mensajes de error o excepciones

Comprobar la observabilidad en el centro de administración

Después de que su agente empiece a ejecutarse:

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

2. Seleccione su agente y abra la pestaña Actividad.

   Debería ver lo siguiente:

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

Pasos siguientes

El agente ya está en directo en la nube y está listo para trabajar junto con su equipo en Microsoft 365. Lo que comenzó como código local ahora es un asistente registrado, apto para el entorno empresarial, donde los usuarios pueden crear instancias de agentes en toda la organización.

El ciclo de vida de desarrollo hasta del agente está completo, pero su impacto es apenas inicial. Gran parte de lo que ha creado en el ciclo de desarrollo de Agent 365 es de código abierto y acepta contribuciones de la comunidad. Reporte errores, solicite solicitudes de características y envíe solicitudes de cambios:

• Ejemplos de Agent 365: ¿Tiene agentes de ejemplo interesantes y divertidos? ¡Comparta su código de agente con la comunidad de código abierto aquí!
• SDK de Node.js: El SDK de Agent 365 en Node.js.
• SDK de Python: El SDK Agent 365 en Python.
• .NET SDK: El SDK de Agent 365 en C# (.NET).
• Agent 365 DevTools CLI: Una CLI para asistirle durante todo el ciclo de vida de desarrollo de Agent 365.

Solución de problemas

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

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: No se ha configurado el Portal para desarrolladores.

Solución:

1. Obtenga el Id. de plano técnico de a365.generated.config.json y busque agentBlueprintId.

2. Configurar en el Portal para desarrolladores:

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

   2. Establezca el Tipo de agente en Basado en API

   3. Establezca la URL de notificación al punto de conexión de mensajería de su agente. Busque el valor messagingEndpoint en a365.generated.config.json.

   4. Seleccione Guardar.

3. Espere entre 5 y 10 minutos a que se propague.

Comprobación:

• Abra Teams > Apps > Busque su agente.
• El agente aparece y está disponible para agregar.

No se puede crear una instancia de agente en Teams

Síntoma: El agente aparece en Teams pero no puede agregar ni crear una instancia; el botón Solicitar Instancia no funciona.

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

Solución: Contacte con su administrador del inquilino para verificar que Microsoft Agent 365 Frontier esté habilitado para el inquilino.

Más información sobre Frontier.

Comprobación:

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

El agente no responde a mensajes

Síntoma: se crea una instancia de agente pero no responde a mensajes. No aparecen registros en la aplicación.

Causa raíz: múltiples posibles causas: problemas con el punto de conexión de mensajería, problemas de autenticación o errores de configuración.

Solución de problemas de conexiones del Escritorio remoto a una máquina virtual de Azure

1. Verifique que la aplicación web esté en funcionamiento:

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

2. Compruebe el punto de conexión de mensajería:

   • Debe ser: https://<your-app-root-url>/api/messages
   • Compruébelo en a365.config.json y a365.generated.config.json

3. Probar el punto de conexión directamente:

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

4. Comprobar los registros de la aplicación:

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

Diagnóstico avanzados

1. Comprobar la autenticación:

   • Compruebe si los tokens están caducados. Renueve los tokens si es necesario.
   • Verifique las credenciales en la configuración de la aplicación web.

2. Comprobar la configuración de la herramienta/MCP:

   • Verifique que los servidores MCP estén configurados.
   • Compruebe que se hayan otorgado permisos.

3. Probar localmente:

   • Ejecute el agente localmente con la misma configuración.
   • Prueba con área de juegos de agentes.
   • 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 el portal para desarrolladores.
• La aplicación web se ha detenido: Iníciela usando Azure portal o CLI.
• Token expirado: Actualice los tokens en las variables de entorno de Web App.
• Faltan variables de entorno: compruebe la configuración de la aplicación en Azure Portal.
• Problemas con el servidor MCP: compruebe la entidad de servicio y los permisos.
• Errores de código: revise los registros de la aplicación en busca de excepciones.

Comprobación

Envíe un mensaje a su agente en Teams y verifique los registros de la aplicación para solicitudes entrantes.

También puede probar lo siguiente:

• Solucionar problemas al implementar un agente en Amazon Web Services.
• Solucionar problemas al implementar un agente en Google Cloud Platform.

Fallos de llamadas 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: Falta de permisos del servidor MCP, entidad de servicio no configurada, problemas de conectividad de red o configuración incorrecta de la herramienta.

Soluciones

Aplique las siguientes soluciones cuando se produzcan fallos en las llamadas a herramientas:

• Comprobar permisos en el Centro de administración

  Compruebe y apruebe los permisos necesarios del servidor MCP:

  • Vaya a: https://admin.cloud.microsoft/#/agents/all
  • Seleccionar el agente > Permisos
  • Verifique que la lista incluya y apruebe los servidores MCP requeridos

• Comprobar entidad de servicio

  Ejecute el script de configuración inicial si no lo ejecutó antes:

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

• Comprobar la configuración de puntos de conexión MCP

  Asegúrese de usar el punto de conexión MCP de producción:

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

• Comprobar la identidad administrada

  Compruebe que la identidad administrada esté habilitada en su aplicación web:

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

Comprobación

Pruebe llamadas a herramientas a través de Teams y revise los registros para ver si la ejecución es correcta.

También podría probar estos pasos:

• Solución de problemas relacionados con las herramientas
• Solución de problemas del servidor de herramientas de simulación

Error en la asignación de licencias

Síntoma: No puede asignar una licencia a un usuario agente. Aparecen errores de licencia en el centro de administración.

Causa raíz: No hay suficientes licencias disponibles, tipo de licencia incorrecto o problema de permisos.

Soluciones

Pruebe las siguientes soluciones cuando falle la asignación de licencias:

1. Verificar 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 >Users.
   • Busque el usuario de agente.
   • Asigne la licencia correspondiente.

3. Licencias requeridas para la funcionalidad completa:

   • Microsoft 365 E5 (o equivalente).
   • Teams Enterprise.
   • Microsoft 365 Copilot (para características de Copilot).

Comprobación

Compruebe que el perfil de usuario en el centro de administración muestre las licencias asignadas.