Trilha única · 5 aulas curtas
Em cinco sessões de 15 a 21 minutos, você sai sabendo explicar as quatro camadas de um sistema de IA, por que o terminal com agente é a que faz o trabalho de verdade, e como escrever as regras para ele trabalhar do seu jeito.
Vídeo de 2 minutos: as quatro camadas, do chat ao harness. Assista antes da aula 1 ou depois da aula 2.
Aulas
Saia sabendo dizer, com exemplos do seu trabalho, onde o chatbot do navegador ajuda e em que ponto exato ele trava.
Saia sabendo desenhar num guardanapo as camadas chat, editor, terminal e harness, e explicar por que o terminal tem mãos.
Saia reconhecendo, numa sessão real de agente, o que ele leu, o que executou, quando pediu permissão e como conferiu.
Saia com a primeira versão das instruções fixas do seu agente escrita, e as sete peças do harness nomeadas.
Saia com cinco tarefas da sua semana classificadas por camada, e pelo menos uma pronta para ir ao terminal.
Aula 1 · Fundamento
Ao fim desta aula você consegue apontar, numa tarefa real do seu trabalho, o momento exato em que o chatbot do navegador deixa de ajudar e começa a custar seu tempo.
Você já paga por uma IA e ainda passa a tarde copiando e colando. Cola um relatório, lê a resposta, cola outro, corrige à mão, e no dia seguinte a conversa não lembra de nada. O incômodo é real, e não é culpa sua: é o limite da camada que você está usando.
↓ role para estudar
Um chatbot web é a IA que você abre no navegador e conversa. É a primeira camada de qualquer sistema de IA, e ela é boa no que faz: pensar junto, redigir, resumir, traduzir, dar uma segunda opinião em segundos. Não exige preparo nenhum. Abriu, escreveu, recebeu.
Helena, diretora de operações de uma indústria de embalagens, usa assim todo dia: cola a ata da reunião de produção e pede os três riscos que ninguém falou em voz alta. Em vinte segundos tem uma leitura que valeria uma hora de um consultor. Para esse tipo de tarefa, uma conversa com um texto só, a camada 1 é imbatível.
antes, sem IA
Helena lia a ata inteira à noite, marcava à caneta e escrevia o resumo de manhã. Uma hora e meia.
com o chat web
Cola a ata, pede os riscos, revisa a resposta com o que ela sabe da fábrica. Doze minutos.
Saldo: cerca de 80 minutos por reunião, em tarefas de um texto só. É aqui que o chat brilha.
O consultor ao telefone tem um problema: ele não está na sua sala. Não vê as pastas em cima da mesa. Tudo que ele sabe é o que você lê para ele. Com o chat web é igual. Ele não enxerga seu computador, então cada arquivo precisa ser copiado, colado, e a resposta copiada de volta. Você vira o mensageiro entre a IA e o seu próprio trabalho.
Rafael, arquiteto, sentiu isso na semana das propostas. Tinha catorze orçamentos antigos numa pasta e queria uma tabela comparando preço por metro quadrado. No chat, colou um por um. Na sétima proposta, a conversa "esqueceu" a primeira. Na décima, ele desistiu e fez na planilha à mão. O problema não era a inteligência da IA. Era que ela não tinha acesso à pasta.
Repare no padrão: a tarefa com um texto funciona; a tarefa com vários arquivos quebra. Esse é o teto da camada 1, e ele aparece exatamente nas tarefas que mais tomam seu tempo.
Teste-se
Camila, dentista, quer um resumo dos pontos de atenção de 30 fichas de anamnese que estão em arquivos separados no computador da clínica. O que acontece se ela usar só o chat web?
O segundo teto é a memória. Você explica ao chat como a sua empresa escreve, quais clientes são prioridade, qual formato de relatório você gosta. Amanhã, nova conversa, tudo esquecido. É como um consultor que a cada ligação pede para você contar a história da empresa de novo.
Denise, consultora de marketing, mantém um documento com "as regras da minha escrita" e cola no início de toda conversa. Funciona, mas é gambiarra: ela é a memória da IA. Quando esquece de colar, o texto sai com o tom errado e ela só percebe depois de enviar ao cliente.
Guarde esses dois tetos, acesso e memória. As próximas camadas existem para derrubar exatamente esses dois.
O chat é ótimo para conversar sobre um texto. Ele trava quando o trabalho mora em vários arquivos e se repete toda semana.
Pratique agora 0/4 feito
Em cerca de 10 minutos, pegue uma tarefa real da sua semana que envolva mais de um arquivo e registre onde o chat web deixa de ajudar. Você sai com o "ponto de travamento" escrito.
Nada aqui muda nada no seu computador nem nas suas conversas. É observação. Se a tarefa escolhida não travar, ótimo: anote isso também, é uma tarefa que pertence à camada 1.
Você acabou de localizar, com uma tarefa sua, o limite exato da camada 1. É essa frase que as próximas aulas vão resolver.
Resumo
Aula 2 · Fundamento
Ao fim desta aula você consegue desenhar num guardanapo as quatro camadas de um sistema de IA (chat, editor, terminal, harness) e dizer, para cada uma, a vantagem e o ponto onde ela trava.
Todo mês aparece uma ferramenta nova de IA e alguém do seu time diz que "essa é a boa". Sem um mapa, você compra pelo barulho. Com o mapa das camadas, você olha qualquer ferramenta e sabe em dez segundos em que andar ela mora e o que ela consegue fazer de verdade.
↓ role para estudar
A segunda camada é a IA que mora dentro de um editor de código. Se o chat é um consultor ao telefone, esta é um assistente sentado ao seu lado, olhando a mesma tela. Ele enxerga o arquivo que está aberto e sugere mudanças ali mesmo, sem você copiar nada.
É um salto grande para quem programa. Para Rafael, arquiteto, é menos útil: o editor foi feito para código, não para propostas e plantas. E mesmo para o programador, o assistente só vê o que está na tela. Se a resposta depende de outros vinte arquivos da pasta, ele adivinha. E quem executa, testa e confere continua sendo a pessoa.
Vantagem: vê o arquivo aberto e edita no lugar. Teto: só enxerga a tela, e as mãos ainda são suas.
O terminal é uma janela de texto que existe em todo computador. Você escreve um pedido, o computador executa e responde por escrito. Sem menus, sem botões. Parece antigo, e é: é a forma mais direta de falar com a máquina, anterior a qualquer tela bonita.
Por que isso importa? Porque um agente colocado nesse balcão consegue fazer tudo que uma pessoa faria clicando, só que por escrito e mais rápido. Ele abre a pasta inteira de Rafael, lê as catorze propostas, monta a tabela, confere se somou certo e avisa quando termina. Nada é copiado por você. É o funcionário com as chaves do escritório, não o consultor ao telefone.
chat web
Rafael cola 14 propostas, uma a uma. Perde as primeiras. Desiste na décima e faz na planilha.
agente no terminal
Rafael escreve: "leia as propostas desta pasta e monte uma tabela de preço por metro quadrado". O agente lê as 14, monta, confere e entrega.
Saldo: de uma tarde perdida para 4 minutos, e a tabela sai conferida contra os arquivos originais.
Um funcionário com as chaves do escritório, sem manual e sem limites, é um risco. Por isso existe a quarta camada. O harness é tudo que fica em volta do agente para ele trabalhar do seu jeito: o manual de "como fazemos aqui", o crachá que diz o que ele pode abrir sozinho e o que precisa pedir, as receitas para tarefas repetidas, os avisos automáticos, as portas para a agenda e o e-mail.
Camila, dentista, não quer um agente que mande mensagem para paciente por conta própria. No harness dela está escrito: "mensagem para paciente só com minha aprovação; agenda e estoque, pode mexer". Isso não é programação. É uma folha de regras que o agente lê toda vez que começa a trabalhar. A aula 4 abre o harness peça por peça.
Teste-se
Helena quer que o agente prepare o relatório semanal de produção sozinho, mas nunca envie nada para a diretoria sem ela ler. Em que camada essa regra mora?
Toda tarefa útil de IA passa por um ciclo: entender o pedido, planejar, fazer, olhar o resultado, corrigir, entregar. O chat web para no "planejar": ele diz o que fazer e você faz. O editor faz um pedaço, no arquivo aberto, e você confere. O agente no terminal percorre o ciclo inteiro, porque tem acesso aos arquivos, consegue executar e consegue olhar o que saiu.
Denise, consultora de marketing, pediu ao agente: "gere o relatório mensal dos três clientes com os dados desta pasta, no modelo do mês passado". O agente leu os dados, montou os três, percebeu que um cliente tinha uma planilha faltando, avisou, e entregou os outros dois prontos. No chat ela teria colado dados por uma hora e descoberto a planilha faltante depois de enviar.
Por isso o terminal é a melhor camada. Não é a mais bonita nem a mais fácil de abrir na primeira vez. É a única em que a IA tem mãos e olhos ao mesmo tempo: faz, confere e corrige sem você no meio.
O chat responde. O terminal executa. O harness garante que ele execute do seu jeito.
Pratique agora 0/3 feito
Em cerca de 8 minutos, leia o caso, decida a camada de cada tarefa e compare com o gabarito. Você sai com o mapa das camadas aplicado a uma semana real.
É análise em papel: nenhuma ferramenta é aberta. Se a sua resposta divergir do gabarito, leia a justificativa: em decisão de camada, a diferença costuma estar em "quantos arquivos" e "repete ou não".
O caso. Helena, diretora de operações, listou quatro coisas da semana: (1) responder um e-mail delicado de um fornecedor atrasado; (2) cruzar as 12 planilhas de turno para achar as paradas de máquina não justificadas; (3) toda segunda, montar o relatório de produção da semana anterior no mesmo modelo, a partir dos arquivos que a fábrica gera; (4) o engenheiro de processos quer ajuste rápido num arquivo de cálculo que está aberto na tela dele.
(1) Chat web. Um texto, uma resposta, tom importa: é o melhor uso da camada 1. (2) Terminal. Doze arquivos, cruzamento e verificação: só o agente com acesso à pasta fecha o ciclo. (3) Terminal + harness. É tarefa de vários arquivos que repete toda semana no mesmo modelo: o agente executa, e o modelo e a regra "não envie sem eu ler" ficam escritos no harness. (4) Editor. Arquivo único, aberto na tela de quem programa: a camada 2 resolve no lugar.
Você acabou de aplicar o mapa das camadas a uma semana de trabalho, tarefa por tarefa.
Resumo
Aula 3 · Ferramenta
Ao fim desta aula você consegue ler uma sessão real de agente no terminal e apontar, linha por linha, onde ele leu arquivos, onde executou, onde pediu permissão e onde conferiu o resultado.
A primeira vez que alguém abre um terminal, a tela preta assusta e a pessoa fecha. Isso afasta justamente quem mais ganharia com ele. Esta aula tira o susto mostrando o que aparece na tela e o que cada linha significa, para que você saiba o que está vendo quando alguém do seu time, ou você, sentar ali.
↓ role para estudar
No computador de qualquer um há um programa chamado Terminal (no Mac) ou Terminal do Windows. Ele abre uma janela quase vazia com um cursor piscando. Só isso. Nada foi ativado nem alterado. É uma folha em branco esperando um pedido por escrito.
Rafael abriu o dele pela primeira vez esperando "coisa de programador". Viu o cursor e escreveu, sem entender muito, o comando que o sobrinho indicou. O computador respondeu com a lista das pastas dele. A tela preta só é assustadora até responder a primeira vez.
O que você vai ver a seguir é uma receita mínima: um pedido de uma palavra, e a resposta do computador. Você não precisa decorar nada, só reconhecer o formato pergunta e resposta.
pedido e resposta
$ ls
Propostas Plantas Contratos Fotos-obra
Com o terminal aberto na pasta certa, uma palavra chama o agente (no exemplo, o Claude Code). A partir daí você escreve o pedido em português comum, como escreveria para um funcionário. A diferença em relação ao chat é que o agente está dentro da pasta: ele pode ler os arquivos sem que você cole nada.
Denise, consultora de marketing, faz assim para o relatório mensal: entra na pasta do cliente, chama o agente e escreve "monte o relatório de setembro no modelo do de agosto, com os dados das planilhas desta pasta". O agente lista o que vai fazer, lê os arquivos e começa.
Erro comum
Chamar o agente na pasta errada. Ele só enxerga a pasta onde foi aberto e as de dentro dela. Se você o abriu na pasta "Documentos" inteira, ele vai vasculhar tudo e demorar; se abriu numa pasta vazia, vai dizer que não achou nada. Antes de chamar, confira o nome da pasta na resposta do computador.
na pasta certa
$ cd Clientes/Padaria-Nova $ claude > monte o relatório de setembro no modelo do de agosto, com as planilhas desta pasta
Vou ler: agosto-relatorio.docx, setembro-vendas.xlsx, setembro-redes.xlsx Lendo 3 arquivos… Montando relatorio-setembro.docx
na pasta errada
$ claude > monte o relatório de setembro no modelo do de agosto
Não encontrei nenhuma planilha nem relatório de agosto nesta pasta (Documentos). Quer que eu procure nas subpastas? Isso pode demorar.
Ler arquivos o agente faz sozinho. Criar, alterar ou apagar, ele pergunta antes, e você responde sim ou não. É a mesma lógica de um funcionário novo: consulta à vontade, mas para assinar qualquer coisa vem perguntar. Na aula 4 você vê como mudar esse comportamento pelo harness; por padrão, ele pergunta.
Camila, dentista, gosta disso. Quando pediu ao agente para "reorganizar a pasta de radiografias por paciente", ele mostrou o plano, avisou que ia mover 212 arquivos e esperou o sim dela. Ela leu o plano, viu que ele ia separar por sobrenome e não por nome, corrigiu em uma frase e aí sim disse sim.
O que aparece na tela é sempre o mesmo formato: o que ele quer fazer, sobre o quê, e a pergunta. Abaixo, um exemplo.
pedido de permissão
> reorganize a pasta Radiografias em subpastas por paciente
Plano: criar 48 subpastas (uma por paciente, pelo nome no arquivo) e mover 212 arquivos. Nenhum arquivo será apagado. Posso mover os arquivos? [s/n]
A parte que separa o agente do chat está no fim: depois de fazer, ele olha o resultado. Contou os arquivos movidos? Bate com o plano? O relatório abriu? Se algo não fechou, ele diz, em vez de entregar bonito e errado. Helena chama isso de "o funcionário que confere antes de trazer para a minha mesa".
No relatório semanal de produção, o agente de Helena avisou: "o turno da noite de quinta não tem planilha; montei o relatório sem ele e marquei a lacuna em vermelho". No chat, esse buraco teria passado despercebido até a reunião de diretoria.
O que procurar numa sessão de agente
Pratique agora 0/3 feito
Em cerca de 8 minutos, leia a transcrição abaixo, numere onde o agente leu, planejou, pediu permissão, executou e conferiu, e compare com o gabarito.
É leitura, nada é executado. Quem já se sentir à vontade pode, depois, abrir o próprio terminal e escrever só a primeira linha da aula (o comando de listar), que não altera nada. Não é exigido para esta prática.
A sessão. Rafael, na pasta Propostas, escreveu: "monte uma tabela com nome do cliente, área e preço por metro quadrado de cada proposta desta pasta". Na tela apareceu, nesta ordem: (a) "Encontrei 14 arquivos: proposta-alves.pdf, proposta-bento.pdf…"; (b) "Vou extrair cliente, área e valor de cada um e calcular preço por m²"; (c) "Posso criar o arquivo tabela-propostas.xlsx nesta pasta? [s/n]"; (d) "Criando tabela-propostas.xlsx… 14 linhas"; (e) "Conferi: 14 propostas, 14 linhas. A proposta-lima.pdf não tem área informada; deixei a célula em branco e marquei em amarelo."
(a) leu · (b) planejou · (c) pediu permissão · (d) executou · (e) conferiu. Se Rafael dissesse "não" em (c), nada seria criado: a pasta ficaria exatamente como estava, porque a permissão vem antes de qualquer alteração. Repare também que a etapa (e) apontou uma lacuna (a proposta sem área) em vez de inventar um número: é o comportamento que você quer de um agente, e é o que o chat não tem como fazer.
Você acabou de ler uma sessão de agente inteira sabendo o que cada linha significa. A tela preta deixou de ser preta.
Resumo
Aula 4 · Fundamento
Ao fim desta aula você consegue nomear as sete peças do harness e escrever, em português, a primeira versão das instruções fixas do seu agente, com pelo menos três regras e um limite.
Um agente sem harness é um funcionário brilhante no primeiro dia: não sabe como a sua empresa escreve, o que pode assinar, quem é prioridade. Você acaba repetindo tudo a cada sessão, que é a mesma dor do chat. O harness é o que transforma um agente genérico no seu agente, e a peça mais importante dele cabe numa folha.
↓ role para estudar
A primeira peça do harness é uma folha de texto que o agente lê toda vez que começa a trabalhar. Chama-se instruções fixas. Nela você escreve, uma vez, o que hoje repete em toda conversa: como a sua empresa escreve, quais clientes têm prioridade, que formato de relatório você usa, o que ele nunca deve fazer.
Denise transformou o documento "regras da minha escrita", que colava à mão no chat, nessa folha. Agora o agente já começa sabendo: "tom direto, sem gíria, parágrafos curtos, nunca prometer resultado de campanha". Ela não cola mais nada. É a memória entre conversas que faltava na aula 1, resolvida com uma folha.
sem instruções fixas
Denise explica o tom e as regras a cada sessão. Quando esquece, o texto sai errado e ela descobre depois de enviar.
com instruções fixas
As regras estão na folha. Toda sessão começa com elas lidas. Mudou uma regra? Edita a folha, vale para sempre.
Saldo: zero repetição por sessão, e o tom errado deixou de chegar ao cliente.
O agente age por meio de ferramentas: ler e escrever arquivos, executar tarefas no computador, buscar na internet, abrir um site. São as mãos dele. Sem ferramentas, ele volta a ser um chat. A terceira peça, as permissões, é o crachá: define o que ele pode fazer sozinho e o que precisa perguntar. Ler, quase sempre livre. Apagar, publicar, enviar, pagar: só com o seu sim, ou proibido de vez.
Camila decidiu o crachá do agente da clínica em cinco linhas: agenda e estoque, pode mexer; pasta de radiografias, pode organizar mas nunca apagar; mensagem a paciente, só com aprovação dela; dados de prontuário, fora do alcance. Não é um sistema de segurança que ela comprou. É uma lista escrita que o agente respeita.
Repare que ferramenta e permissão se completam: a ferramenta diz o que ele consegue fazer; a permissão diz o que ele está autorizado a fazer.
Tarefa que se repete merece uma receita. Uma skill é isso: o passo a passo de "fazer o relatório mensal" escrito uma vez, com o modelo, a ordem e as checagens. Depois, você só diz "faz o relatório mensal" e ele segue a receita. É o molde de costura reutilizável: corta o mesmo vestido em qualquer tecido.
Um hook é um gatilho: "toda vez que terminar um relatório, confira os totais contra a planilha" ou "antes de publicar qualquer coisa, me avise". Helena tem um: "ao fim de toda sessão, liste o que mudou e o que ficou pendente". Ela não pede; acontece.
Teste-se
Rafael quer que, toda vez que o agente montar uma proposta, ele confira automaticamente se o preço por metro quadrado está dentro da faixa do escritório. Isso é skill ou hook?
A sexta peça são as conexões com outros sistemas. O nome técnico é MCP, mas pense em tomadas: uma para a agenda, uma para o e-mail, uma para a planilha da equipe. Ligou a tomada, o agente passa a enxergar aquele sistema como enxerga a pasta.
A sétima é memória e divisão de trabalho. O agente pode guardar o que aprendeu sobre o seu jeito entre sessões, e, em tarefas grandes, chamar outros agentes para trabalhar em paralelo, como um gerente distribui uma auditoria entre analistas. Helena usa isso no fechamento do mês: um agente cuida das planilhas de turno, outro das de manutenção, e o principal junta tudo e confere.
Você não precisa ligar as sete peças no primeiro dia. Instruções fixas e permissões já mudam tudo. O resto entra quando uma tarefa pedir.
Junte as peças e o ciclo da aula 2 muda de qualidade. O pedido chega e o agente já leu o manual da casa. Planeja dentro do crachá. Se a tarefa tem receita, segue a receita. Executa com as mãos que você liberou, nas tomadas que você ligou. Confere, e o gatilho de fim de sessão lista o que mudou. Da próxima vez, lembra.
Para Camila, a diferença prática é que o agente da clínica se comporta como uma recepcionista de dez anos de casa, e não como uma temporária no primeiro dia. Mesmo modelo de IA. O que mudou foi a folha em volta dele.
O modelo é o mesmo para todo mundo. O harness é o que faz dele o seu.
Pratique agora 0/4 feito
Em cerca de 12 minutos, use o seu chatbot de sempre para redigir a folha de instruções fixas do seu futuro agente: três regras de como trabalhar e um limite do que ele nunca faz. Você sai com a folha pronta para colar quando o agente existir.
É um texto, nada mais. Não liga agente nenhum nem muda nada no computador. Se a resposta vier genérica, é porque faltou o seu contexto: acrescente um exemplo real e peça de novo.
Você vai me ajudar a escrever as instruções fixas de um agente de IA que vai trabalhar comigo. Sou <sua profissão e contexto, ex.: dentista com clínica de 3 cadeiras>. As tarefas que ele vai fazer: <2 ou 3 tarefas reais, ex.: organizar agenda, montar relatório mensal>. Como eu gosto que as coisas sejam feitas: <tom, formato, prioridades>. O que ele nunca deve fazer sem me perguntar: <ex.: enviar mensagem a paciente, apagar arquivos>. Escreva a folha em português, com estas seções: "Quem eu sou", "Como trabalhamos aqui" (3 a 5 regras curtas), "Pode fazer sozinho", "Só com minha aprovação", "Nunca". Frases curtas, sem jargão.
Você acabou de escrever a peça mais importante do harness. Quando o agente existir, é a primeira coisa que ele vai ler.
Resumo
Aula 5 · Prática
Ao fim desta aula você consegue olhar cinco tarefas da sua semana e dizer, em segundos e com motivo, qual vai para o chat, qual para o editor, qual para o terminal e qual merece entrar no harness.
Sem uma regra de decisão, a tendência é usar o chat para tudo, porque é o que está aberto. Aí as tarefas grandes continuam manuais e a IA vira só um redator mais rápido. A regra desta aula cabe em quatro linhas e devolve as horas que estão indo embora nas tarefas de vários arquivos.
↓ role para estudar
Todo o curso se resume a uma pergunta por tarefa: quantos arquivos ela envolve, e ela se repete? A resposta aponta a camada. A regra abaixo é a que Helena colou na parede da sala dela, e serve igual para o consultório de Camila ou o escritório de Rafael.
A regra de decisão
Denise, consultora de marketing, aplicou a regra numa segunda-feira. Sobrou na lista dela: responder a proposta de um cliente novo (um texto: chat). Montar o relatório mensal de três clientes com as planilhas de cada pasta (vários arquivos e repete: terminal, com a receita no harness). Revisar as legendas da semana de um cliente (um texto por vez: chat). Conferir se todos os relatórios enviados no trimestre batem com as faturas (vários arquivos e conferir: terminal).
Resultado da semana: duas tarefas ficaram no chat, onde já estavam bem. Duas foram para o terminal, e eram justamente as que consumiam a tarde de sexta. Nada foi para o editor, porque Denise não programa. A regra não tira o chat de ninguém: ela devolve ao terminal o que nunca deveria ter sido copiado e colado.
Quando a regra vira hábito, o padrão é sempre o mesmo: o chat continua no dia a dia, o terminal absorve as tarefas pesadas, e o harness cresce uma linha por semana com o que você descobriu que quer sempre igual. Em um mês, a folha de instruções fixas já tem a cara da sua operação.
Na sua profissão
Pratique agora 0/4 feito
Em cerca de 10 minutos, liste cinco tarefas reais da sua próxima semana, passe cada uma pela regra de quatro linhas e marque pelo menos uma como candidata ao terminal. Você sai com o seu primeiro plano de camadas.
É uma lista em papel ou no celular. Nada é aberto nem configurado. Se nenhuma tarefa cair no terminal, releia a linha 3 da regra: quase toda semana tem ao menos uma tarefa de vários arquivos escondida numa "tarde de organização".
Você acabou de decidir, com critério, onde cada hora da sua semana deve ser gasta. A tarefa circulada é o seu primeiro trabalho para o terminal.
Resumo