Pular para o conteúdo

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

  1. Na aba Gerenciar, clique em Novo agente.
  2. 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.
  3. Preencha Nome, O que ele faz e Habilidades (separadas por vírgula, até 8).
  4. 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.
  5. Escolha a Função, defina Quem pode pedir tarefas e a Cor do robô.
  6. 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çãoO que faz
AssistenteTrabalha no que pedirem, informa etapas e pergunta.
Revisor de códigoRevisa pull requests dos repositórios liberados e comenta no PR. Nunca aprova nem faz merge.
DesenvolvedorMuda o código na bancada da empresa, envia o branch da tarefa e abre o pull request. Nunca faz merge.
QARoda 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.

  1. Abra a aba Memória.
  2. Filtre a Situação por Propostas para ver o que os agentes sugeriram.
  3. Para cada item, clique em Aprovar, Editar ou Arquivar. Itens arquivados podem ser restaurados ou excluídos.
  4. 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.