Conectores no Agente SRE do Azure

O seu agente vem com acesso integrado aos serviços do Azure. Pode consultar Azure Monitor, Application Insights, Log Analytics e Azure Resource Graph. Os conectores estendem esse alcance a sistemas externos: os seus clusters Kusto, repositórios de código-fonte, ferramentas de colaboração e APIs personalizadas.

O que o seu agente pode fazer sem conectores

Mesmo sem conectores configurados, o seu agente tem capacidades integradas através da sua identidade gerida e das permissões Azure RBAC:

As operações Azure Resource Graph e ARM funcionam com qualquer tipo de recurso Azure incluindo Serviços de Aplicações, Aplicações de Container, VMs, redes, armazenamento e muito mais. Se os seus registos e métricas estiverem no Azure Monitor e no Application Insights, o seu agente pode começar a investigar problemas imediatamente – sem necessidade de configuração de conectores. Os conectores tornam-se valiosos quando precisa que o agente alcance sistemas fora de Azure.

O que os conectores fornecem

Os conectores dividem-se em quatro categorias com base no que fornecem ao seu agente:

Fontes de dados

Consulta logs, métricas e telemetria dos seus repositórios de dados.

Código-fonte e conhecimento

Dá ao teu agente contexto sobre os teus sistemas — código, wikis e documentação.

Com estes conectores, o seu agente pode pesquisar código por padrões de erro, ler a documentação da wiki, consultar documentos da API durante a resolução de problemas e ligar incidentes a pull requests relacionados.

Ferramentas de colaboração

Deixe o seu agente comunicar as descobertas através dos canais que a sua equipa já utiliza.

Conectores personalizados (servidores MCP)

O MCP (Model Context Protocol) permite-lhe ligar o seu agente a qualquer sistema, incluindo plataformas de observabilidade, repositórios de código-fonte, sistemas de tickets e APIs personalizadas. O seu agente descobre automaticamente ferramentas nos servidores conectados, monitoriza a saúde da ligação com batimentos cardíacos de 60 segundos e recupera automaticamente de falhas temporárias.

Dois tipos de transporte cobrem todos os modelos de implementação: Streamable-HTTP para serviços cloud remotos e stdio para processos locais a correr juntamente com o seu agente. Conectores parceiros pré-configurados para GitHub, Datadog, Splunk, New Relic e outros proporcionam uma configuração com um clique.

Para um guia completo sobre arquitetura MCP, tipos de transporte, conectores parceiros, monitorização de saúde e gestão de ferramentas, consulte conectores e ferramentas MCP.

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

Navegação e gestão de conectores

Abra a página de Conectores (Builder > Conectores) para ver os seus conectores organizados em grupos de categorias expansíveis. Todos os grupos são expandidos por padrão.

Cada cabeçalho de categoria mostra o número de conectores nesse grupo. Ao colapsar uma categoria, surge um selo vermelho se algum conector desse grupo tiver um problema de conexão. Consegues reparar problemas num relance sem expandir cada secção. Use os controlos da barra de ferramentas para gerir a sua visualização:

• Expandir tudo / Colapsar tudo para alternar todos os grupos de categorias ao mesmo tempo.
• Filtro de categoria para mostrar apenas conectores numa categoria específica.
• Procura para encontrar conectores por nome (muda para uma lista plana para pesquisa por palavras-chave).

Apenas as categorias que contêm pelo menos um conector são exibidas. Quando procuras um conector pelo nome, a página muda para uma vista de lista plana para filtragem mais rápida.

Quem pode configurar conectores

A gestão de conectores requer permissão para escrever no agente. Na prática:

Durante a fase de configuração, alguns conectores requerem consentimento OAuth de um utilizador que tenha as permissões corretas no sistema externo (por exemplo, um membro da organização GitHub para conectores GitHub, ou um administrador do Azure AD para Outlook/Teams). Este consentimento diz respeito a permissões no serviço externo , não a funções de Agente SRE.

Para conectores que utilizam a identidade gerida do agente (como Azure Data Explorer), um administrador do sistema externo deve permitir listar a identidade.

Quando configuras conectores, todos os utilizadores agentes beneficiam automaticamente deles. Eles apenas fazem perguntas ao agente e usam os conectores disponíveis nos bastidores.

Conectores e agentes aduaneiros

Pode atribuir ferramentas MCP específicas a agentes personalizados especializados. Um agente personalizado de resolução de dados pode obter ferramentas Kusto, enquanto um agente personalizado de implementação recebe acesso ao GitHub. Esta abordagem mantém cada agente personalizado focado e evita sobrecarregá-lo com demasiadas ferramentas.

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

No portal, vai a Builder>Custom agent builder, cria ou edita um agente personalizado e seleciona Escolher ferramentas em definições avançadas. O seletor de ferramentas apresenta ferramentas agrupadas por ligação MCP. Selecione os que o seu agente personalizado precisa.

No YAML, liste cada ferramenta pelo seu 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 (wildcard)

Aplica-se a: versão 26.2.9.0 e posteriores

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

mcp_tools:
  - azure-data-explorer/*

O {connection-id}/* padrão adiciona todas as ferramentas dessa ligação MCP. O seu agente expande o 'wildcard' no arranque. Por exemplo, azure-data-explorer/* corresponde a todas as ferramentas registadas numa ligação chamada azure-data-explorer (já preenchido para o MCP do Azure com conector Kusto desde a versão 26.4.16.0). Substitua por qualquer nome que tenha atribuído ao seu conector.

Pode combinar caracteres universais com nomes individuais de ferramentas:

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

A tabela seguinte compara a seleção individual de ferramentas e a abordagem do coringa.

Por que usar o coringa? Quando um servidor MCP adiciona novas ferramentas, o wildcard recolhe-as automaticamente sem reconfigurar o seu agente personalizado. A seleção individual de ferramentas dá-lhe controlo preciso. O wildcard dá-te cobertura automática.

Quando as ferramentas MCP ainda não estiverem prontas

Se um servidor MCP não estiver pronto quando o seu agente inicia, o seu agente não pode aceder às ferramentas desse servidor. O seu agente lida com esta situação com elegância. Atrasa os agentes personalizados com caracteres universais não resolvidos ou ferramentas em falta e carrega-os automaticamente tão logo que o seu agente estabelece a ligação MCP. Não precisas de fazer qualquer ação manual.

Para mais informações, consulte Agentes Alfandegários.

Próximo passo

Conteúdo relacionado