📌 A tarefa pendurada
Até aqui você fez seu agente de código responder a pedidos: você abre o terminal (a caixa de texto que dá ordens direto ao computador), digita o que quer, ele executa, você vê o resultado. Isso funciona muito bem — mas tem uma condição escondida: você precisa estar lá. Computador ligado, aplicativo aberto, você presente pra apertar Enter.
Pense numa tarefa "pendurada": é aquele lembrete que fica esperando alguém chegar pra executar. Você escreveu um post-it "ligar pro fornecedor às 9h" e colou na tela — mas o post-it não liga sozinho. Ele só existe até você chegar, ver, e agir. Uma automação que só roda no seu terminal é exatamente isso: um post-it sofisticado. Sofisticado porque, quando você chega e aperta o botão, ela faz o trabalho inteiro sozinha. Mas ainda depende de alguém chegar.
Isso muda tudo na prática: se a automação deveria rodar todo dia às 7h da manhã, mas seu laptop estava desligado (ou fechado, ou sem internet, ou você estava de férias), ela simplesmente não rodou. Ninguém avisa. Não existe um "ela tentou e falhou" — existe um silêncio total, porque nada foi disparado.
💡 Conceito Principal
"Rodar local" quer dizer: o código só executa enquanto o seu computador está ligado e o programa está aberto — a execução depende fisicamente da sua máquina. Isso é ótimo pra testar e aprender (é o que você fez nas trilhas 1, 2 e 3), mas é frágil demais pra confiar o trabalho de verdade.
- •Local = depende de você estar presente e do seu computador estar ligado.
- •Automação de verdade = roda sozinha, no horário certo, mesmo que você esteja dormindo, viajando ou com o notebook na mochila.
🌙 O funcionário que trabalha mesmo você dormindo
Agora troque a imagem do post-it pela de um funcionário de verdade. Um funcionário presencial só trabalha quando está no escritório, junto com você — se você fecha o escritório, ele para. Um funcionário remoto, contratado e instalado em outro lugar, continua trabalhando mesmo que o SEU prédio esteja fechado. Ele tem o próprio espaço, as próprias chaves, e cumpre o horário combinado independente de onde você esteja.
Novo aqui? Nuvem (cloud) é o nome comum pra "computador de outra empresa que você aluga pela internet, ligado 24 horas por dia, em um data center, que nunca desliga porque você fechou o notebook". Quando dizemos que uma automação "roda na nuvem", queremos dizer que o código dela está executando numa dessas máquinas remotas — não na sua.
✗ Rodando local (seu terminal)
- ✗Só executa se o computador estiver ligado e você presente
- ✗Fechou o notebook, viajou sem internet: a automação simplesmente não roda
- ✗Nenhum aviso de que ela "deveria" ter rodado e não rodou
✓ Rodando 24/7 na nuvem
- ✓Executa no horário marcado, com você dormindo, offline ou em outro país
- ✓O computador que executa não é o seu — é um servidor remoto contratado pra isso
- ✓Gera log (mais no tópico 3) mostrando o que aconteceu, mesmo sem você olhar na hora
⚠️ Atenção
"Rodar na nuvem" não é mágica nem é caro por padrão — é simplesmente publicar o mesmo código que você já testou localmente num lugar que fica sempre ligado. O Módulo 4.2 mostra exatamente o caminho técnico disso, passo a passo.
🔍 Por dentro: o que muda tecnicamente
Novo aqui? Código é o conjunto de instruções escritas que dizem ao computador exatamente o que fazer, passo a passo — é o que o seu agente escreve quando você pede pra automatizar algo. Quando esse código roda local, ele fica só na memória do seu computador, do jeito que um bilhete só existe na sua mesa. Pra ele existir "em outro lugar" e ficar sempre disponível, ele precisa ser levado pra lá.
Legenda: o mesmo código, dois destinos diferentes. Do lado esquerdo ele depende do seu laptop ligado; do lado direito ele mora num servidor que nunca desliga e registra tudo o que faz.
🔍 Por dentro
- Repositório: uma pasta especial (geralmente no GitHub) onde o código fica guardado com histórico de todas as mudanças — é de lá que a nuvem "puxa" o código pra rodar. Aprofundado no módulo 4.2.
- Ambiente de produção: o nome técnico pro lugar (servidor na nuvem) onde a versão "de verdade" da automação roda, atendendo você ou outras pessoas de fato — diferente do seu terminal, que é o ambiente de teste (aprofundado no módulo 4.3).
- Log: a lista de eventos que a automação foi registrando enquanto rodava — é como você "vê" o que aconteceu quando não estava presente para assistir ao vivo.
🚀 O caminho de código até nuvem, em ordem
Sair do local pra nuvem não é um passo só — é uma sequência de estações, cada uma entregando o trabalho pra próxima. O Módulo 4.2 detalha cada estação a fundo; aqui você já vê o caminho inteiro, pra entender por que ele existe.
O agente escreve o código
Você não precisa escrever isso à mão. Você descreve o que quer, o agente escreve em TypeScript (a linguagem de programação usada nesta trilha — só uma forma padronizada de escrever instruções pro computador), e você lê e aprova antes de seguir.
O código vai pro repositório
Usando git (a ferramenta que guarda o histórico de versões do seu código, como um "salvar" com memória de tudo que já mudou), o código é enviado pra uma cópia guardada no GitHub — o repositório.
A plataforma de execução puxa e roda
Um serviço na nuvem (usaremos o Trigger.dev nesta trilha) busca esse código do repositório e o mantém rodando 24 horas por dia — isso chama-se deploy: publicar o código num lugar onde ele executa sozinho.
Você acompanha pelo painel
Sem precisar saber ler TypeScript: você olha o log de execuções pra saber se rodou, quando rodou e se deu certo. Isso é o foco do módulo 4.7.
💡 Conceito Principal
Chamamos essa sequência de pipeline — uma linha de montagem onde cada estação faz uma parte do trabalho e entrega pra próxima. Você participa das pontas (pedir e aprovar o código, ler o painel) — o meio do caminho é automático.
🖥️ Sentindo a diferença na prática: rodar local uma vez
Antes de qualquer coisa ir pra nuvem, vale sentir na pele o que "rodar local" significa: você dispara o comando, o processo executa enquanto o terminal (a janela de comandos) está aberto, e some quando você fecha. Nenhuma mágica — é exatamente isso que os módulos 4.2 a 4.6 vão substituir por algo que continua rodando sem você.
Objetivo: rodar um script (um arquivo de instruções simples) local no seu terminal e observar que ele só existe enquanto você o mantém aberto.
cd minha-automacao
node verificar-estoque.js
# saída esperada no terminal:
# [12:04:02] Verificando estoque...
# [12:04:03] 3 produtos abaixo do mínimo. E-mail simulado enviado.
# [12:04:03] Processo encerrado.
Como verificar: feche o terminal (ou desligue o wi-fi, ou
desligue o notebook) e espere o horário em que essa automação "deveria" rodar de novo amanhã de manhã.
Ela não vai rodar — porque não existe nada além do seu comando manual mantendo-a viva. É essa lacuna
exata que uma variável de ambiente (uma "chave secreta" configurada num servidor, como
SUA_CHAVE_AQUI, coberta em detalhe
no módulo 4.4) e uma plataforma como o Trigger.dev vêm resolver: o mesmo código passa a rodar
sozinho, num servidor que nunca fecha o terminal.
✗ O que você acabou de fazer (local)
- ✗Rodou uma única vez, na hora, porque você mandou
- ✗Se fechar o terminal, o processo morre junto
✓ O que o módulo 4.6 vai construir
- ✓O mesmo script publicado, rodando sozinho todo dia no horário marcado
- ✓Continua rodando mesmo com seu terminal fechado há semanas
🗺️ Consolidando o modelo mental
A Trilha 4 inteira existe pra atravessar essa ponte: código no seu computador → repositório → plataforma de execução na nuvem. Você não vai virar programador — o agente escreve o TypeScript, você lê, aprova e acompanha pelo painel. Mas você precisa entender essa ponte pra confiar no resultado e saber onde olhar quando algo falhar.
📊 Antes de seguir, isso deve estar claro
- Local: depende do seu computador ligado — bom para testar, ruim para confiar.
- Nuvem: um servidor remoto que nunca desliga por sua causa — roda sozinho.
- Pipeline: código → repositório (git) → plataforma de execução → painel de logs.
- Você: pede, lê, aprova e acompanha — não precisa escrever ou ler TypeScript linha a linha.
🎯 Conceito Principal
- •Automação de verdade é medida pela ausência de você — se ela precisa que você esteja lá, ainda é uma tarefa manual disfarçada.
- •Sair do local não é "avançado demais" — é uma sequência de passos pequenos, cada um coberto num módulo desta trilha.
Checagem rápida (opcional): o que realmente separa "rodar local" de "automação de verdade"?