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 de controlo de acesso baseado em funções no Azure (Azure RBAC):

As operações Resource Graph e Resource Manager funcionam com qualquer tipo de recurso Azure, incluindo Serviço de Aplicações do Azure, Azure Container Apps, máquinas virtuais, redes e armazenamento. Se os seus registos e métricas estiverem disponíveis 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 consoante o que oferecem ao seu agente: fontes de dados, código-fonte e conhecimento, ferramentas de colaboração e conectores personalizados.

Fontes de dados

Estas fontes podem ser registos de consulta, 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 padrões de erro no código e ler a documentação da wiki. O seu agente também pode 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)

Com servidores Model Context Protocol (MCP), pode 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 o estado da ligação com sinais periódicos a cada 60 segundos e recupera automaticamente de falhas transitó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 recursos como GitHub, Datadog, Splunk e New Relic 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.

Navegar e gerir conectores

Para ver os seus conectores organizados em grupos de categorias dobráveis, vá a Builder>Connectors. Nesta página, todos os grupos estão expandidos por defeito.

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

Para gerir um conector, precisas de permissão de escrita no agente. A tabela seguinte mostra qual o papel que tem esta permissão:

Durante a configuração, alguns conectores requerem o consentimento OAuth de um utilizador que tenha as permissões corretas no sistema externo (por exemplo, um membro da GitHub org para conectores GitHub). 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 o Azure Data Explorer), um administrador do sistema externo deve indicar a identidade como permitida.

Quando configuras conectores, todos os utilizadores agentes beneficiam automaticamente deles. Eles apenas fazem perguntas ao agente e o agente usa 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 detalhes sobre atribuição de ferramentas e sintaxe de wildcards, veja conectores e ferramentas MCP.

No portal, vai a Builder>Custom agent builder. Crie ou edite um agente personalizado e, em definições avançadas, selecione Escolher ferramentas. 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)

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. Adia o carregamento de agentes personalizados com caracteres universais não resolvidos ou ferramentas em falta e carrega esses agentes automaticamente depois de o seu agente estabelecer 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