Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Tempo estimado: 10 minutos
Conecte seu GitHub ou Azure DevOps repositório para que o agente possa executar a análise de causa raiz, correlacionando problemas de produção a um código específico.
O que você realiza
Ao final deste tutorial, seu agente pode:
- Analisar o código-fonte durante investigações
- Fornecer referências específicas de arquivo e linha para problemas
- Criar planos de tarefas pendentes mostrando as etapas de investigação
- Correlacionar sintomas de produção a alterações de código
Pré-requisitos
| Requisito | Detalhes |
|---|---|
| Agente criado | Concluir a Etapa 1: criar um agente primeiro. |
| GitHub ou Azure DevOps organização | Acesso aos repositórios que você deseja conectar. |
Escolha seu método de autenticação
Selecione o método de autenticação que funciona melhor para seu ambiente.
| Método | Quando usar |
|---|---|
| OAuth | Entre com sua conta GitHub. Nenhum token é necessário e fornece a configuração mais fácil. |
| PAT | Forneça um Token de Acesso Pessoal com escopo de repo. Funciona para organizações com restrições de SSO. |
Conectar seu repositório
Conecte um repositório GitHub ou Azure DevOps para que o agente o indexe 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, vá para abase de dados de conhecimento do > e selecione o cartão de ação Adicionar repositório.
Etapa 2: Escolher uma plataforma
Use as etapas a seguir para selecionar sua plataforma e autenticar.
Selecione GitHub ou Azure DevOps.
Escolha seu método de entrada:
Método Quando usar Autenticação (OAuth) Entre com sua organização do GitHub ou do Azure DevOps. Nenhum token é necessário. PAT Forneça um Token de Acesso Pessoal com escopo de repo.Autenticação completa:
- OAuth: Selecione Sign in to GitHub (ou Sign in to Azure DevOps) e conclua o pop-up de autenticação.
- PAT: Insira seu token no campo Fornecer PAT e selecione Conectar.
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.Com êxito, um cartão conectado aparece mostrando sua conta autenticada.
Selecione Próximo.
Etapa 3: Selecionar repositórios
Após a autenticação, o campo URL do Repositório mostra uma lista suspensa de seus repositórios.
-
GitHub repositórios aparecem como
org/repo-name, classificados pela última atualização (até 100 repositórios). - Repositórios do Azure DevOps aparecem após você selecionar um projeto no menu suspenso Azure DevOps Projects.
Selecione um repositório na lista suspensa. O nome de exibição é preenchido automaticamente com o nome do repositório. Você também pode digitar qualquer URL de repositório válida diretamente no campo.
Para adicionar vários repositórios, selecione Adicionar para inserir mais linhas.
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
Selecione Adicionar repositório para salvar suas alterações.
O sistema cria automaticamente um conector OAuth do GitHub ou Azure DevOps apropriado, caso um ainda não exista.
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.
- Abra um thread de chat com seu agente.
- 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'".
- 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
Ao reabrir a caixa de diálogo “Adicionar repositório, os repositórios já conectados aparecem como linhas somente leitura na tabela.
Remover um repositório
Use as etapas a seguir para remover um repositório conectado.
- Vá para abase de dados de conhecimento do > e selecione o cartão de ação Adicionar repositório.
- Encontre a linha do repositório na tabela.
- Selecione o ícone de lixeira na linha para marcá-lo para exclusão.
- Selecione Adicionar repositório para salvar as alterações.
- Na caixa de diálogo Confirmar alterações , examine os repositórios removidos.
- Selecione Confirmar para continuar ou Cancelar para mantê-los.
Atualizar autenticação
Se o PAT expirar ou você precisar trocar de conta, reabra a caixa de diálogo Adicionar Repositório e reautenticar com novas credenciais.
Alternativa: MCP e agente personalizado
Para acesso completo à API do GitHub — pesquisar código, ler arquivos, listar commits em todos os repositórios — conecte-se ao 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. Para obter instruções passo a passo, consulte Tutorial: Configurar o conector MCP.
Resumo
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.