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.
Conecte seus repositórios do GitHub para que o agente possa ler o código-fonte, pesquisar erros, criar problemas, disparar fluxos de trabalho e correlacionar implantações com incidentes.
Dica
Visão geral rápida
- Duas opções de autenticação: entrada OAuth (recomendada) ou PAT (Token de Acesso Pessoal).
- Seu agente terá acesso de leitura aos seus repositórios, incluindo pesquisa de código, conteúdo de arquivos e histórico de commits.
- Seu agente pode criar problemas do GitHub, comentar em PRs e disparar fluxos de trabalho do GitHub Actions.
- Um conector OAuth por agente abrange todos os repositórios aos quais você tem acesso.
Tipos de autenticação
Escolha o método de autenticação que atenda às necessidades da sua equipe.
| Método | Como funciona | Mais adequado para |
|---|---|---|
| OAuth | Entre com sua conta do GitHub em um pop-up do navegador. O agente acessa repositórios por meio de suas permissões. Os tokens são atualizados automaticamente sem necessidade de autenticação. | A configuração interativa é recomendada para a maioria dos usuários |
| PAT | Forneça um Token de Acesso Pessoal com o escopo repo. Use por CLI (srectl repo add github --pat) ou quando o OAuth não estiver disponível. |
Pipelines de CI/CD, ambientes sem interface gráfica |
Dica
Os tokens OAuth são atualizados automaticamente
Os tokens OAuth do GitHub expiram após aproximadamente oito horas, mas seu agente os atualiza automaticamente antes da expiração usando um buffer de 5 minutos. Cada atualização gera um novo token de atualização, criando uma cadeia de renovação autossustentável que dura aproximadamente seis meses. Seu conector permanece conectado durante longas investigações e tarefas agendadas para a madrugada, sem a necessidade de login manual.
Quando você precisar se autenticar novamente: Se o token de atualização expirar (aproximadamente seis meses), se você revogar a autorização do Aplicativo GitHub ou se configurar o conector antes da versão 26.2.247.0. Uma única reautenticação armazena o token de atualização e habilita a atualização automática daqui em diante.
O que o agente pode fazer com o GitHub
O conector do GitHub confere ao seu agente capacidades na análise do código-fonte, no gerenciamento de problemas e solicitações de pull, e na automação do fluxo de trabalho.
Análise do código-fonte
Seu agente pode executar as seguintes operações de código-fonte:
- Pesquisar código em todos os repositórios conectados.
- Ler o conteúdo do arquivo usando o caminho e o branch.
- Correlacionar erros com o código-fonte: mapeie erros de recurso do Azure a arquivos e números de linha específicos.
- Pesquisa de código semântico: localize o código relacionado a um incidente usando consultas de linguagem natural.
- Identificar arquivos IaC: detectar modelos Bicep, Terraform e ARM nos seus repositórios.
Gerenciamento de emissão e solicitações de pull
Seu agente pode gerenciar problemas e solicitações de pull em seus repositórios conectados.
- Crie problemas com título, corpo, rótulos e atribuições.
- Comente sobre problemas e solicitações de pull, incluindo palavras-chave de fechamento automático.
- Atualize itens alterando o título, o corpo, os rótulos ou o estado.
- Obtenha alertas do Dependabot que permitem que você analise vulnerabilidades de segurança.
Automação de fluxo de trabalho
Seu agente pode disparar e monitorar fluxos de trabalho do GitHub Actions.
- Dispare fluxos de trabalho do GitHub Actions para que realizem implantações do Canary ou de produção.
- Acompanhe as execuções de fluxo de trabalho que monitoram o status dos fluxos de trabalho expedidos.
- Verifique o status de mesclagem de PR para confirmar se um pull request foi mesclado.
Introdução
Use o recurso a seguir para configurar o conector do GitHub.
| Recurso | O que aprendeu |
|---|---|
| Conectar código-fonte | Guia passo a passo para conectar repositórios do GitHub com OAuth, PAT ou MCP |
Próxima etapa
Conteúdo relacionado
- Análise de causa raiz: como o contexto do código-fonte melhora a precisão da investigação.
- Ferramentas: Operações de arquivo e execução de código no workspace do agente.
- Configurar um conector MCP: conecte o servidor MCP do GitHub para obter mais recursos de ferramenta.
- Conectores: visão geral de todos os tipos de conector.