Conectores no Azure SRE Agent

Seu agente vem com acesso interno aos serviços de Azure. Ele pode consultar Azure Monitor, Application Insights, Log Analytics e Azure Resource Graph. Os conectores estendem esse alcance para sistemas externos: clusters kusto, repositórios de código-fonte, ferramentas de colaboração e APIs personalizadas.

O que seu agente pode fazer sem conectores

Mesmo sem conectores configurados, seu agente tem recursos internos via identidade gerenciada e permissões de controle de acesso baseado em função do Azure (RBAC do Azure):

O Resource Graph e as operações de Resource Manager funcionam com qualquer tipo de recurso Azure, incluindo Serviço de Aplicativo do Azure, Aplicativos de Contêiner do Azure, máquinas virtuais, rede e armazenamento. Se seus logs e métricas estiverem ativos no Azure Monitor e no Application Insights, seu agente poderá começar a investigar problemas imediatamente, sem a necessidade de instalação do conector. Os conectores se tornam valiosos quando você precisa que o agente alcance sistemas outside Azure.

O que os conectores fornecem

Os conectores se enquadram em quatro categorias com base no que dão ao agente: fontes de dados, código-fonte e conhecimento, ferramentas de colaboração e conectores personalizados.

Fontes de dados

Essas fontes podem ser logs de consulta, métricas e telemetria dos seus repositórios de dados.

Código-fonte e conhecimento

Forneça o contexto do agente sobre seus sistemas: código, wikis e documentação.

Com esses conectores, seu agente pode pesquisar o código em busca de padrões de erro e ler a documentação wiki. Seu agente também pode referenciar documentos de API durante a solução de problemas e conectar incidentes a solicitações de pull relacionadas.

Ferramentas de colaboração

Permitir que seu agente comunique as descobertas por meio dos canais que sua equipe já usa.

Conectores personalizados (servidores MCP)

Com servidores MCP (Model Context Protocol), você pode conectar seu agente a qualquer sistema, incluindo plataformas de observabilidade, repositórios de código-fonte, sistemas de tíquete e APIs personalizadas. Seu agente descobre de forma automática ferramentas de servidores conectados, monitora a integridade da conexão com pulsações de 60 segundos e se recupera automaticamente de falhas temporárias.

Dois tipos de transporte abrangem cada modelo de implantação: Streamable-HTTP para serviços de nuvem remota e stdio para processos locais em execução junto com seu agente. Conectores de parceiros pré-configurados para recursos como GitHub, Datadog, Splunk e New Relic permitem configuração com um clique.

Para obter um guia completo sobre arquitetura MCP, tipos de transporte, conectores de parceiros, monitoramento de integridade e gerenciamento de ferramentas, consulte conectores e ferramentas do MCP.

Para configurar seu primeiro conector MCP, consulte Configurar o conector MCP.

Procurar e gerenciar conectores

Para ver seus conectores organizados em grupos de categorias recolhíveis, vá para Builder>Connectors. Nesta página, todos os grupos são expandidos por padrão.

Cada cabeçalho de categoria mostra o número de conectores nesse grupo. Quando você recolher uma categoria, um selo vermelho será exibido se algum conector nesse grupo tiver um problema de conexão. Você pode detectar problemas rapidamente sem expandir todas as seções.

Use os controles da barra de ferramentas para gerenciar sua exibição:

• Expandir tudo/Recolher tudo: para alternar todos os grupos de categorias de uma vez.
• Filtro de categoria para mostrar apenas conectores em uma categoria específica.
• Pesquise para localizar conectores por nome (alterna para uma lista simples para pesquisa de palavra-chave).

Somente as categorias que contêm pelo menos um conector são exibidas. Quando você procura um conector por nome, a página alterna para uma exibição de lista simples para filtragem mais rápida.

Quem pode configurar conectores

Para gerenciar um conector, você precisa de permissão de gravação no agente. A tabela a seguir mostra qual função tem essa permissão:

Durante a instalação, alguns conectores exigem o consentimento do OAuth de um usuário que tem as permissões certas no sistema externo (por exemplo, um membro da organização GitHub para conectores GitHub). Esse consentimento é sobre permissões no serviço externo , não funções do Agente SRE.

Para conectores que usam a identidade gerenciada do agente (como o Azure Data Explorer), um administrador do sistema externo deve listar a identidade, conforme permitido.

Quando você configura conectores, todos os usuários do agente se beneficiam deles automaticamente. Eles apenas fazem perguntas ao agente e o agente usa os conectores disponíveis nos bastidores.

Conectores e agentes personalizados

Você pode atribuir ferramentas mcp específicas a agentes personalizados especializados. Um agente personalizado de solução de problemas de banco de dados pode obter ferramentas do Kusto, enquanto um agente personalizado de implantação obtém acesso GitHub. Essa abordagem mantém cada agente personalizado focado e evita sobrecarregá-lo com muitas ferramentas.

Atribua ferramentas individualmente no seletor de ferramentas do portal ou use padrões curinga (connection-id/*) no YAML para adicionar todas as ferramentas de um servidor ao mesmo tempo. Para obter detalhes sobre a atribuição de ferramentas e a sintaxe de curinga, consulte conectores e ferramentas do MCP.

No portal, vá para Builder>Construtor de agente personalizado. Crie ou edite um agente personalizado e, em Configurações avançadas, selecione Escolher ferramentas. O seletor de ferramentas exibe as ferramentas agrupadas pela conexão MCP. Selecione os que seu agente personalizado precisa.

No YAML, liste cada ferramenta pelo nome completo:

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

Adicionar todas as ferramentas de um servidor MCP (curinga)

Quando um servidor MCP expõe muitas ferramentas e seu agente personalizado precisa de todas elas, use o padrão curinga em vez de listar cada ferramenta individualmente:

mcp_tools:
  - azure-data-explorer/*

O {connection-id}/* padrão adiciona todas as ferramentas dessa conexão MCP. Seu agente expande o curinga na inicialização. Por exemplo, azure-data-explorer/* resolve para todas as ferramentas registradas na conexão chamada azure-data-explorer (o padrão preenchido para o MCP do Azure com o conector Kusto a partir da versão 26.4.16.0). Substitua o nome que você deu ao conector.

Você pode combinar curingas com nomes de ferramentas individuais:

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

A tabela a seguir compara a seleção individual de ferramentas e a abordagem curinga.

Por que usar o curinga? Quando um servidor MCP adiciona novas ferramentas, o curinga as detecta automaticamente, sem precisar reconfigurar seu agente personalizado. A seleção de ferramentas individuais fornece controle preciso. O curinga fornece cobertura automática.

Quando as ferramentas MCP ainda não estiverem prontas

Se um servidor MCP não estiver pronto quando o agente for iniciado, seu agente não poderá acessar ferramentas desse servidor. Seu agente lida com essa condição normalmente. Ele adia agentes personalizados com curingas não resolvidos ou ferramentas ausentes, e os carrega automaticamente após o agente estabelecer a conexão MCP. Você não precisa tomar nenhuma ação manual.

Para obter mais informações, consulte Agentes personalizados.

Próxima etapa

Conteúdo relacionado