Como conectar o GitLab a um agente de IA passo a passo

· DoubleX

Resposta rápida

Para conectar o GitLab a um agente de IA, abra a tela Conectores do DoubleX Agentes, escolha o GitLab, autorize o acesso com sua conta e defina se a conexão é pessoal, do time ou da empresa. Depois libere ao agente só as ações necessárias e teste com um pedido de leitura.

Conectar o GitLab a um agente de IA permite que ele consulte projetos, issues, merge requests e pipelines sem que alguém precise abrir cada tela e copiar informações. O processo é curto, mas as escolhas de tipo de conexão e de permissões merecem atenção. Este guia mostra o caminho completo, até o primeiro teste.

O que o agente consegue fazer com o conector do GitLab?#

Com o conector do GitLab, o agente consulta projetos, issues, merge requests e pipelines e usa essas informações para responder, resumir e preparar relatórios. Ele trabalha no GitLab que a equipe já usa, sem substituí-lo.

TarefaComo o agente ajudaDado consultado
Acompanhar revisõesLista merge requests abertos e resume o que faltaMerge requests
Priorizar o backlogAgrupa issues por tema e aponta as mais antigasIssues
Investigar falhasMostra pipelines que falharam e o que mudouPipelines
Resumo para a gestãoMonta um relatório semanal do andamentoProjetos, issues e merge requests

O agente pode entregar o resultado como relatório ou planilha na tela Artefatos, e também trabalhar em rotinas agendadas.

O que preciso ter antes de conectar?#

Você precisa de uma conta no DoubleX Agentes, de acesso à sua conta do GitLab e de ao menos um agente criado. Criar a conta é grátis e não exige cartão.

Se ainda não tem um agente, faça o diagnóstico: uma conversa de 5 a 10 minutos com a consultora de IA sobre a rotina da empresa. Com um clique, o resultado vira uma equipe de agentes pronta para testar. Para um panorama do produto, veja a Introdução e o Início rápido.

Também vale decidir antes quem usará o conector: só você, um time de desenvolvimento ou a empresa toda. Essa escolha define o tipo de conexão.

Como conectar o GitLab na tela Conectores?#

Você conecta o GitLab na tela Conectores, escolhendo o GitLab na lista e autorizando o acesso com a sua conta. Depois da autorização, o conector aparece como conectado e fica disponível para os agentes.

  1. Entre no DoubleX Agentes e abra a tela Conectores.
  2. Procure o GitLab (categoria desenvolvimento) e inicie a conexão.
  3. Autorize o acesso com a sua conta do GitLab.
  4. Escolha o tipo de conexão: pessoal, do time ou da empresa.
  5. Abra a tela Agentes, selecione o agente que vai usar o GitLab e ative o conector para ele.
  6. Defina quais ações o agente pode executar e faça um primeiro pedido de teste.

Quem desenvolve também pode gerenciar conectores por API. A referência está em Conectores.

Conexão pessoal, do time ou da empresa: qual escolher?#

Escolha pessoal quando só você vai usar, do time quando um grupo compartilha o mesmo acesso e da empresa quando vários times dependem da mesma conexão. Uma conexão pessoal vale apenas para a pessoa que a criou.

TipoQuando usarExemplo
PessoalUso individual, com as suas permissõesVocê acompanhando seus próprios merge requests
Do timeUm grupo compartilha o acessoTime de engenharia revisando pipelines
Da empresaVários times usam a mesma conexãoRelatório geral de projetos para a gestão

Na dúvida, comece pela pessoal e amplie depois. Lembre também que uma rotina agendada roda com as permissões de quem a criou.

Como limitar as ações do agente e manter só leitura?#

Para cada agente, você escolhe quais sistemas ele usa e, em cada sistema, quais ações pode executar. Ações que alteram dados podem ficar desligadas, deixando o agente em modo somente leitura.

Para um primeiro uso com o GitLab, mantenha só as ações de consulta: ver projetos, issues, merge requests e pipelines. Libere ações de escrita apenas quando houver um caso claro e depois de testar.

As demais proteções do produto ajudam: antes de enviar, apagar ou alterar algo, o agente pede confirmação e mostra o passo a passo, e o conteúdo da empresa não é usado para treinar modelos. As credenciais das conexões ficam criptografadas com AES-256-GCM.

Como testar com um primeiro pedido e conferir o histórico da tarefa?#

Teste com um pedido de leitura simples e confira na tela Tarefas o que o agente fez. Cada pedido vira uma tarefa com histórico completo: o pedido, cada ferramenta usada e o resultado.

Exemplos de pedidos que você pode copiar:

  • "Liste os merge requests abertos no projeto de pagamentos e diga quais estão há mais de uma semana sem revisão."
  • "Mostre as issues abertas mais antigas e agrupe por tema."
  • "Quais pipelines falharam esta semana? Resuma o motivo de cada um."
  • "Faça um resumo do andamento dos projetos para eu levar à reunião de segunda."

Na tela Tarefas, abra a tarefa e verifique se o agente consultou o GitLab, quais ferramentas usou e se a resposta confere com o que você vê no GitLab. Se algo faltar, revise o acesso da conta conectada e as ações liberadas.

Para ver exemplos de uso depois do teste, leia GitLab com agente de IA: merge requests, issues e pipelines. Se quiser repetir o processo com outro sistema, o guia Como conectar o Jam a um agente de IA segue o mesmo caminho.

Perguntas frequentes#

Preciso programar para conectar o GitLab?#

Não. Você conecta pela tela Conectores, autorizando o acesso com sua conta. Quem quiser ir além tem API REST, CLI e servidor MCP.

O agente pode alterar meus projetos no GitLab?#

Só se você liberar. Ações que alteram dados podem ficar desligadas, deixando o agente em modo somente leitura, e ele pede confirmação antes de alterar algo.

Como saber o que o agente fez no GitLab?#

Cada pedido vira uma tarefa na tela Tarefas, com o pedido, cada ferramenta usada e o resultado. Dá para saber quem pediu, o que foi feito e quando.

Posso usar o mesmo conector em vários agentes?#

Sim, mas você decide por agente quais sistemas ele usa e quais ações pode executar. Assim, um agente pode só consultar enquanto outro tem mais permissões.

Quanto custa conectar o GitLab?#

Criar a conta e fazer o primeiro diagnóstico é grátis, sem cartão. O uso da IA consome créditos, e cada plano tem um limite mensal; quando acabam, o uso para, sem conta surpresa.

Guias relacionados

Mais guias de GitLab