Etapa 3: Conectar o código-fonte no Agente SRE do Azure

Conecte seu repositório GitHub ou Azure DevOps. Agora, o agente pode executar a análise de causa raiz correlacionando problemas de produção a um código específico.

O que você realiza

Ao final desta etapa, seu agente:

  • Analisa o código-fonte durante investigações
  • Fornece referências de arquivo:linha para os problemas
  • Cria planos de tarefas que mostram as etapas de investigação
  • Correlaciona sintomas de produção a alterações de código

Pré-requisitos

Requisito Detalhes
Agente criado Concluir a Etapa 1 primeiro
Conta do GitHub ou do Azure DevOps Acesso aos repositórios que você deseja conectar

Escolha seu método de autenticação

Método Quando usar
Aplicativo GitHub Use um aplicativo gerenciado pela organização com uma chave de assinatura respaldada pelo Key Vault. Necessário para *.ghe.com.
Identidade Gerenciada Conecte o Azure DevOps sem uma credencial de usuário de longa duração.
OAuth Entre com sua conta do GitHub ou do Azure DevOps.
PAT Forneça um token de acesso pessoal com as permissões mínimas exigidas pelo serviço alvo.

Conectar seu repositório

Conecte um repositório GitHub para que seu agente possa indexá-lo como uma fonte de conhecimento. A caixa de diálogo mostra uma lista acessível de seus repositórios. Selecione a partir do menu suspenso em vez de digitar URLs manualmente.

Etapa 1: Abrir a caixa de diálogo Adicionar Repositório

Durante o onboarding, selecione o cartão Adicionar repositório na etapa Base de Conhecimento.

Para um agente existente, acesse Build + configuração>Contexto>Acesso do código, escolha a guia de serviço e selecione Adicionar repositório.

Etapa 2: Escolher uma plataforma

  1. Selecione GitHub ou Azure DevOps.

  2. Na etapa Conexão, insira a URL do repositório completa para GitHub ou o nome da Organização para Azure DevOps.

  3. Escolha uma conexão existente, se houver disponível, ou configure uma nova conexão.

  4. Selecione o método de autenticação e complete seus campos. O GitHub oferece OAuth, token de acesso pessoal (PAT) e Use seu GitHub App. O Azure DevOps oferece Sua Conta, Identidade Gerenciada e PAT.

  5. Complete o teste de login ou conexão mostrado pelo método selecionado. Para instruções específicas de cada método, veja Conecte um serviço de código-fonte.

    Observação

    Se a janela de login não aparecer, verifique se o seu navegador não está bloqueando janelas pop-up do sre.azure.com.

  6. Confirme se a conexão foi bem-sucedida.

  7. Selecione Próximo.

Etapa 3: Selecionar repositórios

Em Adicionar repositórios, revise o repositório inicial e adicione mais entradas conforme necessário. O campo URL do Repositório suporta a seleção do repositório e a entrada direta de URL:

  • Os repositórios do GitHub aparecem como org/repo-name, classificados em ordem alfabética (até 100 repositórios).

  • Repositórios do Azure DevOps são exibidos depois que você seleciona um projeto no menu suspenso Azure DevOps Project, ordenados em ordem alfabética.

Selecione um repositório na lista suspensa. O nome De exibição é compilado automaticamente com o nome do repositório. Você também pode digitar qualquer URL de repositório válida diretamente no campo.

Para o GitHub, selecione Adicionar repositório para adicionar repositórios. Expanda cada entrada para editar seu nome de exibição ou use Adicionar descrição. Para Azure DevOps, use Adicionar e edite esses campos na grade.

Dica

O menu suspenso permite digitar livremente. Se o repositório não aparecer na lista (por exemplo, se você tiver mais de 100 repositórios), digite a URL completa diretamente.

Etapa 4: Confirmar e salvar

Clique em Salvar. Os repositórios aparecem na página de acesso ao Código com suas informações de conexão e última sincronização.

Etapa 5: Tente criar uma solicitação de pull (versão prévia)

Com o repositório conectado, o agente agora pode criar solicitações de pull diretamente do chat.

  1. Abra um thread de chat com seu agente.
  2. Digite um comando como: "Crie um PR em https://github.com/OWNER/REPO de fix/my-branch para o main com o título 'Correção do tempo limite de conexão'".
  3. No modo Revisão, selecione Continuar para aprovar a criação do PR.

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

Observação

Criar solicitações de pull requer revisão ou modo de execução autônomo. O branch de origem já deve existir com suas alterações confirmadas.

Gerenciar repositórios conectados

A página de acesso ao código lista repositórios conectados e seus nomes de conexão.

Para remover um repositório:

Use as etapas a seguir para remover um repositório conectado.

  1. Acesse Build + configuração>Contexto>Acesso de código.
  2. Selecione a aba de serviço e a caixa de seleção do repositório.
  3. Selecione Excluir e revise a confirmação antes de prosseguir.

Para atualizar a autenticação: Se o PAT expirar ou você precisar trocar de conta, reabra a caixa de diálogo Adicionar Repositório e autentique novamente com novas credenciais.


Alternativa: MCP + agente personalizado

Para obter acesso completo à API do GitHub (código de pesquisa, arquivos de leitura e confirmações de lista em todos os repositórios), conecte o GitHub como um servidor MCP com um agente personalizado dedicado.

Essa abordagem usa o Protocolo do Contexto do Modelo (MCP) para conectar as ferramentas do GitHub a um agente personalizado. Siga o tutorial passo a passo, configurar o conector MCP.

Seu agente agora analisa o código-fonte durante investigações, fornece referências de arquivo e linha para problemas, cria Planos de Ação mostrando etapas de investigação, correlaciona sintomas observados em produção a alterações de código e pode criar pull requests em repositórios conectados diretamente do chat.

O que você aprendeu

  • Seu agente agora analisa o código-fonte durante as investigações.
  • Fornece referências de arquivo e linha para problemas.
  • Cria Planos de Tarefas que mostram as etapas de investigação.
  • Correlaciona os sintomas de produção às alterações de código.

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