Compartir a través de

Agentes de prueba utilizando Dev Tunnels

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.

Usando Dev Tunnels, puedes probar tu agente Agent 365 con aplicaciones de Microsoft 365 (como Teams, Outlook o Word) mientras tu agente se ejecuta localmente en tu máquina de desarrollo. Este enfoque conecta el desarrollo local y las pruebas en el mundo real, por lo que puedes validar el comportamiento de los agentes en entornos reales de Microsoft 365 antes de desplegarlos en la nube.

Prerrequisitos

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

Configurar el Túnel de Desarrollo

Configura un Dev Tunnel para exponer tu endpoint local de agente 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, https://abc123xyz.devtunnels.ms:3978). Copia esta URL para el siguiente paso.

Sugerencia

Úsalo devtunnel list para ver todos tus túneles y devtunnel delete <tunnel-id> eliminar túneles que ya no necesitas.

Configurar el punto final de mensajería del agente

Registra la URL de tu túnel de desarrollo (por ejemplo, https://abc123xyz.devtunnels.ms:3978/api/messages) como el punto final de mensajería del agente para que Microsoft 365 sepa dónde enrutar los mensajes. No olvides el /api/messages 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 endpoint 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:

    • Abre 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

Integración de Palabra de Prueba

Para los agentes que responden a los comentarios de Word:

  1. Abre un documento de Word al que tu agente tenga acceso.
  2. Añade un comentario mencionando a tu agente.
  3. Consulta la notificación en tu consola local.
  4. Verifica que la respuesta de tu agente aparezca 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 devtunnel host comando.

Mantenimiento de las conexiones del túnel

Los Túneles de Desarrollo requieren que el devtunnel host 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 devtunnel host 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 devtunnel host.
  • 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 devtunnel host 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.

Sugerencia

Si tu túnel se desconecta con frecuencia, revisa la configuración de red y las reglas del cortafuegos para asegurarte de que no bloquean la conexión.

Limpieza

Cuando termines de probar con Dev Tunnels:

¡Parad el túnel

Pulsa Ctrl+C el terminal en marcha devtunnel host para detener el túnel.

Este comando elimina la URL del Túnel de Desarrollo del endpoint de mensajería de tu agente. Cuando despliegues en producción, establece la URL del endpoint alojado en la nube.

Nota:

El túnel permanece disponible para su uso futuro hasta que lo elimines explícitamente usando devtunnel delete <tunnel-id>.

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 --allow-anonymous 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:

Solución de problemas

Si tienes problemas mientras pruebas a través de Dev Tunnels, empieza por aquí para soluciones comunes 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: El túnel de desarrollo no se inicia o se desconecta inmediatamente.

Soluciones:

  • Verifica que estás conectado: devtunnel user login
  • 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: devtunnel delete <tunnel-id> luego crea uno nuevo

Los mensajes no llegan al agente local

Síntomas: Microsoft 365 indica que el mensaje se envió, pero tu agente local no lo recibe.

Soluciones:

  • Confirma que tu agente está trabajando localmente
  • Verifica que el túnel esté activo: devtunnel list debería mostrar "Conectado"
  • Revisa la configuración del endpoint: a365 config display debería mostrar la URL de tu Dev Tunnel
  • Revisa los registros del túnel de desarrollo en el terminal en funcionamiento devtunnel host 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:

  • Verifica que la autenticación agente esté configurada (la autenticación por token portador no funciona con los Túneles de Desarrollo para la integración de Microsoft 365).
  • Consulta las credenciales de blueprint del agente usando a365 config display -g.
  • 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 enruta a tu agente.

Soluciones:

  • Comproba el estado del túnel usando devtunnel list.
  • Reinicia el túnel usando devtunnel host <tunnel-id>.
  • Actualiza el endpoint de mensajería si la URL cambió usando a365 setup blueprint --endpoint-only.
  • Last updated on