Ligue um serviço de código-fonte

Dá ao teu agente acesso ao contexto de repositório, problema e pull request para investigações. Pode ler alterações recentes, encontrar problemas relacionados e abrir um issue ou pull request no repositório ou projeto certo quando a credencial que forneces o permitir.

Este tutorial cobre GitHub, Azure DevOps e GitLab. As ligações ao código-fonte usam a página de Acesso ao Código (Builder > Code Access), não o assistente de conectores geridos. Este artigo foca-se nos detalhes do código-fonte: como cada serviço se autentica e como validar a ligação.

Pré-requisitos

  • Um Agente SRE a correr 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, consulte Ligar um serviço de notificação.

Conectores de código-fonte

Conector Serviço Authentication Uso típico
GitHub GitHub e GitHub Enterprise Cloud Aplicação de GitHub para trazer a sua própria (OAuth e PAT também suportados para github.com) Leia repositórios, edições e pull requests entre projetos e organizações; Criar problemas ou pull requests com aprovação
Azure DevOps Azure DevOps Identidade gerida (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 Token de acesso pessoal (PAT) Ler repositórios, edições e pedidos de fusão; criar questões e comentários com aprovação

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

Passo 1: Acesso ao Código Aberto

  1. Vai a sre.azure.com e escolhe o teu agente.
  2. Na barra lateral esquerda, expande Builder e depois seleciona Acesso ao Código.
  3. Selecione o separador do seu serviço (GitHub, Azure DevOps ou GitLab).
  4. Selecione Adicionar repositório.

Passo 2: Autenticar

O diálogo Adicionar repositórios abre com um assistente de três passos: Escolha uma plataforma → Autenticar → Adicionar repositórios. Selecione Seguinte após cada passo. O passo final tem um botão de Guardar .

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 Iniciação de Sessão, escolha Trazer a sua própria aplicação GitHub.
  2. Preencha os campos de configuração da aplicação mostrados pelo assistente.
  3. Selecione Avançar.

O GitHub Enterprise Cloud (.ghe.com) requer uma ligação à aplicação GitHub. Para github.com, a 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.

Depois de se ligar, o agente pode pesquisar repositórios, issues e pull requests entre projetos e organizações a que a sua aplicação ou conta tem acesso.

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

Passo 3: Adicionar repositórios

O passo Adicionar repositórios mostra uma tabela onde especifica quais repositórios o agente indexa. Cada linha é um repositório.

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

  2. Na coluna URL do Repositório , selecione um repositório no menu suspenso ou escreva diretamente um URL. No GitHub e GitLab, o menu suspenso lista repositórios a que as suas credenciais podem aceder. Para Azure DevOps, lista repositórios no projeto selecionado.

  3. Na coluna Nome de visualizaçã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 o seu serviço for Azure DevOps e o repositório for muito grande, ative a caixa de seleção Remoto. O agente utiliza pesquisa alimentada por IA na cópia remota em vez de a clonar localmente. Os 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 linha seguinte.

  7. Quando a tabela estiver concluída, selecione Guardar.

Passo 4: Validar com um cenário

  1. Abre um chat com o teu agente.

  2. Faça uma pergunta de leitura, como:

    List the open issues in the payments repository from the last week.

  3. Consulte o cartão de ferramentas para ver o agente pesquisar o serviço e devolver resultados baseados nos seus dados.

Quando surgem resultados que fazem referência ao seu repositório, a ligaçã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 Confirma que a conta de ligação consegue ver o projeto ou repositório, depois tenta novamente.
Criar falha devido a um erro de permissão O token ou conta não tem âmbito de escrita Conceda o âmbito necessário ao token ou conta, ou use credenciais que tenham acesso por escrita.
O GitHub Enterprise Cloud rejeita a ligação O GitHub Enterprise Cloud requer uma ligação à aplicação GitHub Na página de Acesso ao Código, desligue a ligação ao GitHub, selecione Adicionar repositório, escolha GitHub, introduza o seu .ghe.com host e selecione Trazer a sua própria aplicação GitHub como método de autenticação.

Conteúdo relacionado

  • Last updated on