Conectores en el Agente de SRE de Azure

El agente incluye acceso integrado a los servicios de Azure. Puede consultar Azure Monitor, Application Insights, Log Analytics y Azure Resource Graph. Los conectores amplían ese alcance a sistemas externos: los clústeres de Kusto, los repositorios de código fuente, las herramientas de colaboración y las API personalizadas.

Nota:

Los conectores proporcionan al agente acceso a datos y acciones, como consultar registros, enviar notificaciones y leer código. Las plataformas de incidentes son un concepto independiente: controlan dónde proceden las alertas y cómo responde automáticamente el agente. En este artículo se tratan los conectores. Para obtener más información sobre las plataformas de incidentes, consulte Plataformas de incidentes.

Lo que su agente puede hacer sin conectores

Incluso sin conectores configurados, su agente tiene capacidades integradas mediante su identidad administrada y los permisos de control de acceso basado en roles de Azure (Azure RBAC):

Funcionalidad integrada	Qué proporciona
Application Insights	Consulta la telemetría, las trazas y las excepciones de la aplicación.
Log Analytics	Consultar áreas de trabajo de Log Analytics.
métricas de Azure Monitor	Enumerar y consultar métricas y analizar tendencias y anomalías.
Resource Graph	Descubra y consulte cualquier recurso de Azure en distintas suscripciones.
Azure Resource Manager/CLI de Azure	Lea y modifique cualquier tipo de recurso Azure.
diagnóstico de Azure Kubernetes Service (AKS)	Ejecute comandos kubectl y diagnostique problemas de Kubernetes.

Las operaciones de Resource Graph y Resource Manager funcionan con cualquier tipo de recurso de Azure, incluidos Azure App Service, Azure Container Apps, máquinas virtuales, redes y almacenamiento. Si los registros y las métricas residen en Azure Monitor y Application Insights, el agente puede empezar a investigar problemas inmediatamente, sin que se requiera ninguna configuración del conector. Los conectores son valiosos cuando necesita que el agente se conecte a sistemas fuera de Azure.

Qué conectores proporciona

Los conectores se dividen en cuatro categorías en función de lo que proporcionan al agente: orígenes de datos, código fuente y conocimientos, herramientas de colaboración y conectores personalizados.

Orígenes de datos

Estos orígenes pueden ser registros de consulta, métricas y telemetría de los almacenes de datos.

Conector	Qué proporciona
Log Analytics	Conecte áreas de trabajo específicas para que el agente tenga contexto persistente sobre los datos de registro y pueda consultarlas de forma proactiva.
Application Insights	Conecte recursos específicos de Application Insights para que el agente tenga un contexto persistente sobre la telemetría de la aplicación.
Consulta de base de datos (Azure Data Explorer)	Ejecute consultas KQL predefinidas en los clústeres de Kusto.
Indexación de base de datos (Azure Data Explorer)	Aprenda automáticamente el esquema de Kusto para que el agente pueda generar consultas dinámicamente.

Sugerencia

El agente ya puede consultar cualquier área de trabajo de Log Analytics o recurso de Application Insights a través de sus herramientas integradas, sin necesidad de conector. Agregar un Log Analytics o un conector de Application Insights va más allá: proporciona al agente reconocimiento persistente de áreas de trabajo específicas e incluye sus datos en el contexto ambiental del agente. Este conector también permite diagnósticos basados en MCP más enriquecidos en los recursos conectados.

Código fuente y conocimiento

Asigne al agente contexto sobre los sistemas: código, wikis y documentación.

Conector	Qué proporciona
servidor MCP de GitHub	Acceso a repositorios, problemas, solicitudes de incorporación de cambios y páginas wiki.
GitHub OAuth	Acceso a GitHub vía el flujo de autenticación de OAuth.
Azure DevOps OAuth	Acceso a Azure DevOps mediante autenticación OAuth.
Documentación (Azure DevOps)	Indexe y busque sus wikis de Azure DevOps.

