👷 O que é um agente
Um agente é um trabalhador do Jarvis: uma peça que recebe uma tarefa, executa e devolve um resultado. Pense numa empresa de verdade — você não contrata uma pessoa para "fazer tudo". Você contrata alguém para atender, alguém para vender, alguém para organizar documentos. No Jarvis é igual: cada agente é como um funcionário com uma função clara. O serviço diz o que precisa ser feito; o agente é quem faz.
🧩 Agente = funcionário, não o sistema inteiro
O sistema (o Jarvis) é a empresa. O serviço é o departamento. O agente é a pessoa que senta na cadeira e faz o trabalho. Quando você separa essas três coisas, fica fácil desenhar a solução: primeiro o departamento (serviço), depois quem trabalha nele (agentes), depois o que cada um precisa para trabalhar bem.
✓ Um agente é
- ✓Um trabalhador com uma função
- ✓Quem executa o "como" do serviço
- ✓Algo que recebe entrada e devolve saída
- ✓Uma peça do sistema, não o sistema
✗ Um agente não é
- ✗O Jarvis inteiro numa caixa só
- ✗Um faz-tudo sem foco
- ✗Apenas "um prompt esperto"
- ✗Algo que decide sozinho a estratégia
🎯 Especializado: um trabalho cada
A regra de ouro dos agentes: um agente, um trabalho. Um agente que tenta fazer tudo faz tudo mal — ele perde o foco, as instruções viram um amontoado e ninguém consegue dizer se ele acertou. Já um agente especializado é fácil de instruir, fácil de testar e fácil de melhorar. Em vez de um "super agente", o Jarvis usa vários agentes pequenos, cada um afiado na sua tarefa.
✗ Um faz-tudo
- ✗Instruções enormes e confusas
- ✗Erra em tudo um pouco
- ✗Difícil saber onde falhou
- ✗Impossível medir sucesso
✓ Vários especializados
- ✓Instrução curta e clara por agente
- ✓Cada um acerta no que faz
- ✓Fácil ver quem falhou
- ✓Dá para medir e melhorar um por um
💡 Dica prática
Se você não consegue descrever o trabalho de um agente em uma frase ("ele classifica e-mails como urgente ou normal"), ele está fazendo demais. Quebre em dois. Quanto mais curta a descrição, melhor o agente.
📝 Instrução e contexto
Um trabalhador novo precisa de duas coisas no primeiro dia: a instrução (o que fazer e como) e o contexto (informação sobre a empresa, o cliente, a situação). Com o agente é igual. A instrução diz o trabalho; o contexto dá o terreno. Instrução sem contexto vira resposta genérica; contexto sem instrução vira informação solta. Os dois juntos é que fazem o agente trabalhar como gente de dentro da casa.
A instrução
"Você responde dúvidas de clientes sobre entrega. Seja direto, gentil e nunca prometa prazo que não está na tabela."
O contexto
A tabela de prazos, as políticas de troca, o nome da loja, o tom da marca — o terreno em que o agente pisa para decidir.
A tarefa
A pergunta concreta que chega na hora: "meu pedido 1042 chega quando?". Instrução + contexto + tarefa = resposta certa.
💡 Dica prática
Quando um agente responde "errado", quase sempre não é a instrução — é o contexto que faltou. Antes de reescrever a instrução, pergunte: ele tinha a informação necessária em mãos para acertar?
🧠 Memória e regras do agente
Além de instrução e contexto, um bom agente tem memória (o que ele lembra da conversa ou do histórico) e regras e limites (o que ele pode e o que nunca deve fazer). A memória evita que o cliente repita tudo a cada mensagem. As regras protegem a empresa: um agente sem limites é um risco. É aqui que se escreve a "ficha" do agente — e ela cabe em poucas linhas de chave:valor.
Ficha de um agente (chave:valor)
Ficha ilustrativa — toda peça do agente cabe em uma linha. Memória e contexto são aprofundados no Módulo 2.5.
🧠 A memória
O que o agente carrega entre uma mensagem e outra: o nome do cliente, o pedido em questão, o que já foi dito. Sem isso, ele "esquece" e o cliente repete tudo.
⛔ As regras e limites
As linhas que o agente nunca cruza: não inventar dados, não prometer o que não cumpre, não agir fora da sua alçada. O "não" protege tanto quanto o "sim".
✅ Critérios de sucesso
Como você sabe se um agente está fazendo um bom trabalho? Você precisa de um critério de sucesso: uma frase clara que diz o que é "deu certo" para aquele agente. Sem critério, qualquer resposta parece aceitável e você nunca sabe se vale melhorar. Com critério, você consegue testar, comparar e evoluir o agente — e dizer com segurança se ele está pronto ou não.
✗ Critério vago
- ✗"O agente responde bem"
- ✗"O cliente fica satisfeito"
- ✗Não dá para medir
- ✗Cada pessoa avalia diferente
✓ Critério claro
- ✓"Responde o status correto do pedido"
- ✓"Sem abrir chamado para o humano"
- ✓Dá para verificar caso a caso
- ✓Todo mundo concorda no que é "deu certo"
🎯 O critério vem antes de medir
No Dia 3 a gente mede resultado de verdade. Mas a medição só funciona se o critério foi escrito antes. Definir "o que é sucesso para este agente" é parte do desenho — não algo que se descobre depois.
🧭 Qual intenção o agente realiza
Aqui fecha o módulo com a pergunta que vem antes de tudo: qual intenção esse agente realiza? Não comece criando o agente; comece pela intenção que ele serve. A intenção do sistema (a alma, do 2.1) se desdobra em serviços, e cada serviço em agentes. Cada agente é a ponta fina de uma intenção maior. Se você não consegue dizer qual intenção um agente realiza, esse agente provavelmente não deveria existir.
💡 A pergunta antes da ferramenta
A tentação é começar perguntando "que agente eu crio?". O arquiteto de intenção começa por "qual intenção eu preciso realizar?" — e só então o agente aparece como consequência natural. A intenção é a causa; o agente é o efeito.
A intenção
"Quero que nenhum cliente fique sem resposta sobre sua entrega." É a dor que justifica o sistema.
O serviço
Atendimento sobre entregas — o departamento que atende essa intenção.
O agente
O agente_de_entregas — a ponta fina que realiza, na prática, aquela intenção, com sua ficha completa.
🧾 O checklist de um agente saudável
- Tem uma intenção clara que justifica sua existência.
- Tem um trabalho só — descreve-se em uma frase.
- Tem instrução, contexto, memória, regras e limites — a ficha completa.
- Tem um critério de sucesso verificável, escrito antes.
Auto-checagem (opcional): qual é a pergunta que vem ANTES de criar um agente?
🎯 Resumo do módulo
Próximo módulo:
2.4 — Habilidades: o que cada agente sabe fazer, na prática.