Probar agentes usando túneles Dev

Usando Túneles Dev, puede probar su agente de Agent 365 con aplicaciones de Microsoft 365 (como Teams, Outlook o Word) mientras se ejecuta localmente en su máquina de desarrollo. Este enfoque conecta el desarrollo local con las pruebas en entornos reales, para que pueda validar el comportamiento de su agente en entornos reales de Microsoft 365 antes de implementarlo en la nube.

Requisitos previos

Antes de usar túneles Dev, asegúrese de instalar la herramienta de línea de comandos Túneles Dev.

Configurar Dev Tunnel

Configurar Dev Tunnel para exponer el punto de conexión local del agente a los servicios de Microsoft 365.

Crear e iniciar un túnel

  1. Iniciar sesión en Dev Tunnel:

    devtunnel user login

  2. Crear un túnel persistente:

    devtunnel create --allow-anonymous

    Este comando devuelve un Id. de túnel. Guarde este identificador para uso futuro.

  3. Configurar el puerto del túnel:

    Asigne el puerto que utiliza su servidor de agente (normalmente el 3978):

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

  4. Iniciar el túnel:

    devtunnel host <tunnel-id>

    El comando muestra la URL de su túnel (por ejemplo, https://abc123xyz.devtunnels.ms:3978). Copie esta URL para el siguiente paso.

Sugerencia

Use devtunnel list para ver todos sus túneles y devtunnel delete <tunnel-id> para eliminar los túneles que ya no necesita.

Configurar el punto de conexión de mensajería del agente

Registre la URL de su Dev Tunnel (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 olvide el sufijo /api/messages en el punto de conexión.

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

Prueba con Microsoft 365

Con el Dev Tunnel activo y el punto de conexón registrado, pruebe su agente en aplicaciones de Microsoft 365.

Prueba en Microsoft Teams

  1. Inicie su agente local usando las instrucciones en Dependencias de instalación e inicia el servidor de aplicaciones del agente.

  2. Verificar la conectividad del túnel:

    devtunnel list

    Compruebe que su túnel muestre conexiones de host activas. La columna "Conexiones de host" debería mostrar un número mayor que 0.

  3. Interactuar con su agente en Teams:

    • Abrir Microsoft Teams (web o escritorio)
    • En la barra de búsqueda de Teams, busque su agente por nombre o correo electrónico
    • Inicie una conversación con el agente
    • Envíe un mensaje y observe la respuesta
    • Revise su consola local para detectar solicitudes entrantes y actividad del agente

Probar notificaciones por correo electrónico

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

  1. Envíe un correo electrónico a la dirección de su agente
  2. Ponga en copia a su agente en un hilo de correo electrónico
  3. Supervise su consola local para detectar el webhook de notificaciones
  4. Verifique que su agente procese y responda al correo electrónico

Probar la integración de Word

Para los agentes que responden a los comentarios de Word:

  1. Abra un documento de Word al que su agente tenga acceso.
  2. Agregue un comentario mencionando a su agente.
  3. Revise la notificación en su consola local.
  4. Verifique que la respuesta de su agente aparezca en Word.

Supervisar 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 sesión.
  • Información sobre solicitudes y respuestas.
  • Estadísticas de volumen de tráfico.
  • Errores y advertencias de conexión.

También puede supervisar la actividad del túnel en tiempo real observando la salida del comando devtunnel host.

Mantener las conexiones del túnel

Dev Tunnels requiere que el proceso devtunnel host siga ejecutándose. Si la conexión se interrumpe debido a la inactividad, a problemas de red o a que su ordenador entra en modo de suspensión, deberá reiniciarla.

Comprobar el estado del túnel

Verifique si su túnel está activo:

devtunnel list

La salida muestra:

  • Id. del túnel: Identificador del túnel
  • Conexiones de host: Número de conexiones activas (debería ser una o más cuando devtunnel host está en ejecución)
  • Puertos: Puertos configurados
  • Expiración: Tiempo de expiración del túnel

Si Conexiones de host muestra 0, el túnel existe pero actualmente no está hospedado.

Reiniciar un túnel desconectado

Si se interrumpe la conexión de su túnel, reinícielo utilizando el mismo Id. de túnel:

devtunnel host <tunnel-id>

La URL del túnel se mantiene igual, por lo que no necesita actualizar la configuración del punto de conexión de mensajería de su agente.

Mantenga los túneles activos durante el desarrollo

Para mantener conexiones estables:

  • Mantenga la ventana del terminal abierta - No cierre el terminal que ejecuta devtunnel host.
  • Evite que el equipo entre en modo de suspensión - Configure su sistema para que permanezca activo durante las sesiones de prueba.
  • Supervise los errores de conexión. - Supervise la salida del terminal devtunnel host para detectar mensajes de desconexión.
  • Reinicie después de un cambio de red - Si cambia de red o se vuelve a conectar a una VPN, reinicie el túnel.

Sugerencia

Si su túnel se desconecta con frecuencia, revise la configuración de red y las reglas del firewall para asegurarse de que no estén bloqueando la conexión.

Limpiar

Al finalizar las pruebas con Dev Tunnels:

Detener el túnel

Pulse Ctrl+C en el terminal que ejecuta devtunnel host para detener el túnel.

Este comando elimina la URL de Dev Tunnel del punto de conexión de mensajería del agente. Cuando implemente en producción, establezca la URL del punto de conexión hospedado en la nube.

Nota

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

Limitaciones

Tenga en cuenta estas limitaciones al probar con Dev Tunnels:

  • Solo para desarrollo: Utilice Dev Tunnels para desarrollo y pruebas, no para producción.
  • Rendimiento: Espere una latencia mayor en comparación con los agentes hospedados en la nube debido al enrutamiento de la red.
  • Estabilidad de la conexión: Las conexiones del túnel pueden interrumpirse ocasionalmente y requerir reinicio manual.
  • Consideraciones de seguridad: La opción --allow-anonymous es útil para pruebas, pero no la utilice con datos confidenciales.
  • Gestión de la sesión: Puede que necesite volver a autenticarse periódicamente dependiendo de la duración de la sesión.

Pasos siguientes

Después de realizar pruebas exitosas con Dev Tunnel:

Solución de problemas

Si está experimentando problemas durante las pruebas con Dev Tunnels, comience aquí para soluciones a problemas comunes de túneles, conectividad y puntos de conexión. Para una solución de problemas más general de Agent 365 (configuración, autenticación y mensajería), consulte Solución de problemas.

Error de conexión del túnel

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

Soluciones:

  • Verifique que ha iniciado sesión: devtunnel user login
  • Compruebe si otro proceso está usando el mismo puerto
  • Asegúrese de que su firewall permita conexiones de Dev Tunnel
  • Elimine y vuelve a crear el túnel: devtunnel delete <tunnel-id> y luego cree uno nuevo

Los mensajes no llegan al agente local

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

Soluciones:

  • Confirme que su agente se esté ejecutando localmente
  • Verifique que el túnel esté activo: devtunnel list debería mostrar "Conectado"
  • Revise la configuración del punto de conexión en a365.config.json y verifique que la URL de Dev Tunnel esté configurada como punto de conexión de mensajería
  • Revise los registros de Dev Tunnel en el terminal en el que se ejecuta devtunnel host para ver si hay errores de conexión
  • Asegúrese de que su puerto local coincida con el puerto del túnel (ambos deberían ser 3978 de manera predeterminada)

Errores de autenticación mediante Dev Tunnel

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

Soluciones:

  • Compruebe que la autenticación por agente esté configurada (la autenticación mediante token de portador no funciona con la integración de Dev Tunnels para Microsoft 365).
  • Consulte las credenciales de la plantilla del agente en a365.generated.config.json.
  • Confirme que su agente tenga los permisos necesarios para las operaciones que está probando.
  • Asegúrese de que sus tokens de autenticación no hayan caducado.

URL del túnel cambiada o expirada

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

Soluciones:

  • Compruebe el estado del túnel usando devtunnel list.
  • Reinicie el túnel usando devtunnel host <tunnel-id>.
  • Actualice el punto de conexión de mensajería si la URL cambió usando a365 setup blueprint --endpoint-only.
  • Last updated on