🤝 Agentes — o loop que trabalha sozinho
Ate aqui voce deu ao Jarvis canais, identidade, ferramentas e skills. Mas o que faz dele um agente — e nao so um chat esperto — e o loop autonomo: a capacidade de pensar, agir, ler o resultado e continuar sozinho ate terminar. Neste modulo voce vai entender esse loop, como delegar trabalho a sub-agentes, quando vale ter varios agentes, como ele acorda no horario certo, e onde colocar as travas para que tudo isso seja seguro.
🔁 Agente = loop + autonomia
Um chatbot comum faz uma coisa: voce pergunta, ele responde, fim. Um agente e diferente — ele nao para na primeira resposta. Ele recebe um pedido, pensa no que fazer, usa uma ferramenta (busca na web, le um arquivo, manda um e-mail), le o resultado dessa ferramenta, e decide se ja terminou ou se precisa dar mais um passo. Esse vai-e-volta que se repete sozinho ate a tarefa estar pronta e o que chamamos de loop agentico.
Novo aqui? Um agente e um modelo de IA (o "cerebro" de texto que voce viu na Trilha 1) que ganhou maos — as ferramentas — e a permissao de usa-las em ciclo. "Loop" e so a palavra para "repetir um ciclo". "Autonomia" aqui nao quer dizer que ele faz o que quer; quer dizer que ele encadeia varios passos sem precisar que voce digite a cada um.
Na Trilha 1 voce viu esse loop pela primeira vez como uma ideia. Aqui ele vira uma camada da anatomia: a peca que transforma "modelo + ferramentas" num assistente que executa. Sem o loop, voce teria que orquestrar cada chamada na mao ("agora busca", "agora resume", "agora manda"). Com o loop, voce diz o objetivo e ele mesmo descobre a sequencia de passos.
Leia o diagrama da esquerda para a direita: o agente pensa, chama uma ferramenta, le o que voltou e decide. Enquanto faltar algo, a seta tracejada o leva de volta ao "pensa". Quando termina, sai pela direita em "pronto". Esse ciclo que se fecha sozinho e o coracao de qualquer agente.
Conceitos-chave
Um LLM que pode usar ferramentas em ciclo para cumprir um objetivo.
Pensa → age → le resultado → decide; repete ate terminar.
Encadear varios passos sozinho, sem voce digitar cada um.
Voce diz o objetivo; ele descobre a sequencia.
🧑🚀 Sub-agentes: delegar e voltar leve
Toda conversa do Jarvis vive dentro de uma janela de contexto — a memoria de trabalho dele, limitada, como a RAM de um computador (voce viu isso na Trilha 1). Se uma tarefa for grande — ler 30 paginas, vasculhar um repositorio inteiro, pesquisar 15 fontes — ela entope essa janela com texto bruto, e o agente principal fica lento, confuso e caro. A solucao elegante e o sub-agente.
Novo aqui? Um sub-agente e um segundo agente que o agente principal cria so para uma tarefa pesada. Ele abre a propria janela de contexto, faz o trabalho sujo (le tudo, processa, descarta o lixo) e devolve so a resposta limpa. A bagunca fica na cabeca dele; o agente principal recebe so o resumo.
📦 A analogia do estagiario
Imagine que voce e um gerente ocupado. Chega uma tarefa: "leia este relatorio de 200 paginas e me diga os 3 pontos principais". Voce nao le as 200 paginas e enche sua propria cabeca — voce manda um estagiario ler. Ele queima o tempo dele com as 200 paginas e volta com um bilhete de 3 linhas. Sua mesa continua limpa. O sub-agente e exatamente esse estagiario.
- •O sub-agente queima o proprio contexto com o material bruto.
- •Ele devolve so a resposta destilada — nao o material todo.
- •A sessao principal fica leve, focada e barata.
✓ Quando usar sub-agente
- ✓Tarefa que gera MUITO texto intermediario (busca ampla, leitura longa).
- ✓Trabalho isolavel: tem um pedido claro e devolve um resultado claro.
- ✓Quer proteger a conversa principal de virar uma bagunca.
✗ Quando NAO compensa
- ✗Tarefa curtinha — abrir um sub-agente custa mais do que resolver direto.
- ✗Passos que dependem de muito vai-e-volta com voce no meio.
- ✗Quando voce PRECISA ver o material bruto, nao so o resumo.
Conceitos-chave
Agente auxiliar que faz a tarefa pesada e devolve so a resposta.
A memoria de trabalho, limitada, do agente (a "RAM").
A bagunca fica no sub-agente; o principal nao se contamina.
So o essencial volta — economia de contexto e de custo.
🐝 Multi-agente: um time de especialistas
Se um sub-agente e um estagiario, o multi-agente e um time inteiro. Em vez de um agente fazendo tudo, voce monta varios especialistas — um que so pesquisa, um que so escreve, um que so revisa — e um orquestrador que distribui as partes e junta o resultado. Cada especialista tem o proprio contexto, o proprio foco, e ate pode usar um cerebro diferente (um modelo barato para a busca, um potente para a redacao).
O orquestrador reparte a tarefa entre especialistas e depois costura tudo. Mais paralelismo e mais foco — mas tambem mais pecas para coordenar e mais chance de uma falhar. Por isso multi-agente so compensa quando a tarefa e grande o bastante para justificar a complexidade.
⚠️ A armadilha do "mais agentes = melhor"
E tentador montar um exercito de agentes para tudo. Quase sempre e exagero. Cada agente extra adiciona coordenacao, custo, latencia e novos pontos de falha — se a "revisao" interpreta mal o que a "escrita" entregou, o erro se propaga. Regra pratica: comece com um agente so e o loop. So quebre em multi-agente quando uma tarefa real esta grande demais ou exige especializacoes que realmente nao convivem na mesma cabeca.
Conceitos-chave
Varios agentes especialistas trabalhando juntos numa tarefa.
O agente que divide o trabalho e junta os resultados.
Cada agente foca em uma coisa (pesquisa, escrita, revisao).
Mais agentes = mais pecas para alinhar e mais falhas possiveis.
⏰ Cadencia: ele acorda sozinho
Ate agora o agente so age quando voce fala com ele. A cadencia muda isso: ela faz o Jarvis agir no horario certo, sem ninguem chamar. As 7h, ele monta o resumo do seu dia; a cada 30 minutos, dá uma olhada na sua caixa de e-mail; toda sexta, ele organiza suas anotacoes. Tudo isso enquanto voce dorme, trabalha ou — como dizem os criadores desses sistemas — "com o laptop fechado".
Novo aqui? Cron e um agendador de tarefas que existe ha decadas nos computadores: voce escreve "rode isto todo dia as 7h" e ele obedece. Heartbeat ("batimento cardiaco") e o mesmo principio aplicado ao agente: um pulso regular que o acorda de tempos em tempos para checar se ha algo a fazer. Routines e so o nome amigavel que alguns sistemas dão para essas tarefas agendadas.
O relogio dispara
Chega o horario marcado (ex.: 7h). O agendador acorda o agente — sem voce digitar nada.
Ele roda o loop
O agente executa a tarefa programada: le a agenda, busca os e-mails, monta o resumo.
Te avisa pelo canal
A resposta chega no Telegram (ou no canal que voce usa). Voce acorda com o trabalho ja feito.
📊 Onde isso aparece nos sistemas reais
- •O OpenClaw popularizou o heartbeat — um pulso que mantem o agente "vivo" e checando coisas.
- •O GravityClaw usa node-cron para tarefas agendadas, mantendo tudo enxuto.
- •Na arquitetura das "4 C" (Trilha 4), isso e a Cadence — o "quando ele age".
Conceitos-chave
A camada que faz o agente agir no horario, sem ser chamado.
Agendador classico: "rode isto neste horario".
Pulso regular que acorda o agente para checar tarefas.
Tarefas agendadas com nome amigavel (resumo das 7h etc.).
🛡️ Limites e seguranca do loop
Um agente que age sozinho e poderoso — e por isso mesmo precisa de freios. Sem travas, o loop pode girar para sempre (e gastar uma fortuna), ou executar uma acao perigosa sem ninguem perceber. Tres travas resolvem a maior parte disso: um teto de iteracoes, gates de aprovacao e um audit log.
Novo aqui? Teto (ou limite) de iteracoes e um numero maximo de voltas que o loop pode dar antes de parar (ex.: "no maximo 15"). Gate de aprovacao e um pedido de "voce confirma?" antes de uma acao arriscada. Audit log e um diario que registra cada passo que o agente deu — uma "memoria forense" para voce revisar depois o que ele fez e por que.
🔢 Teto de iteracoes
Limita quantas voltas o loop pode dar. Impede o agente de ficar preso "pensando" eternamente e de queimar dinheiro a toa.
✋ Gates de aprovacao
Acoes perigosas (apagar arquivos, gastar dinheiro, rodar comandos) param e pedem seu "ok" antes de acontecer.
📜 Audit log
Cada passo fica registrado. Se algo der errado, voce abre o diario e ve exatamente o que ele fez e quando.
⚠️ Por que isso nao e opcional
Lembre da Trilha 2: o OpenClaw teve 42.665 instancias publicas, sendo 93,4% sem nenhuma autenticacao, e 341 skills maliciosas na comunidade. Um agente exposto e sem travas e um agente que qualquer um pode mandar agir. A postura correta e zero-trust: trate toda entrada como um possivel ataque (incluindo prompt-injection, quando um texto malicioso tenta dar ordens disfarcadas ao agente).
A combinacao segura, repetida em todo o curso: sem portas expostas + so MCP auditavel + whitelist de quem pode falar + secrets no .env + as tres travas acima.
Conceitos-chave
Numero maximo de voltas do loop — evita loop infinito e gasto.
Confirmacao humana antes de uma acao perigosa.
Registro forense de cada acao do agente.
Texto malicioso que tenta dar ordens disfarcadas ao agente.
🚀 Proativo vs reativo: de assistente a parceiro
Junte tudo deste modulo — o loop, os sub-agentes, a cadencia — e voce chega ao maior salto de todos: o Jarvis deixa de ser reativo (so responde quando voce chama) e passa a ser proativo (te avisa antes de voce pedir). Em vez de voce perguntar "tem algo importante na minha agenda hoje?", ele te manda, as 7h: "voce tem reuniao as 10h e o relatorio vence amanha — quer que eu prepare um rascunho?".
😐 Reativo (o assistente)
- →Espera voce iniciar a conversa.
- →So sabe o que voce digitou agora.
- →Util, mas voce ainda carrega a carga mental de lembrar de tudo.
🤝 Proativo (o parceiro)
- →Inicia a conversa quando faz sentido (cadencia).
- →Conecta agenda, e-mail e memoria para antecipar.
- →Tira a carga mental de voce — vira um socio, nao uma ferramenta.
🧩 A receita do salto proativo
Proatividade nao e magia — e a soma das pecas que voce ja conhece. Loop (ele executa sozinho) + cadencia (ele acorda no horario) + ferramentas (ele ve sua agenda e e-mail, da Trilha 3-3) + memoria (ele lembra do que importa, vem na 3-6). Tire qualquer peca e ele volta a ser reativo.
Cuidado com o equilibrio: um agente proativo demais vira um chato que interrompe o tempo todo. A boa proatividade e seletiva — avisa do que importa, fica quieto no resto.
Auto-checagem (opcional): qual e a melhor descricao de um sub-agente?
Conceitos-chave
So age quando voce chama — o modo "assistente".
Te avisa antes de voce pedir — o modo "parceiro".
O peso de lembrar de tudo; o proativo tira isso de voce.
Avisar do que importa, ficar quieto no resto.
🎯 Resumo do modulo
Proximo modulo:
Modulo 3-6: Cerebros — o motor que pensa e a memoria organizada