Agentes de IA
Crie e gerencie os agentes de IA da empresa: funções, instruções, time de desenvolvimento, aprovações, memória da empresa e limites de uso.
Agentes de IA são colegas robôs que vivem no escritório: aparecem no mapa, recebem tarefas pelo painel ou pelo chat e informam o que estão fazendo. Eles pertencem à empresa, então continuam aqui mesmo se quem os criou sair. Este guia mostra como criá-los e mantê-los sob controle. Para o uso no dia a dia, veja Agentes de IA para pessoas.
Quem pode gerenciar
Donos, administradores e quem tem a permissão Gerenciar agentes de IA criam e configuram agentes. Em cada agente, você também pode escolher Responsáveis: pessoas que podem configurar só aquele agente.
Abra Agentes de IA na barra lateral. A página tem as abas Agentes (todos veem), Atividades, Memória e Gerenciar.
Criar um agente
- Na aba Gerenciar, clique em Novo agente.
- Em Comece por um modelo, escolha um modelo pronto (Recepção, Secretário de reuniões, Suporte de TI, Redator ou Revisor de código) ou clique em Começar em branco. Tudo continua editável.
- Preencha Nome, O que ele faz e Habilidades (separadas por vírgula, até 8).
- Em Cérebro, escolha:
- Gerenciado pelo Team Connect, com uma conexão de LLM da empresa: selecione a Conexão de LLM, o Modelo (em branco, vale o modelo padrão da conexão) e escreva as Instruções (persona e regras da empresa).
- Externo: um programa próprio, com o token do agente: o seu próprio programa informa o estado do agente com um token.
- Escolha a Função, defina Quem pode pedir tarefas e a Cor do robô.
- Clique em Criar agente.
Depois, no cartão do agente, escolha a Estação de trabalho dele no mapa e use Editar, Pausar/Retomar, Novo token ou Excluir. O token de um agente externo aparece uma única vez: guarde-o só no ambiente do agente.
Funções
| Função | O que faz |
|---|---|
| Assistente | Trabalha no que pedirem, informa etapas e pergunta. |
| Revisor de código | Revisa pull requests dos repositórios liberados e comenta no PR. Nunca aprova nem faz merge. |
| Desenvolvedor | Muda o código na bancada da empresa, envia o branch da tarefa e abre o pull request. Nunca faz merge. |
| QA | Roda os testes de um pull request num ambiente isolado e relata o resultado. |
Desenvolvedor e QA precisam do cérebro gerenciado e da bancada de desenvolvimento configurada.
O time de desenvolvimento
Combine as funções para montar um time: o Desenvolvedor abre o pull request e pode pedir revisão a um Revisor de código ou testes a um agente QA. O pedido vira uma tarefa para o outro agente, que precisa ter acesso ao mesmo repositório. Há um limite de repasses por tarefa, para evitar ciclos. O merge é sempre de uma pessoa.
Para agentes Desenvolvedor, o campo Motor de código padrão define qual motor de código (Aider, Claude Code ou Codex CLI) o agente usa quando entrega um passo pesado. Só vale para motores liberados na bancada e compatíveis com o provedor de LLM do agente.
Aprovações e tarefas
Quando um agente precisa de uma decisão, ele pergunta a quem pediu a tarefa. A pessoa responde no painel Tarefas do agente (Aprovar, Recusar ou Responder) ou no próprio chat. Se a bancada estiver configurada para isso, o Desenvolvedor pede aprovação antes de abrir cada pull request.
Quem pediu cancela a própria tarefa. Quem gerencia agentes e os responsáveis reordenam e cancelam qualquer tarefa da fila. Em cada tarefa, Ver transcrição mostra o que foi enviado ao modelo e as respostas.
Acompanhar o trabalho
A aba Atividades mostra um quadro com as colunas Na fila, Em andamento, Aguardando resposta, Concluídas e Não concluídas. Filtre por Agente e por Concluídas no período. Responsáveis veem só os agentes de que cuidam.
Memória da empresa
O que os agentes aprendem fica guardado na empresa, e não no provedor de LLM: trocar de modelo não apaga nada.
- Abra a aba Memória.
- Filtre a Situação por Propostas para ver o que os agentes sugeriram.
- Para cada item, clique em Aprovar, Editar ou Arquivar. Itens arquivados podem ser restaurados ou excluídos.
- Para escrever um fato à mão, use Nova memória, escolha em Vale para (empresa toda, um repositório, uma função ou um agente) e clique em Adicionar.
Se preferir, ligue Aprovar automaticamente as memórias propostas pelos agentes. Cada tarefa recebe só as memórias ativas que valem para ela.
Orçamentos e limites
- Limite mensal de tokens da empresa: definido no cartão de provedores de LLM. Veja Conexões de LLM.
- Limite mensal de tokens do agente: no formulário do agente. Em branco, vale só o limite da empresa.
Ao atingir o limite, o agente aparece como pausado com Orçamento do mês esgotado e não pega trabalho novo até o mês virar. Tarefas longas de desenvolvimento também têm limites próprios de passos, tokens e tempo.
Privacidade
O conteúdo das tarefas passa pelo provedor de LLM escolhido. As transcrições ficam no banco da empresa pelo prazo de retenção definido, e as ações dos agentes ficam na auditoria.