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.
Use o conector do GitHub para conectar github.com ao seu agente para gerenciar problemas, solicitações de pull e fluxos de trabalho. Configure o conector por meio de Conectores do Construtor > no portal.
Note
Este tutorial aborda o Conector GitHub para operações de problema, PR e fluxo de trabalho. Para obter contexto do código durante as investigações, consulte Conectar código-fonte. Para GitHub Enterprise Cloud, consulte Connect GitHub Enterprise Cloud.
Pré-requisitos
- Um agente ativo em estado de execução
- Acesso a
github.comrepositórios que você deseja que o agente use - Função de agente: Administrador ou Usuário Padrão
Abra a configuração do conector do GitHub
- Abra seu agente no portal.
- Acesse Construtor > Conectores.
- Selecione Adicionar conector.
- Selecione conector OAuth do GitHub.
Escolher um método de autenticação
Selecione um método:
| Method | Quando usar |
|---|---|
| OAuth | Configuração interativa para acesso controlado pelo usuário |
| PAT | Conta de serviço ou configuração não interativa |
Fluxo do OAuth
- Selecione OAuth.
- Selecione Entrar no GitHub.
- Conclua a autorização na janela pop-up do GitHub.
- Confirme se o status mostra Conectado.
Fluxo PAT
- Selecione PAT.
- Cole um token do GitHub com os escopos necessários.
- Selecione Conectar.
- Confirme se o status mostra Conectado.
Confirmar as operações de runtime do conector do GitHub
Depois de salvar o conector, teste com um prompt de chat:
List recent issues from owner/repo and summarize the top 3 risks.
Use um prompt de verificação direta como um ponto de verificação final:
Get me recent issues from owner/repo.
Permissões necessárias por operação
| Operação | Mínimo de OAuth/PAT |
|---|---|
| Ler metadados/conteúdo do repositório |
repo para repositórios privados (public_repo somente público) |
| Listar ou criar problemas | Acesso a repositório com suporte a problemas |
| Operações de solicitação de pull | Acesso a repositório com suporte a PR |
Solucionar problemas de conexões
| Sintoma | Causa provável | Corrigir |
|---|---|---|
| Conector aparece como desconectado | Token expirado ou revogado | Autenticar o OAuth novamente ou rotacionar o PAT |
| A leitura de problemas funciona, as ações de PR falham | Permissão de PR ausente | Conceda permissão ao PR e tente novamente |
| O conector não pode acessar repositórios privados | Escopo do token muito limitado | Use o escopo repo para repositórios privados |
| Pop-up não abre | Janela pop-up do navegador bloqueada | Permitir pop-ups para o domínio do portal |