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.
| Tarefa | Como o agente ajuda | Dado consultado |
|---|---|---|
| Acompanhar revisões | Lista merge requests abertos e resume o que falta | Merge requests |
| Priorizar o backlog | Agrupa issues por tema e aponta as mais antigas | Issues |
| Investigar falhas | Mostra pipelines que falharam e o que mudou | Pipelines |
| Resumo para a gestão | Monta um relatório semanal do andamento | Projetos, 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.
- Entre no DoubleX Agentes e abra a tela Conectores.
- Procure o GitLab (categoria desenvolvimento) e inicie a conexão.
- Autorize o acesso com a sua conta do GitLab.
- Escolha o tipo de conexão: pessoal, do time ou da empresa.
- Abra a tela Agentes, selecione o agente que vai usar o GitLab e ative o conector para ele.
- 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.
| Tipo | Quando usar | Exemplo |
|---|---|---|
| Pessoal | Uso individual, com as suas permissões | Você acompanhando seus próprios merge requests |
| Do time | Um grupo compartilha o acesso | Time de engenharia revisando pipelines |
| Da empresa | Vários times usam a mesma conexão | Relató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
- 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.