Conecte um serviço de código-fonte

Dê ao seu agente acesso ao repositório, issue e contexto de pull request para investigações. Ele pode ler mudanças recentes, encontrar problemas relacionados e abrir um issue ou pull request no repositório ou projeto correto quando a credencial que você fornecer permitir.

Este tutorial cobre GitHub, Azure DevOps e GitLab. Conexões de código-fonte usam a página Acesso ao Código (Build + setup > Contexto > Acesso ao Código), não o assistente de conectores gerenciados. Este artigo foca nos detalhes do código-fonte: como cada serviço se autentica e como validar a conexão.

Pré-requisitos

  • Um Agente SRE em execução e acesso a sre.azure.com.
  • Permissão para configurar o agente.
  • Uma conta no serviço com acesso aos repositórios ou projetos que o agente deve ler.

Para serviços de notificação, veja Conectar um serviço de notificação.

Conectores de código-fonte

Conector Serviço Authentication Uso típico
GitHub GitHub e GitHub Enterprise Cloud Use seu próprio aplicativo GitHub (OAuth e PAT também são compatíveis com github.com) Leia repositórios, issues e pull requests em projetos e organizações; crie issues ou pull requests com aprovação
Azure DevOps Azure DevOps Identidade gerenciada (OAuth e PAT também suportados) Ler repositórios e solicitações de pull entre projetos; criar solicitações de pull ou itens de trabalho com aprovação
GitLab GitLab PAT (token de acesso pessoal) Ler repositórios, problemas e solicitações de mesclagem; criar problemas e comentários com aprovação

GitHub e Azure DevOps apresentam opções de autenticação como botões de opção. O GitLab usa um token de acesso pessoal.

Passo 1: Abrir o Acesso ao Código

  1. Vá para sre.azure.com e selecione seu agente.
  2. Na barra lateral esquerda, selecione Criar + configurar>Contexto>Acesso do código.
  3. Selecione a aba do seu serviço (GitHub, Azure DevOps ou GitLab).
  4. Selecione Adicionar repositório.

Passo 2: Autenticar

O diálogo Adicionar repositórios tem duas etapas: Conexão e Adicionar repositórios. Em Conexão, escolha a plataforma e insira a URL do repositório ou da organização antes de configurar a autenticação. Selecione Próximo após conectar, depois salve na etapa final.

Selecione Usar seu aplicativo GitHub para GitHub Enterprise Cloud ou para escopar o acesso por organização ou instalação.

  1. Insira uma URL completa do Repositório, como https://github.com/owner/repo.
  2. Se existir uma credencial correspondente, selecione Conexão existente para reutilizá-la ou Nova conexão para configurar outra.
  3. Em Método de conexão, escolha Usar seu aplicativo GitHub.
  4. Complete os campos de configuração do app mostrados pelo assistente.
  5. Selecione Conectar e confirme se a conexão é bem-sucedida.
  6. Selecione Próximo.

O GitHub Enterprise Cloud (.ghe.com) requer uma conexão com o aplicativo GitHub. Para github.com, OAuth e token de acesso pessoal (PAT) também são suportados. A autenticação do aplicativo GitHub requer um URI de chave de Key Vault RSA (/keys/), não um URI secreto. Veja Configurar o GitHub BYO App.

Após se conectar, o agente pode buscar repositórios, issues e pull requests em projetos e organizações aos quais seu aplicativo ou conta tem acesso.

O serviço vê a identidade que autorizou a conexão. Problemas, comentários e atividades de solicitação de pull criados pelo agente aparecem nessa conta.

Passo 3: Adicionar repositórios

Analise os repositórios a serem adicionados. Para o GitHub, expanda cada repositório para editar seu nome de exibição e descrição. Para Azure DevOps e GitLab, edite esses campos diretamente na tabela.

  1. Se seu serviço for Azure DevOps, primeiro selecione um project no menu suspenso Azure DevOps Project. A coluna URL do Repositório é preenchida com repositórios nesse projeto.

  2. Analise o URL do repositório inicial. Para mais entradas, selecione um repositório no menu suspenso ou digite uma URL diretamente. Para Azure DevOps, selecione o projeto primeiro.

  3. Insira um nome de exibição curto que o agente usa para se referir ao repositório. Para o GitHub, expanda a entrada para encontrar esse campo.

  4. Opcionalmente, insira uma Descrição para dar mais contexto ao agente sobre o repositório. Para o GitHub, primeiro selecione Adicionar descrição.

  5. Se seu ambiente Azure DevOps oferecer uma opção Remote, você pode usá-la para busca baseada em IA sem clonar o repositório completo. Essa opção não está disponível em todos os ambientes.

  6. Para adicionar outro repositório, selecione Adicionar repositório para GitHub ou Adicionar na grade do Azure DevOps ou do GitLab. Repositórios adicionais do GitHub nessa conexão usam o mesmo host e credencial.

  7. Quando a tabela estiver completa, selecione Salvar.

Passo 4: Valide com um cenário

  1. Abra um chat com seu agente.

  2. Faça uma pergunta lida, como:

    List the open issues in the payments repository from the last week.
    
  3. Verifique o cartão de ferramentas para ver o agente pesquisar no serviço e devolver resultados baseados nos seus dados.

Quando surgem resultados que fazem referência ao seu repositório, a conexão funciona de ponta a ponta.

Troubleshooting

Problema Cause Corrigir
A pesquisa não retorna resultados A conta não tem acesso ao projeto ou repositório Confirme se a conta de conexão pode ver o projeto ou repositório, então tente novamente.
A criação falha devido a um erro de permissão O token ou conta não possui escopo de gravação Conceda o escopo necessário para o token ou conta, ou use credenciais que tenham acesso de gravação.
O GitHub Enterprise Cloud rejeita a conexão O GitHub Enterprise Cloud requer uma conexão com o GitHub App Na página de Acesso ao Código, desconecte a conexão do GitHub, selecione Adicionar repositório, escolha GitHub, insira seu .ghe.com host e selecione Bring your own GitHub App como método de autenticação.