Agentes de prueba utilizando Dev Tunnels

Mediante Dev Tunnels, puede probar el agente 365 con aplicaciones de Microsoft 365 (como Teams, Outlook o Word) mientras el agente se ejecuta localmente en la máquina de desarrollo. Este enfoque puentea el desarrollo local y las pruebas reales, por lo que puede validar el comportamiento del agente en entornos de Microsoft 365 reales antes de realizar la implementación en la nube.

Prerrequisitos

Antes de usar Dev Tunnels, asegúrate de instalar la herramienta de línea de comandos Dev Tunnels.

• Windows: winget install Microsoft.devtunnel
• macOS/Linux: Descargar desde aka.ms/devtunnels/download

Configurar el Túnel de Desarrollo

Configura un túnel de desarrollo para exponer el punto de conexión del agente local a los servicios de Microsoft 365.

Crea y comienza un túnel

1. Iniciar sesión en el Túnel de Desarrollo:

   devtunnel user login
   

2. Crea un túnel persistente:

   devtunnel create --allow-anonymous
   

   Este comando devuelve un ID de túnel. Guarda este identificador para un uso futuro.

3. Configura el puerto del túnel:

   Asigna el puerto que usa tu servidor agente (normalmente 3978):

   devtunnel port create <tunnel-id> -p <port-number>
   

4. Empieza el túnel:

   devtunnel host <tunnel-id>
   

   El comando muestra la URL de tu túnel (por ejemplo, ). Copia esta URL para el siguiente paso.

Configurar el punto final de mensajería del agente

