Pular para o conteúdo

Bancada de desenvolvimento

Deixe agentes Desenvolvedor e QA trabalharem nos repositórios da empresa num ambiente isolado, com pull requests sob controle humano.

A bancada de desenvolvimento é um serviço da empresa, rodando em outra máquina, onde os agentes Desenvolvedor e QA abrem os repositórios liberados, cada tarefa na sua própria cópia isolada. O servidor do Team Connect nunca roda código dos repositórios.

O que os agentes fazem na bancada

  • Desenvolvedor: abre o repositório num branch próprio da tarefa (sempre com prefixo agent/), lê e altera arquivos, roda comandos e testes, faz commit, envia o branch e abre o pull request. Também continua um PR que ele mesmo abriu quando pedem mudanças.
  • QA: abre um pull request só para leitura, roda os testes e comenta o resultado no PR.
  • Os comandos rodam num contêiner isolado, sem acesso à rede por padrão, com limites de tempo, CPU, memória e disco.
  • Os agentes nunca fazem merge, nunca enviam direto para o branch principal e nunca aprovam um PR. O merge é sempre de uma pessoa.
  • As credenciais do servidor Git nunca entram no ambiente isolado nem chegam ao modelo.

Cada passo aparece no painel da tarefa (repositório, branch, link do PR e último comando) e na auditoria.

Antes de começar

  1. Quem cuida da infraestrutura instala o serviço da bancada numa máquina separada, com git e Docker, e define um segredo compartilhado. No Team Connect hospedado, a bancada também roda na infraestrutura da empresa e precisa de um endereço https público.
  2. Cadastre o servidor Git da empresa (veja abaixo).
  3. Tenha pelo menos uma conexão de LLM: Desenvolvedor e QA usam o cérebro gerenciado.

Conectar a bancada

  1. Na barra lateral, abra Integrações, aba Da empresa.
  2. No cartão Bancada de desenvolvimento, clique em Configurar.
  3. Preencha Endereço da bancada e Segredo compartilhado. O segredo fica criptografado e nunca é mostrado de novo.
  4. Marque Ativar a bancada para os agentes.
  5. Clique em Salvar e depois em Testar conexão.

Quando tudo está certo, o status mostra Respondendo, quantos repositórios estão abertos, o espaço livre e se há comandos isolados disponíveis.

Aprovação antes do pull request

Marque Pedir aprovação de quem pediu a tarefa antes de abrir um pull request para que o Desenvolvedor pergunte antes de abrir cada PR. A pessoa aprova ou recusa no painel Tarefas do agente ou no chat. Com a opção desligada, o agente abre o PR sozinho; o merge continua sendo de uma pessoa.

Motores de código

Em Motores de código, escolha quais motores o Desenvolvedor pode usar para um passo pesado: Aider (qualquer provedor), Claude Code (precisa de uma conexão Anthropic) e Codex CLI (precisa de uma conexão compatível com OpenAI). O motor roda isolado na cópia da tarefa e só aceita chaves de API: a chave de LLM da empresa não entra no ambiente isolado. O motor padrão de cada agente fica no formulário do agente, em Motor de código padrão.

Servidores Git suportados

No cartão Servidores Git, clique em Configurar e depois em Nova conexão Git. Em Serviço, escolha:

ServiçoCredencial
GitHub (GitHub App)App ID, Installation ID e chave privada
GitHub (token), GitHub Enterprise Server, GitBucketToken de acesso
GitLab.com e GitLab (instalação própria)Token de acesso do projeto ou do grupo
Bitbucket CloudToken de acesso do workspace ou do repositório
Gitea / Forgejo e CodebergToken de acesso

A tela mostra quais permissões cada credencial precisa. Ao clicar em Salvar conexão, o Team Connect verifica a credencial no servidor Git. Depois, edite cada agente e marque os Repositórios liberados para ele (nenhum vem liberado).

Eventos e revisão automática

Em cada conexão Git, Eventos e revisão automática permite receber avisos de PRs e de CI nos canais do escritório e deixar um agente Revisor de código revisar PRs sozinho (Revisar quando um PR for aberto ou Revisar quando mencionarem o revisor num comentário do PR). Clique em Ativar eventos e cadastre o endereço e o segredo mostrados no servidor Git.

Privacidade (LGPD)

O que os agentes leem nos repositórios vai para o provedor de LLM escolhido e fica nas transcrições pelo prazo de retenção. Repositórios podem ter dados pessoais: libere só o necessário.