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:

ItemPor 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 desejadosO 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ãoDecide 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:

  1. Entre na tela Conectores e procure o GitHub na lista.
  2. Inicie a conexão e autorize o acesso com a sua conta do GitHub.
  3. Defina se a conexão é pessoal, do time ou da empresa (veja a próxima seção).
  4. Abra a tela Agentes, escolha o agente que vai usar o GitHub e adicione o conector a ele.
  5. Escolha as ações que o agente pode executar no GitHub (veja a seção sobre limites).
  6. 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ãoQuando usarCuidado
PessoalSeus repositórios e o seu acesso individualSó vale para a pessoa que conectou
Do timeUm time de engenharia que compartilha repositóriosTodos do time passam a usar essa conexão
Da empresaRepositórios que várias áreas consultamDefina 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

Mais guias de GitHub