Passo 3: Ligar o código-fonte no Azure SRE Agent

Liga o teu repositório GitHub ou Azure DevOps. O seu agente pode agora realizar análise de causa raiz correlacionando problemas de produção com código específico.

O que você realiza

No final deste passo, o seu agente:

  • Analisa o código-fonte durante investigações
  • Fornece referências de ficheiro:linha para problemas
  • Cria Planos de Tarefas que mostram os passos da investigação
  • Correlaciona sintomas de produção com alterações no código

Pré-requisitos

Requisito Detalhes
Agente criado Primeiro complete o Passo 1
Conta GitHub ou Azure DevOps Acesso aos repositórios que deseja conectar

Escolha o seu método de autenticação

Método Quando utilizar
OAuth Inicia sessão com a tua conta no GitHub. Não é preciso token e é a configuração mais fácil.
PAT Forneça um Token de Acesso Pessoal com repo escopo. Funciona para organizações com restrições de SSO.

Ligue o seu repositório

Liga um repositório no GitHub para que o teu agente possa indexá-lo como fonte de conhecimento. O diálogo mostra uma lista navegável dos teus repositórios. Selecione da lista suspensa em vez de escrever URLs manualmente.

Passo 1: Abrir o diálogo Adicionar Repositório

Durante a integração, selecione o cartão Adicionar repositório na etapa da Base de Conhecimento.

Para um agente existente, vá a Builder>Base de Conhecimento e selecione o cartão de ação Adicionar repositório.

Passo 2: Escolha uma plataforma

  1. Selecione GitHub ou Azure DevOps.

  2. Escolha o seu método de iniciação de sessão:

    Método Quando utilizar
    Auth (OAuth) Inicie sessão com a sua conta GitHub ou Azure DevOps. Não é necessário nenhum token.
    PAT Fornecer um Token de Acesso Pessoal com repo âmbito
  3. Autenticação completa:

    • OAuth: Selecione Iniciar sessão no GitHub ou Iniciar sessão no Azure DevOps e conclua o processo de autenticação.
    • PAT: Introduza o seu token no campo Fornecer PAT e selecione Conectar.

    Observação

    Se o diálogo de iniciar sessão não aparecer, verifique se o seu navegador não está a bloquear pop-ups de sre.azure.com.

  4. Confirme o resultado: aparece um cartão Connected a mostrar a sua conta autenticada.

  5. Selecione Avançar.

Passo 3: Selecionar repositórios

Após a autenticação, o campo URL do Repositório mostra uma lista suspensa dos seus repositórios:

  • Os repositórios do GitHub aparecem como org/repo-name, ordenados alfabeticamente (até 100 repositórios).

  • Os repositórios Azure DevOps aparecem depois de selecionar um projeto no menu suspenso Azure DevOps Project, e são ordenados alfabeticamente.

Selecione um repositório no menu suspenso. O nome de exibição completa-se automaticamente com o nome do repositório. Também pode escrever qualquer URL válida do repositório diretamente no campo.

Para adicionar múltiplos repositórios, selecione Adicionar para inserir mais linhas.

Sugestão

O menu suspenso permite digitação livre. Se o seu repositório não aparecer na lista (por exemplo, se tiver mais de 100 repositórios), escreva o URL completo diretamente.

Passo 4: Confirmar e guardar

Selecione Adicionar repositório para guardar.

O sistema cria automaticamente o conector GitHub OAuth ou Azure DevOps OAuth apropriado, caso ainda não exista.

Passo 5: Tente criar um pull request (pré-visualização)

Com o seu repositório ligado, o seu agente pode agora criar pull requests diretamente a partir do chat.

  1. Abre um chat com o teu agente.
  2. Escreve um prompt como: "Criar um PR em https://github.com/OWNER/REPO do fix/my-branch para main com o título 'Corrigir tempo limite de conexão'".
  3. No modo de Revisão, selecione Continuar para aprovar a criação da PR.

O seu agente devolve um cartão de ferramenta com um link clicável para o PR criado.

Observação

A criação de pull requests requer Revisão ou modo de execução automático. O branch de origem já deve existir com as tuas alterações cometidas.

Gerir repositórios ligados

Quando reabre o diálogo Adicionar Repositório , os repositórios ligados existentes aparecem como linhas de apenas leitura na grelha.

Para remover um repositório:

Use os seguintes passos para remover um repositório ligado.

  1. Vai à Base de Conhecimento do Construtor> e seleciona a carta de ação Adicionar repositório.

  2. Encontre a linha do repositório na grelha.

  3. Selecionar o ícone de lixo na linha para marcá-la para remoção.

  4. Selecione Adicionar repositório para guardar alterações.

  5. Aparece uma janela de diálogo Confirmar alterações que lista os repositórios removidos.

  6. Selecione Confirmar para prosseguir ou Cancelar para os manter.

Para atualizar a autenticação: Se o seu PAT expirar ou precisar de mudar de conta, reabra o diálogo Adicionar Repositório e autentifique novamente com novas credenciais.


Alternativa: MCP + agente aduaneiro

Para obter acesso completo à API do GitHub (pesquisar código, ler ficheiros e listar commits em todos os repositórios), liga o GitHub como um servidor MCP com um agente personalizado dedicado.

Esta abordagem utiliza o Model Context Protocol (MCP) para ligar ferramentas do GitHub a um agente personalizado. Siga o tutorial passo a passo, Configurar o Conector MCP.

O seu agente agora analisa o código-fonte durante as investigações, fornece referências de ficheiros e linhas para problemas, cria Planos de Tarefas que mostram passos de investigação, correlaciona sintomas de produção com alterações no código e pode criar pull requests em repositórios conectados diretamente a partir do chat.

O que aprendeu

  • O seu agente agora analisa o código-fonte durante as investigações.
  • Fornece referências a ficheiros e linhas para problemas.
  • Cria Planos de Tarefas que indicam os passos da investigação.
  • Correlaciona os sintomas de produção com alterações no código.

Resource Description
Análise de causa raiz Como o teu agente usa o código-fonte para encontrar as causas raiz.
Investigação aprofundada Análise multihipótese estendida usando repositórios conectados.
Agente Playground Teste ferramentas MCP e agentes personalizados de forma interativa.
Agentes aduaneiros Como os agentes personalizados expandem as capacidades do seu agente.
Conectores Todos os tipos de conectores e como funcionam.