Como conectar o GitHub a um agente de IA passo a passo
· DoubleX
Resposta rápida
Para conectar o GitHub a um agente de IA, crie a conexão na tela Conectores do DoubleX Agentes, autorize sua conta, escolha se ela é pessoal, do time ou da empresa e defina as ações permitidas ao agente: só leitura, ou também comentar e abrir pull requests. Depois, teste com um pedido simples.
Ligar o GitHub a um agente de IA permite que ele leia repositórios, issues e pull requests sem que ninguém precise copiar e colar o conteúdo numa conversa. O ponto mais importante da configuração não é a conexão em si, e sim decidir quem a usa e o que o agente pode fazer com ela. Este guia cobre a configuração e o primeiro teste.
O que o agente consegue fazer com o conector do GitHub?#
Com o conector do GitHub, o agente lê repositórios, issues e pull requests, e também pode abrir e comentar PRs, se você permitir. Tudo depende das ações que você liberar na configuração do agente.
Na prática, isso significa que o agente pode, por exemplo, consultar o que está aberto num repositório, resumir uma discussão longa numa issue ou revisar o que mudou num pull request. As ações de escrita, como comentar ou abrir um PR, ficam sob seu controle e podem ser desligadas.
Para ver exemplos de pedidos e rotinas prontas, consulte o guia GitHub com agente de IA: exemplos de pedidos e rotinas. Aqui o foco é a configuração.
O que preciso ter antes de conectar?#
Você precisa de uma conta no DoubleX Agentes, de uma conta no GitHub com acesso aos repositórios que o agente vai usar e de um agente criado para receber a conexão. Criar a conta é grátis e não pede cartão.
Antes de começar, confira esta lista:
| Item | Por que importa |
|---|---|
| Conta no DoubleX Agentes | É onde ficam os conectores e os agentes |
| Conta no GitHub | É a que será autorizada na conexão |
| Acesso aos repositórios desejados | O agente só enxerga o que a conta autorizada enxerga |
| Um agente criado (ou o diagnóstico feito) | É quem vai usar o conector |
| Definição de quem vai usar a conexão | Decide se ela é pessoal, do time ou da empresa |
Se ainda não tem um agente, faça o diagnóstico: uma conversa de 5 a 10 minutos que mostra por onde começar e pode virar uma equipe de agentes pronta para testar. O Início rápido mostra esse caminho.
Como conectar o GitHub na tela Conectores?#
A conexão é feita na tela Conectores: você escolhe o GitHub, autoriza sua conta, define o alcance da conexão e libera o conector para o agente.
O passo a passo no DoubleX Agentes:
- Entre na tela Conectores e procure o GitHub na lista.
- Inicie a conexão e autorize o acesso com a sua conta do GitHub.
- Defina se a conexão é pessoal, do time ou da empresa (veja a próxima seção).
- Abra a tela Agentes, escolha o agente que vai usar o GitHub e adicione o conector a ele.
- Escolha as ações que o agente pode executar no GitHub (veja a seção sobre limites).
- Faça um pedido de teste e confira o resultado na tela Tarefas.
Senhas, tokens e chaves das conexões ficam criptografados com AES-256-GCM. Para detalhes técnicos de gerenciamento por API, veja a documentação de Conectores.
Conexão pessoal, do time ou da empresa: qual escolher?#
Escolha pessoal quando a conexão deve valer só para você, do time quando um grupo compartilha o mesmo acesso e da empresa quando todos precisam do mesmo conector. A regra prática é usar o menor alcance que resolve o caso.
| Tipo de conexão | Quando usar | Cuidado |
|---|---|---|
| Pessoal | Seus repositórios e o seu acesso individual | Só vale para a pessoa que conectou |
| Do time | Um time de engenharia que compartilha repositórios | Todos do time passam a usar essa conexão |
| Da empresa | Repositórios que várias áreas consultam | Defina bem as ações permitidas |
Se o agente vai olhar repositórios privados e só uma pessoa tem acesso a eles, a conexão pessoal costuma ser a escolha mais segura. Quando a equipe toda precisa do mesmo agente, a conexão do time evita que cada pessoa autorize a própria conta.
Como limitar as ações do agente (só leitura ou com escrita)?#
Para cada agente, você escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Para o GitHub, isso permite começar só com leitura e liberar comentários e abertura de PRs depois.
Duas configurações típicas:
- Só leitura: o agente consulta repositórios, issues e pull requests, mas não altera nada. É o melhor ponto de partida.
- Leitura e escrita: além de ler, o agente pode comentar em PRs e abrir pull requests, conforme as ações que você liberar.
Mesmo com a escrita liberada, antes de enviar, apagar ou alterar algo nos sistemas, o agente pede confirmação e mostra o passo a passo do que fez. Você mantém a decisão final.
Para o time de engenharia, uma boa prática é ter um agente de leitura para consultas gerais e outro, com escrita, restrito a quem revisa código.
Como fazer o primeiro teste e conferir o histórico na tela Tarefas?#
Faça um pedido simples de leitura ao agente e abra a tela Tarefas para ver o pedido, cada ferramenta usada e o resultado. Se o agente listou o que você esperava, a conexão está correta.
Exemplos de pedidos para o primeiro teste:
- "Liste as issues abertas do repositório [nome do repositório]."
- "Resuma o pull request mais recente e diga o que mudou."
- "Quais pull requests estão abertos há mais tempo neste repositório?"
- "Leia a issue [número] e me diga qual é o problema relatado."
Na tela Tarefas, cada pedido vira uma tarefa com histórico completo: quem pediu, o que o agente fez e quando. Se algo falhar, confira se a conta autorizada tem acesso ao repositório e se a ação necessária está liberada para o agente.
Se quiser, os agentes também podem ser acionados por rotina ou por evento. Veja a documentação de Gatilhos quando for o momento de automatizar.
Perguntas frequentes#
Preciso saber programar para conectar o GitHub?#
Não. A conexão é feita pela interface, na tela Conectores, e você descreve o que precisa com as próprias palavras. API, CLI e MCP existem para quem quiser ir além.
O agente pode alterar meu código sem eu saber?#
Só se você liberar ações de escrita. Mesmo assim, antes de enviar ou alterar algo, o agente pede confirmação, e tudo fica registrado no histórico da tarefa.
O agente enxerga todos os meus repositórios?#
Ele enxerga o que a conta autorizada na conexão consegue acessar. Para limitar o alcance, use uma conta com acesso restrito e escolha o tipo de conexão adequado.
O conteúdo do meu repositório treina modelos de IA?#
Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores que não usam o que recebem para treinamento. Há também a opção de retenção zero na tela Modelos.
Posso conectar outros sistemas da mesma forma?#
Sim. O fluxo é parecido para outros conectores. Veja, por exemplo, como conectar o Box a um agente de IA ou como conectar o Jam.
Guias relacionados
- Como conectar o Box a um agente de IA passo a passoVeja como conectar o Box a um agente de IA: do cadastro ao primeiro pedido, com permissões, modo só leitura e histórico para controlar o acesso aos arquivos.
- Como conectar o Jam a um agente de IA passo a passoVeja como conectar o Jam a um agente de IA no DoubleX Agentes: escolha o tipo de conexão, limite permissões e teste com um relatório de bug.