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.
Use o conector GitHub para ligar github.com ao seu agente para gerir problemas, pull requests e fluxos de trabalho. Configure o conector através de Builder > Connectors no portal.
Note
Este tutorial aborda o GitHub Connector para operações de issues, PR e workflow. Para contexto do código durante as investigações, consulte Código-fonte Connect. Para GitHub Enterprise Cloud, veja Connect GitHub Enterprise Cloud.
Pré-requisitos
- Um agente ativo no estado Running
- Acesso aos
github.comrepositórios que quer que o agente use - Papel de agente: Administrador ou Utilizador Padrão
Abra a configuração do conector do GitHub
- Abra o seu agente no portal.
- Aceda a Conectores do Builder>.
- Selecionar Adicionar conector.
- Selecione conector OAuth do GitHub.
Escolha um método de autenticação
Selecione um método:
| Method | Quando utilizar |
|---|---|
| OAuth | Configuração interativa para acesso conduzido pelo utilizador |
| PAT | Conta de serviço ou configuração não interativa |
Fluxo OAuth
- Selecione OAuth.
- Selecione Entrar no GitHub.
- Conclua a autorização na janela pop-up do GitHub.
- Confirme que o estado mostra Conectado.
Fluxo PAT
- Selecione PAT.
- Cola um token do GitHub com os escopos necessários.
- Selecione Conectar.
- Confirme que o estado mostra Conectado.
Confirmar operações do conector GitHub em tempo de execução
Depois de guardar 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 ponto de verificação final:
Get me recent issues from owner/repo.
Permissões necessárias por operação
| Funcionamento | Mínimo OAuth/PAT |
|---|---|
| Ler metadados/conteúdo do repositório |
repo para repositórios privados (public_repo apenas público) |
| Liste ou crie problemas | Acesso a repositórios com capacidade de emissão |
| Operações de pull request | Acesso a repositórios com suporte para PR |
Solucionar problemas de conexões
| Symptom | Causa provável | Corrigir |
|---|---|---|
| O conector mostra desconectado | Token expirado ou revogado | Voltar a autenticar o OAuth ou renovar o PAT |
| As leituras da edição funcionam, as ações de relações públicas falham | Permissão de PR em falta | Conceda permissão ao PR e tente novamente |
| O conector não consegue aceder a repositórios privados | O âmbito do token é demasiado estreito | Utilize o âmbito repo para repositórios privados |
| O pop-up não abre | Janela de contexto do navegador bloqueada | Permitir popups para o domínio do portal |