Conecte um serviço de código-fonte

Dê ao seu agente acesso ao repositório, problema 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 de Acesso ao Código (Builder > Code Access), não o assistente gerenciado do conector. 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 Conecte um serviço de notificação.

Conectores de código-fonte

Conector Serviço Authentication Uso típico
GitHub GitHub e GitHub Enterprise Cloud Aplicativo de GitHub Traga seu próprio (OAuth e PAT também suportados para github.com) Leia repositórios, edições e pull requests entre projetos e organizações; Crie problemas ou pull requests com aprovação
Azure DevOps Azure DevOps Identidade gerenciada (OAuth e PAT também suportados) Ler repositórios e pull requests entre projetos; Crie pull requests ou itens de trabalho com aprovação
GitLab GitLab PAT (token de acesso pessoal) Leia repositórios, edições e solicitações de fusão; Crie questões 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: Acesso ao Código Aberto

  1. Vá para sre.azure.com e selecione seu agente.
  2. Na barra lateral esquerda, expanda o Construtor e depois selecione Acesso ao Código.
  3. Selecione a aba do seu serviço (GitHub, Azure DevOps ou GitLab).
  4. Selecione Adicionar repositório.

Passo 2: Autenticar

A janela de diálogo Adicionar repositórios começa com um assistente de três etapas: Escolha uma plataforma → Autenticar → Adicionar repositórios. Selecione Avançar depois de cada etapa. O passo final tem um botão de Salvar .

Use o Bring Your Own GitHub App para GitHub Enterprise Cloud ou para definir o acesso por organização ou instalação.

  1. Em Métodos de Login, escolha Trazer seu próprio aplicativo GitHub.
  2. Complete os campos de configuração do app mostrados pelo assistente.
  3. Selecione Próximo.

GitHub Enterprise Cloud (.ghe.com) requer uma conexão com o GitHub App. Por github.com, Sua conta (OAuth, se configurada para o seu ambiente) ou um token de acesso pessoal também são suportados, embora a opção GitHub App seja preferida para cenários de produção para permitir permissões mais detalhadas e visibilidade de auditoria.

Após a conexão, o agente pode buscar repositórios, issues e pull requests entre projetos e organizações às quais seu aplicativo ou conta tem acesso.

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

Passo 3: Adicionar repositórios

A etapa Adicionar repositórios mostra uma tabela onde você especifica quais repositórios o agente indexa. Cada linha é um repositório.

  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. Na coluna URL do Repositório , selecione um repositório no menu suspenso ou digite uma URL diretamente. Para GitHub e GitLab, o menu suspenso lista repositórios que suas credenciais podem acessar. Para Azure DevOps, ele lista repositórios no projeto selecionado.

  3. Na coluna Nome de exibição , insira um nome curto que o agente usa para se referir ao repositório.

  4. Opcionalmente, preencha a coluna Descrição para dar ao agente mais contexto sobre o que o repositório contém.

  5. Se seu serviço for Azure DevOps e o repositório for muito grande, ative a caixa de seleção Remoto. O agente usa busca baseada em IA na cópia remota em vez de cloná-la localmente. Repositórios são clonados com um limite de disco de 100 GB; ativar o Remote evita essa restrição.

  6. Para adicionar outro repositório, selecione Adicionar e preencha a próxima linha.

  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 de leitura, 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.
Criar falha com erro de permissão O token ou conta não possui escopo de escrita Conceda o escopo necessário para o token ou conta, ou use credenciais que tenham acesso por escrita.
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 Trazer seu próprio aplicativo GitHub como método de autenticação.

Conteúdo relacionado

  • Last updated on