Con estos conectores, el agente puede buscar código para ver patrones de error y leer documentación wiki. El agente también puede hacer referencia a documentos de API durante la solución de problemas y conectar incidentes a solicitudes de incorporación de cambios relacionadas.

Herramientas de colaboración

Permitir que el agente comunique los resultados a través de los canales que el equipo ya usa.

Conector	Qué proporciona
Enviar notificación (Teams)	Publique resultados y actualizaciones en los canales de Teams.
Enviar correo electrónico (Outlook)	Resúmenes e informes de investigación de correo electrónico.

Conectores personalizados (servidores MCP)

Con los servidores de Model Context Protocol (MCP), puede conectar su agente a cualquier sistema, incluidas plataformas de observabilidad, repositorios de código fuente, sistemas de gestión de tickets y API personalizadas. El agente detecta automáticamente las herramientas de los servidores conectados, supervisa el estado de la conexión mediante señales de latido cada 60 segundos y se recupera automáticamente de fallos transitorios.

Dos tipos de transporte cubren cada modelo de implementación: Streamable-HTTP para servicios en la nube remotos y stdio para los procesos locales que se ejecutan junto con el agente. Los conectores de asociados preconfigurados para recursos como GitHub, Datadog, Splunk y New Relic proporcionan una configuración con un solo clic.

Para consultar una guía completa de la arquitectura de MCP, los tipos de transporte, los conectores de socios, la monitorización del estado y la administración de herramientas, consulte Conectores y herramientas de MCP.

Para configurar el primer conector MCP, consulte Configuración del conector MCP.

Examinar y administrar conectores

Para ver los conectores organizados en grupos de categorías plegables, vaya a Builder>Conectores. En esta página, todos los grupos se expanden de forma predeterminada.

Category	Qué incluye
Repositorio de código	GitHub, Azure DevOps, código fuente y conectores de documentación.
Notificación	Conectores de mensajería de Teams y Outlook
Telemetry	Azure Data Explorer, Datadog, Dynatrace, Elasticsearch, New Relic, Splunk y otros conectores de supervisión.
Other	Servidores y conectores MCP genéricos que no se ajustan a otras categorías.

Cada encabezado de categoría muestra el número de conectores de ese grupo. Al contraer una categoría, aparece una notificación roja si algún conector de ese grupo tiene un problema de conexión. Puede detectar problemas de un vistazo sin expandir cada sección.

Use los controles de la barra de herramientas para administrar la vista:

• Expandir todo / Contraer todo: para cambiar todos los grupos de categorías a la vez.
• Filtro de categoría para mostrar solo conectores en una categoría específica.
• Busque conectores por nombre (cambie a una lista plana para la búsqueda de palabras clave).

Solo se muestran las categorías que contienen al menos un conector. Al buscar un conector por nombre, la página cambia a una vista de lista plana para un filtrado más rápido.

Quién puede configurar conectores

Para administrar un conector, necesita tener permiso de escritura en el agente. En la tabla siguiente se muestra qué rol tiene este permiso:

Función	¿Puede configurar conectores?
Administrador del agente de SRE	Sí
Usuario estándar del agente SRE	No (solo visualización)
Lector de SRE Agent	No (solo visualización)

Durante la instalación, algunos conectores requieren el consentimiento de OAuth de un usuario que tiene los permisos adecuados en el sistema externo (por ejemplo, un miembro de la organización de GitHub para conectores de GitHub). Este consentimiento se refiere a los permisos en el servicio externo, no a los roles del agente SRE.

Para los conectores que usan la identidad administrada del agente (como Azure Data Explorer), un administrador del sistema externo debe incluir la identidad en la lista de permitidas.

Al configurar conectores, todos los usuarios del agente se benefician de ellos automáticamente. Simplemente le hacen preguntas al agente y este usa los conectores disponibles en segundo plano.

Conectores y agentes personalizados

