Modelo, contexto, skill, ferramenta, agente, squad
Seis palavras parecem sinônimos quando você sai do chat comum. Separar cada uma evita pedir ao modelo uma coisa que deveria morar em outro lugar.
O primeiro tropeço ao sair do chat comum é chamar tudo de agente (programa configurado para executar tarefas). Você troca o modelo de IA (programa que lê pedidos e gera respostas) e espera que ele conheça a empresa. Escreve uma instrução longa e espera que ela vire ferramenta (recurso que permite ao modelo agir fora da conversa). Conecta uma ferramenta e espera que ela resolva o que falta saber sobre a empresa. Boa parte da frustração vem dessa confusão.
Antes de criar uma automação, separo seis partes. Cada uma resolve uma necessidade diferente.
Modelo
Modelo é o que raciocina. Ele lê a pergunta, combina padrões, escreve e escolhe o próximo passo. Quando troco o modelo, também troco o tipo e a qualidade do raciocínio. Um modelo pode ser mais cuidadoso, seguir uma sequência longa ou usar ferramentas com mais disciplina.
Troco de modelo quando a tarefa pede outro tipo de raciocínio. Isso pode ser arquitetura difícil, uma revisão cuidadosa ou escrita com regras. A troca não ensina o modelo sobre mim. Mesmo um modelo melhor não conhece meus projetos se eu não der contexto.
Contexto
Contexto é a informação que o sistema consegue consultar sem eu explicar tudo de novo. A conversa inteira não serve bem para isso. Ela se perde e acumula detalhes sem relação com a tarefa. Contexto útil fica em arquivos: decisões, perfis de clientes, regras de produto, glossários e históricos que alguém pode abrir de novo.
Preciso de contexto quando a resposta depende de mim, da empresa ou do projeto. Sem ele, uma proposta, um plano de venda ou uma revisão pode virar uma resposta genérica. Um modelo melhor também escreve algo genérico quando recebe informação genérica.
Skill
Uma skill é um roteiro de trabalho que o agente reconhece e segue. Ela registra um jeito de trabalhar, não lembranças. Se toda vez que reviso um plano verifico riscos, bloqueios e testes mínimos, posso guardar esses passos numa skill. Assim não preciso explicar o mesmo roteiro toda vez.
Uso uma skill quando a tarefa se repete com passos parecidos. Uma boa skill diz como agir, o que conferir e quando parar. Se falta informação, a skill não resolve o problema. Ela só ajuda a seguir melhor um roteiro.
Ferramenta
Uma ferramenta ou MCP (recurso que permite ao modelo agir fora da conversa) pode ler um banco, buscar na web, abrir um documento ou usar outro aplicativo. Sem isso, o modelo só responde. Pode escrever um plano perfeito sem mudar nada.
Uso uma ferramenta quando a tarefa exige consultar ou alterar algo externo. Por exemplo, ver o calendário, consultar uma base, criar um card ou ler um arquivo que não está no contexto. A ferramenta não pensa por você. Ela dá ao modelo um meio de agir.
Agente
O papel de um agente reúne contexto, ferramentas e um objetivo. Você dá um nome a esse papel quando quer chamá-lo de novo: revisor de PR (pedido para revisar e incluir mudanças no código), pesquisador, analista ou editor. O nome evita montar a mesma combinação outra vez.
Um agente faz sentido quando um trabalho frequente precisa da mesma postura e dos mesmos acessos. Se tudo muda a cada pedido, pode bastar uma conversa com boas instruções. Um agente começa a ajudar quando o papel fica estável.
Squad
Um squad reúne agentes diferentes para trabalhar na mesma tarefa. Um pesquisa, outro implementa e outro revisa. Assim, responsabilidades diferentes ficam separadas.
Só monto um quando a tarefa tem partes independentes ou precisa de opiniões que se contraponham. Para uma tarefa pequena, um squad só aumenta o trabalho de coordenação. Não é o primeiro passo.
Quase todo diagnóstico termina com esta pergunta: o que preciso agora? Posso dar contexto, seguir um roteiro, usar uma ferramenta ou chamar um papel especializado. Isso evita pedir ao modelo algo que deveria estar escrito num arquivo.
Para começar pelo passo certo, escreva primeiro o arquivo de contexto.
Onde isso quebra
É fácil avançar cedo demais. Quase todo mundo que quer montar um squad ainda não escreveu o arquivo de contexto. Cria vários agentes com nomes diferentes, e todos devolvem versões da mesma resposta genérica.
O custo aparece quando há coordenação sem conteúdo útil. Sem contexto, uma skill vira um roteiro vazio. Uma ferramenta vira um botão sem critério. Um agente vira só uma personalidade, e um squad vira uma reunião. Escreva a base antes de pedir que o sistema trabalhe como um time.