Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Tempo estimado: 10 minutos
Ligue o seu repositório GitHub ou Azure DevOps para que o seu agente possa realizar análise de causa raiz, correlacionando problemas de produção com código específico.
O que você realiza
No final deste tutorial, o seu agente pode:
- Analisar o código-fonte durante as investigações
- Forneça referências específicas de ficheiros e linhas para problemas
- Criar Planos de Tarefas que mostrem os passos de investigação
- Correlacionar sintomas de produção com alterações no código
Pré-requisitos
| Requisito | Detalhes |
|---|---|
| Agente criado | Complete o Passo 1: Crie primeiro um agente. |
| GitHub ou organização Azure DevOps | Acede aos repositórios que queres ligar. |
Escolha o seu método de autenticação
Selecione o método de autenticação que funcione melhor para o seu ambiente.
| Método | Quando utilizar |
|---|---|
| OAuth | Inicia sessão com a tua conta no GitHub. Não é necessário token e é a configuração mais fácil. |
| PAT | Forneça um Token de Acesso Pessoal com repo escopo. Trabalha para organizações com restrições do SSO. |
Ligue o seu repositório
Ligue um repositório GitHub ou Azure DevOps para que o seu agente o indexe 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
Use os seguintes passos para selecionar a sua plataforma e autenticar.
Selecione GitHub ou Azure DevOps.
Escolha o seu método de iniciação de sessão:
Método Quando utilizar Auth (OAuth) Inicie sessão com a sua organização GitHub ou Azure DevOps. Não é necessário nenhum token. PAT Forneça um Token de Acesso Pessoal com repoescopo.Autenticação completa:
- OAuth: Selecione Iniciar sessão em GitHub (ou Iniciar sessão em Azure DevOps) e complete a janela 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.Em caso de sucesso, aparece um cartão Connected a mostrar a sua conta autenticada.
Selecione Avançar.
Passo 3: Selecionar repositórios
Após a autenticação, o campo URL do Repositório mostra uma lista de opções dos seus repositórios.
-
Repositórios do GitHub aparecem como
org/repo-name, ordenados por última atualização (até 100 repositórios). - Repositórios do Azure DevOps aparecem depois de selecionares um projeto no menu suspenso Azure DevOps Project.
Selecione um repositório no menu suspenso. O nome de exibição preenche 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 as suas alterações.
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.
- Abre um chat com o teu agente.
- 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'".
- 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.
Remover um repositório
Use os seguintes passos para remover um repositório ligado.
- Vai à Base de Conhecimento do Construtor> e seleciona a carta de ação Adicionar repositório.
- Encontre a linha do repositório na grelha.
- Selecionar o ícone de lixo na linha para marcá-la para remoção.
- Selecione Adicionar repositório para guardar alterações.
- No diálogo Confirmar alterações , reveja os repositórios que foram removidos.
- Selecione Confirmar para prosseguir ou Cancelar para os manter.
Atualizar autenticação
Se o teu PAT expirar ou precisares de mudar de conta, reabre a caixa de diálogo Adicionar Repositório e autentifica novamente com novas credenciais.
Alternativa: MCP e agente alfandegário
Para acesso completo à API do GitHub — pesquisar código, ler ficheiros, listar commits em todos os repositórios — ligue 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. Para instruções passo a passo, veja o Tutorial: Configurar o conector MCP.
Resumo
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.