Preguntas más frecuentes sobre la solución de problemas de operaciones del agente de SRE de Azure

En este artículo se tratan problemas operativos comunes al trabajar con el agente de SRE de Azure, junto con soluciones prácticas. Estos problemas suelen estar relacionados con los permisos, la disponibilidad regional, los problemas de implementación y los requisitos de acceso administrativo.

Escenarios comunes de solución de problemas

En la tabla siguiente se describen los problemas comunes y sus soluciones. Para obtener más información sobre cómo se aplican roles y permisos a un agente, consulte Roles y permisos.

Scenario Motivo Solución
El agente muestra un error de permisos en el gráfico de chat y conocimiento. El agente se crea con acceso de colaborador y una cuenta con solo permisos de lectura intenta interactuar con el agente. Conceda acceso de colaborador o propietario a la cuenta de usuario en el grupo de recursos.
La lista desplegable de ubicación está en blanco. Una política de región no estadounidense bloquea el acceso a Suecia Central. Si su suscripción o grupo de gestión está limitado a implementaciones solo en EE. UU., utilice East US 2 para la implementación.
El botón Crear no está disponible. La cuenta de usuario carece de permisos administrativos. Asegúrese de que la cuenta de usuario tiene permisos de propietario o administrador de acceso de usuario .
El agente no puede consultar registros ni métricas. Permisos insuficientes en áreas de trabajo de Log Analytics. Conceda a la identidad administrada del agente permisos de Lector de Log Analytics en las áreas de trabajo de destino.
Se produce un error en las integraciones externas. Problemas de conectividad o autenticación de red. Revise las reglas del firewall y verifique las configuraciones de la entidad de servicio.

Problemas de implementación

En las secciones siguientes se tratan los problemas comunes que podría surgir al implementar el agente de SRE de Azure.

No se encontró la implementación

Es posible que encuentre un error que indica que la implementación no se encuentra por varias razones. En primer lugar, asegúrese de que va a asignar un nombre al agente correctamente y de que tiene las reglas de firewall adecuadas en su lugar:

  • Asegúrese de que el nombre del agente sea único en toda la suscripción.
  • Compruebe si hay reglas de firewall o bloqueo geográfico que pueden impedir el acceso al punto de conexión del agente.

Si la nomenclatura y la configuración de red son correctas, siga estos pasos para resolver el error "DeploymentNotFound" del agente.

Captura de pantalla que muestra una notificación del error de aprovisionamiento en el agente de SRE de Azure.

  1. Confirme que la cuenta de usuario tiene permisos de propietario o administrador, junto con permisos para crear recursos en las regiones Centro de Suecia, Este de EE. UU. 2 o Este de Australia (en función de la implementación).

  2. Compruebe si la suscripción está en la lista de permitidos para la versión preliminar de SRE Agent. Ejecute el siguiente comando:

    az provider show -n Microsoft.App | grep -C 15 agents

    Si la suscripción está en la lista de permitidos, obtendrá un resultado similar al siguiente mensaje.

    Captura de pantalla de una respuesta de consola que comprueba el acceso de usuario a los agentes.

    Busque específicamente por "resourcetype : agents" y "defaultApiVersion : 2025-05-01-preview".

    Si la ejecución de este comando no devuelve el resultado esperado, debe registrar la suscripción.

  3. Para volver a registrar la suscripción, ejecute el comando az provider register en Azure Cloud Shell mediante Azure Portal:

    az provider register --namespace "Microsoft.App"

    A continuación, vuelva a intentar crear el agente.

Errores de validación de implementación

Si se produce un error en la validación de la implementación:

  1. Compruebe las cuotas de recursos: asegúrese de que la suscripción tiene cuota disponible para la región de implementación.
  2. Comprobar el registro del proveedor de recursos: confirme que el proveedor de Microsoft.App está registrado.
  3. Revisión de Azure Policy: compruebe si las directivas organizativas bloquean la creación de recursos.

Problemas de permisos y acceso

En las secciones siguientes se abordan los problemas relacionados con los permisos y el control de acceso para el agente de Azure SRE.

Errores de permisos

Si no puede chatear o interactuar con el agente, es posible que el problema esté relacionado con un error 403 Prohibido o un error de directiva de uso compartido de recursos entre orígenes (CORS). En la captura de pantalla siguiente se muestra un ejemplo del mensaje de error.

Captura de pantalla de los errores resultantes de permisos incorrectos.

O bien, puede obtener la siguiente salida en el seguimiento de red.

Captura de pantalla de un seguimiento de red del explorador cuando el agente encuentra un error de permisos.

Para resolver el problema:

  • Asegúrese de que tiene acceso de colaborador o propietario al grupo de recursos que hospeda el agente.
  • Evite confiar únicamente en asignaciones de roles basadas en grupos. Asigne roles directamente a su cuenta si los problemas persisten.
  • Use la característica Comprobar acceso en Azure Portal para comprobar que tiene los permisos adecuados.

