A orquestra de agentes: um agente por função, com contexto e regras escritas
O diretor de uma empresa é um maestro: compras, marketing, comercial e financeiro tocam juntos e ele coordena. Com agentes é igual. Em vez de um assistente que sabe um pouco de tudo, você monta um por função, cada um com o seu contexto, as suas regras e o seu modelo, rodando num servidor ligado 24 horas.
2Um agente por empresa sabe a que repositório e base ir
3As regras do agente que programa
4Servidor 24/7 usando a assinatura, sem chave de API
Objetivo: desenhar sua equipe de agentes por função, com contexto por empresa, regras escritas e o modelo de cada um.
01 · A orquestra
Clique em cada agente.
Clique em cada bloco do diagrama para ver o que ele faz.
Separe por função E por empresa: o agente de uma clínica não precisa saber das obras da imobiliária.
02 · Montando a orquestra
Quatro decisões.
1. Onde roda
Agentes que atendem a equipe precisam ficar ligados. Um servidor alugado (VPS) resolve; existem plataformas abertas, como o Hermes Agent, que já trazem perfis de agente, terminal próprio e acesso pelo Telegram.
Para experimentar, uma máquina pequena basta; com uma dúzia de agentes, a memória costuma pedir 8 GB ou mais.
2. Quem paga
Várias plataformas conectam a assinatura que você já tem (ChatGPT/Codex, Claude) em vez de chave de API cobrada por uso.
Confira nos termos do seu plano se o uso automático é permitido e quanto ele aguenta por dia.
3. Contexto
Cada agente recebe só o que precisa: o repositório, a base de conhecimento, quem é quem na equipe e as regras daquela empresa.
Escreva a ordem das fontes da verdade: primeiro o repositório, depois a base de dados, depois o resto.
4. Regras
O jeito de trabalhar de um agente que já funciona vira arquivo de regras para o próximo. Peça ao agente bom: "escreva as regras de como você trabalha comigo".
Comece pelas regras do agente que programa: são as que mais evitam estrago.
03 · Modelos para copiar
O mapa fica com você. As regras vão nas instruções do agente que programa.
Mapa da orquestra
AGENTE | FUNÇÃO | CONTEXTO (fontes) | MODELO
coordenador | recebe, encaminha, junta | lista de agentes e o que cada faz | <top>
finanças | caixa, contas, previsão | ERP, bancos, planilha de custos | <top em números>
programação | código e automações | repositório, base de dados | <top em código>
dados | vendas, estoque, campanhas | CRM, anúncios, estoque | <econômico>
comercial-<X> | atende e qualifica | CRM da empresa X, produto, equipe | <econômico>
REGRAS GERAIS
- cada agente só lê as fontes da sua linha
- pedido fora da função volta ao coordenador
- relatório semanal de cada agente para você
Regras do agente que programa
REGRAS DE PROGRAMAÇÃO
ANTES DE COMEÇAR
- git status e git pull no repositório certo
- nunca trabalhar direto no main (nem no master)
DURANTE
- um ramo por tarefa, nome curto em kebab-case (ex.: corrige-boleto)
- commits pequenos, mensagem que diz o que mudou
- nada de senha, chave ou dado de cliente no repositório
(segredos ficam no cofre de senhas)
FONTES DA VERDADE, NESTA ORDEM
1. o repositório
2. a base de dados
3. a documentação
NO FIM
- abrir pull request com o que mudou e como testar
- NUNCA fazer o merge: quem aprova é uma pessoa
04 · Prática
Dá para fazer no papel antes de montar qualquer servidor.
1 · Mapa da orquestra
30 min
Copie o mapa e preencha com as funções da sua empresa (ou das empresas que você atende). Comece com no máximo cinco agentes.
Pronto quando: o mapa tem de 3 a 5 agentes, cada um com função, fontes de contexto e o tipo de modelo.
2 · Regras escritas
15 min
Salve as regras de programação como REGRAS-PROGRAMACAO.md no repositório onde o agente vai trabalhar e ajuste os nomes.
Pronto quando: o arquivo existe no repositório e tem a regra "nunca fazer o merge".
3 · Regras do agente bom
10 min
Peça ao agente com quem você já trabalha bem: "escreva as regras de como você trabalha comigo, em lista".
Pronto quando: você tem a lista e marcou as regras que vão para os agentes novos.
05 · A aula 3 em vídeo
O mecanismo da aula explicado em cerca de dois minutos e meio.
Você tem clínicas e uma imobiliária. Como separar os agentes comerciais?
Correto
Contexto separado evita mistura (o agente da clínica citando imóvel) e deixa cada um mais preciso. O coordenador encaminha; não substitui o especialista.
Não é essa
Contexto separado evita mistura (o agente da clínica citando imóvel) e deixa cada um mais preciso. O coordenador encaminha; não substitui o especialista.Rever: A orquestra
Pergunta 2 de 4
Qual regra do agente que programa evita o maior estrago?
Correto
Nome de ramo e mensagem ajudam a organizar. Quem impede código errado de chegar ao sistema em uso é a aprovação humana no pull request.
Não é essa
Nome de ramo e mensagem ajudam a organizar. Quem impede código errado de chegar ao sistema em uso é a aprovação humana no pull request.Rever: Modelos para copiar
Pergunta 3 de 4
Por que rodar os agentes num servidor e não no notebook?
Correto
Agente que atende a equipe tem de estar ligado quando você fecha o notebook. O modelo é o mesmo nos dois lugares.
Não é essa
Agente que atende a equipe tem de estar ligado quando você fecha o notebook. O modelo é o mesmo nos dois lugares.Rever: Montando a orquestra
Pergunta 4 de 4
Qual a forma mais rápida de escrever as regras de um agente novo?
Correto
O agente que já trabalha bem com você conhece o seu jeito. As regras dele são o ponto de partida mais fiel; depois você ajusta.
Não é essa
O agente que já trabalha bem com você conhece o seu jeito. As regras dele são o ponto de partida mais fiel; depois você ajusta.Rever: Montando a orquestra
Teste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.
Escolha uma alternativa. A explicação aparece depois da sua tentativa.
07 · Resumo
MaestroVocê coordena; o coordenador distribui; especialistas executam.
Contexto separadoPor função e por empresa, com a ordem das fontes da verdade.
Regras escritasNunca no main, commits pequenos, sem segredos, merge por pessoa.
Servidor e assinaturaLigado 24/7, usando o plano que você já paga.