Puede asignar herramientas de MCP específicas a agentes personalizados especializados. Un agente personalizado de solución de problemas de bases de datos podría obtener herramientas de Kusto, mientras que un agente personalizado de implementación podría obtener acceso a GitHub. Este enfoque mantiene enfocado a cada agente personalizado y evita que se sobrecargue con demasiadas herramientas.

Asigne herramientas individualmente en el selector de herramientas del portal o use patrones comodín (connection-id/*) en YAML para agregar todas las herramientas de un servidor a la vez. Para más información sobre la asignación de herramientas y la sintaxis de caracteres comodín, consulte Conectores y herramientas de MCP.

En el portal, vaya a Builder>Generador de agentes personalizados. Cree o edite un agente personalizado y, en Configuración avanzada, seleccione Elegir herramientas. El selector de herramientas muestra las herramientas agrupadas por conexión MCP. Seleccione aquellas que su agente personalizado necesita.

En YAML, enumere cada herramienta por su nombre completo:

mcp_tools:
  - azure-data-explorer_kusto_query
  - azure-data-explorer_kusto_table_list
  - azure-data-explorer_kusto_table_schema

Agregar todas las herramientas desde un servidor MCP (comodín)

Cuando un servidor MCP expone muchas herramientas y el agente personalizado necesita todos ellos, use el patrón comodín en lugar de enumerar cada herramienta individualmente:

mcp_tools:
  - azure-data-explorer/*

El {connection-id}/* patrón agrega todas las herramientas de esa conexión MCP. El agente expande el comodín al iniciarse. Por ejemplo, azure-data-explorer/* se resuelve en todas las herramientas registradas en una conexión denominada azure-data-explorer (el valor predeterminado preconfigurado para el Azure MCP con Kusto a partir de la versión 26.4.16.0). Sustituya el nombre que haya dado al conector.

Puede combinar caracteres comodín con nombres de herramientas individuales:

mcp_tools:
  - azure-data-explorer/*  # All tools from the Kusto connection
  - grafana-mcp_dashboard  # One specific tool from Grafana

Nota:

El patrón debe usar {connection-id}/* con la barra diagonal. Los patrones como azure-data-explorer* (sin la barra diagonal) se tratan como nombres exactos de herramientas, no comodines.

En la tabla siguiente se compara la selección de herramientas individuales y el enfoque de comodín.

Enfoque	Cuándo se deben usar
Herramientas individuales	Desea un control preciso sobre las herramientas a las que puede acceder un agente personalizado.
Carácter comodín (connection-id/*)	Confía en el servidor MCP y quiere usar todas sus herramientas, incluidas las que se añadan más adelante.
Mixto	Quiere todas las herramientas de un servidor y, además, herramientas específicas de otro servidor.

¿Por qué usar el carácter comodín? Cuando un servidor MCP agrega nuevas herramientas, el comodín las detecta automáticamente sin volver a configurar el agente personalizado. La selección individual de herramientas le proporciona un control preciso. El carácter comodín proporciona cobertura automática.

Cuando las herramientas de MCP aún no están listas

Si un servidor MCP no está listo cuando se inicia el agente, el agente no puede acceder a las herramientas desde ese servidor. El agente maneja esta condición elegantemente. Pospone los agentes personalizados que contengan comodines sin resolver o a los que les falten herramientas, y los carga automáticamente una vez que su agente establece la conexión con MCP. No es necesario realizar ninguna acción manual.

Para obtener más información, consulte Agentes personalizados.

Paso siguiente

Configuración de un conector MCP

Contenido relacionado

Recurso	¿Por qué es importante?
Plataformas de gestión de incidentes	Cómo su agente recibe y responde automáticamente a incidentes.
Conexión del código fuente	Configure conectores GitHub o Azure DevOps.
Configuración de un conector MCP	Agregue servidores MCP personalizados.
Agentes personalizados	Cree agentes especializados con acceso específico a conectores.
Permisos	Configure el acceso a los recursos de Azure para su agente.