Problemas con la identidad administrada del agente

Si el agente no puede acceder a los recursos de Azure:

  1. Comprobar la creación de identidad administrada: compruebe que la identidad administrada del agente se ha creado correctamente.
  2. Comprobar las asignaciones de roles: asegúrese de que la identidad administrada tiene los permisos adecuados en los recursos de destino.
  3. Revise las directivas de acceso condicional: asegúrese de que las directivas organizativas no bloquean el acceso a la identidad administrada.

Problemas de red y conectividad

Las secciones siguientes le ayudan a resolver problemas de red y conectividad que pueden afectar al agente de Azure SRE.

El portal deja de responder

Si Azure Portal deja de responder al intentar usar el agente SRE, es posible que las reglas de firewall bloqueen el acceso a un dominio de Azure.

Para conceder acceso al dominio adecuado, agregue *.azuresre.ai a la lista de permitidos en la configuración del firewall. Zscaler puede bloquear el acceso al dominio *.azuresre.ai de forma predeterminada.

Errores de conexión de WebSocket

Si las características de chat en tiempo real no funcionan:

  1. Comprobar la configuración del proxy: los servidores proxy corporativos podrían bloquear las conexiones de WebSocket.
  2. Comprobar reglas de firewall: asegúrese de que *.azuresre.ai está en la lista de permitidos para el tráfico HTTP y WebSocket.
  3. Probar la conectividad de red: use las herramientas de desarrollo del explorador para comprobar si hay errores de conexión.

Problemas de rendimiento

En las secciones siguientes se abordan problemas comunes relacionados con el rendimiento con el agente de Azure SRE.

Tiempos de respuesta lentos

Si las respuestas del agente son más lentas de lo esperado:

  1. Comprobación del estado del servicio de Azure: compruebe que no hay interrupciones en la región de implementación.
  2. Revisar la complejidad de las consultas: las consultas de registro complejas pueden tardar más tiempo en procesarse.
  3. Supervisión de los límites de recursos: asegúrese de que los recursos de destino (Log Analytics y otros) no están limitados.

Problemas de carga de la interfaz de chat

Si la interfaz de chat no se carga:

  1. Borrar caché del explorador: forzar la actualización de la página (Ctrl+F5).
  2. Pruebe incógnito o exploración privada: descarte los conflictos de extensión del explorador.
  3. Compruebe la consola de JavaScript: busque mensajes de error en las herramientas de desarrollo del explorador.

Solución de problemas de integración

Las secciones siguientes le ayudarán a solucionar problemas con integraciones de servicios externos.

Errores de conexión de GitHub o Azure DevOps

Si se produce un error en las integraciones de control de código fuente:

  1. Comprobar la autenticación: Compruebe los permisos del principal de servicio o del token de acceso personal.
  2. Probar el acceso a la API: asegúrese de que el agente puede acceder a las API de servicio externos.
  3. Revise las reglas de firewall: confirme el acceso saliente a github.com o dev.azure.com.

Problemas de servidor MCP personalizados

Si los servidores personalizados del Protocolo de Contexto de Modelo no funcionan:

  1. Comprobar el estado del servidor: compruebe que el servidor MCP está en ejecución y accesible.
  2. Probar la autenticación: asegúrese de una configuración de autenticación adecuada.
  3. Registros de revisión: compruebe los registros del agente para ver si hay errores de conexión o protocolo.

Problemas de datos y almacenamiento

En las secciones siguientes se tratan los problemas relacionados con el almacenamiento y la recuperación de datos en el agente de SRE de Azure.

Falta el historial de conversaciones

Si los hilos de conversación desaparecen:

  1. Comprobar la configuración de retención de datos: compruebe las directivas de retención configuradas.
  2. Revise los permisos de acceso: asegúrese de que tiene acceso a los datos de conversación.
  3. Póngase en contacto con el soporte técnico: para obtener ayuda para la recuperación de datos.

Errores de carga de la base de conocimiento

Si se produce un error en la carga de documentos en la base de conocimiento:

  1. Comprobar los límites de tamaño de archivo: asegúrese de que los documentos están dentro de las restricciones de tamaño.
  2. Comprobar formatos de archivo: confirme los tipos de documento admitidos.
  3. Revise los permisos de almacenamiento: compruebe el acceso de identidad administrada a Blob Storage.

Obtener ayuda

Use los siguientes recursos si necesita ayuda adicional más allá de lo que trata esta guía.

Rutas de escalación

Para problemas que esta guía no cubre, pruebe las siguientes opciones:

  • Soporte técnico de Azure: cree una incidencia de soporte técnico para problemas de implementación o servicio.
  • Microsoft Docs: compruebe la documentación oficial de las actualizaciones.
  • Estado de Azure: supervise la página Estado de Azure para las interrupciones del servicio.

Contenido relacionado

  • Last updated on