Registre la dirección URL de su Túnel de Desarrollo (por ejemplo, https://abc123xyz.devtunnels.ms:3978/api/messages) como el punto de conexión de mensajería del agente para que Microsoft 365 sepa dónde enrutar los mensajes. No olvides el sufijo del punto final.

Por favor, consulte Establecer el punto final de mensajería del agente

Prueba con Microsoft 365

Con tu Dev Tunnel activo y el punto de conexión registrado, prueba tu agente en aplicaciones de Microsoft 365.

Prueba en Microsoft Teams

1. Inicia tu agente local usando las instrucciones en Dependencias de instalación y inicia el servidor de aplicaciones del agente.

2. Verifica la conectividad del túnel:

   devtunnel list
   

   Comprueba que tu túnel muestre conexiones activas de host. La columna "Conexiones de anfitrión" debería mostrar un número mayor que 0.

3. Interactúa con tu agente en Teams:

   • Abrir Microsoft Teams (web o escritorio)
   • En la barra de búsqueda de Teams, busca a tu agente por nombre o correo electrónico
   • Inicia una conversación con el agente
   • Envía un mensaje y observa la respuesta
   • Revisa tu consola local para detectar solicitudes entrantes y actividad de agentes

Notificaciones de correo electrónico de prueba

Si tu agente está configurado para notificaciones por correo electrónico:

1. Envía un correo electrónico a la dirección de tu agente
2. Copia a tu agente en un hilo de correo electrónico
3. Vigila tu consola local para detectar el webhook de notificaciones
4. Verifica que tu agente procese y responda al correo electrónico

Prueba de la integración de Word

Para los agentes que responden a comentarios de Word:

1. Abra un documento de Word en el que el agente tenga acceso.
2. Añade un comentario mencionando a tu agente.
3. Consulta la notificación en tu consola local.
4. Compruebe que la respuesta del agente aparece en Word.

Monitorizar la actividad del túnel

Dev Tunnels proporciona inspección de tráfico para ayudar a depurar problemas de conexión y comprender el flujo de solicitudes:

devtunnel show <tunnel-id>

Este comando muestra:

• Conexiones activas y detalles de las sesiones.
• Información de solicitudes y respuestas.
• Estadísticas de volumen de tráfico.
• Errores de conexión y advertencias.

También puedes monitorizar la actividad del túnel en tiempo real observando la salida del comando.

Mantenimiento de las conexiones del túnel

Los Túneles de Desarrollo requieren que el proceso siga funcionando. Si la inactividad, problemas de red o que el ordenador se ponga en suspensión hace que la conexión se caiga, tienes que reiniciarlo.

Comprobar el estado del túnel

Verifica si tu túnel está activo:

devtunnel list

La salida muestra:

• ID del túnel: Tu identificador del túnel
• Conexiones de host: Número de conexiones activas (debería ser una o más cuando está en funcionamiento)
• Puertos: Puertos configurados
• Caducidad: Tiempo de expiración del túnel

Si Host Connections muestra 0, el túnel existe pero actualmente no está alojado.

Reiniciar un túnel desconectado

Si tu conexión al túnel se cae, reinícialo usando el mismo ID del túnel:

devtunnel host <tunnel-id>

La URL del túnel se mantiene igual, así que no necesitas actualizar la configuración del endpoint de mensajería de tu agente.

Mantén los túneles activos durante el desarrollo

Para mantener conexiones estables:

• Mantén la ventana del terminal abierta - No cierres la terminal en marcha .
• Prevenir el sueño del ordenador - Configura tu sistema para que permanezca despierto durante las sesiones de prueba.
• Vigila errores de conexión - Monitoriza la salida del terminal para detectar mensajes de desconexión.
• Reiniciar después de que cambie la red - Si cambias de red o te reconectas a la VPN, reinicia el túnel.

Limpieza

Cuando termines de probar con Dev Tunnels:

¡Parad el túnel

Pulsa el terminal en marcha para detener el túnel.

Esta orden elimina la URL de Dev Tunnel del endpoint de mensajería de tu agente. Cuando despliegues en producción, establece la URL del endpoint alojado en la nube.

Limitaciones

Ten en cuenta estas limitaciones al probar con túneles de desarrollo:

• Solo desarrollo: Usa los Túneles de Desarrollo para desarrollo y pruebas, no para producción.
• Rendimiento: Espera una latencia mayor en comparación con los agentes alojados en la nube debido al enrutamiento de la red.
• Estabilidad de la conexión: Las conexiones por túnel pueden fallar ocasionalmente y requerir reinicio manual.
• Consideraciones de seguridad: La bandera es conveniente para probar, pero no la uses con datos sensibles.
• Gestión de la sesión: Puede que necesites volver a autenticarte periódicamente dependiendo de la duración de la sesión.

Pasos siguientes

Tras pruebas exitosas en Dev Tunnel:

• Implemente su agente en la nube: Implementar en Azure, Configurar el punto de conexión de mensajería del agente en AWS o Configurar el punto de conexión de mensajería del agente en GCP.
• Configurar los puntos finales de mensajería del agente: Punto final de mensajería del agente.
• Sigue el ciclo de vida completo del desarrollo: Ciclo de vida del Agente 365.

Solución de problemas

Si tienes problemas al probar a través de Dev Tunnels, empieza aquí para encontrar soluciones comunes a problemas de túnel, conectividad y endpoints. Para una resolución de problemas más amplia de Agent 365 (configuración, autenticación y mensajería), véase Solución de problemas.

Fallo de conexión por túnel

Síntomas: Dev Tunnel no se inicia o se desconecta de inmediato.

Soluciones:

• Verifica que estás conectado:
• Comprueba si otro proceso está usando el mismo puerto
• Asegúrate de que tu cortafuegos permita conexiones a un túnel de desarrollo
• Elimina y recrea el túnel: luego crea uno nuevo

Los mensajes no llegan al agente local

Symptoms: Microsoft 365 indica que se envió el mensaje, pero el agente local no lo recibe.

Soluciones:

• Confirma que tu agente está trabajando localmente
• Verifica que el túnel esté activo: debería mostrar "Conectado"
• Revisa la configuración del endpoint: debería mostrar la URL de tu Dev Tunnel
• Revisa los registros del túnel de desarrollo en el terminal en funcionamiento para detectar errores de conexión
• Asegúrate de que tu puerto local coincida con el puerto del túnel (ambos deberían ser 3978 por defecto)

Errores de autenticación a través del Dev Tunnel

Síntomas: errores 401 o 403 al probar a través del Dev Tunnel.

Soluciones:

• Compruebe que la autenticación agencial está configurada (ya que la autenticación con token de portador no es compatible con los Dev Tunnels para la integración de Microsoft 365).
• Consulta las credenciales de la plantilla del agente utilizando .
• Confirma que tu agente tiene los permisos necesarios para las operaciones que estás probando.
• Asegúrate de que tus tokens de autenticación no hayan caducado.

URL del túnel cambiada o caducada

Síntomas: La URL del túnel que antes funcionaba ya no redirige a tu agente.

Soluciones:

• Comproba el estado del túnel usando .
• Reinicia el túnel usando .
• Actualiza el endpoint de mensajería si la URL cambió usando .