📅 Tarefas agendadas a fundo

Novo aqui? Uma tarefa agendada é uma instrução que você escreve uma vez e o computador executa sozinho num horário fixo — todo dia às 8h, toda sexta às 18h — sem você abrir nem clicar em nada. E ela mora num lugar específico: o app desktop.

Novo aqui? App desktop quer dizer "aplicativo de mesa": o programa com janela, menus e botões que você instala no computador e abre com dois cliques, como o navegador. Ele é o irmão do terminal — aquela tela preta onde você digita comandos em vez de clicar — mas os dois falam com o mesmo agente. O que muda é a vitrine, não o funcionário.

Por que a tarefa agendada precisa do app desktop? Porque alguém tem que ficar de olho no relógio. O terminal só existe enquanto a janela está aberta: você fecha, ele some, e ninguém sobra para lembrar que às 8h tem compromisso. O app desktop fica instalado e ativo em segundo plano, e é ele que dispara o trabalho na hora certa. É a diferença entre um ajudante que vai embora às 18h e um porteiro que dorme no prédio.

Criar uma tarefa é mais simples do que o nome sugere: dentro do app desktop existe um painel de tarefas agendadas. Você abre esse painel, escreve em português o que deve ser feito, escolhe a frequência e o horário, e salva. Pronto — a partir dali ela é responsabilidade da máquina, não da sua memória.

A frequência é o coração da tarefa agendada, e são três opções que cobrem quase tudo o que uma pessoa precisa. A escolha não é técnica: é de ritmo de vida. Pergunte-se com que frequência o assunto muda — e não com que frequência você gostaria de olhar para ele.

Legenda: olhe a densidade de cada linha. A diária enche a semana toda; a semanal aparece uma vez; a mensal, uma vez em muitas semanas. Quanto mais rara a frequência, mais completa a instrução precisa ser — porque ninguém vai lembrar do contexto um mês depois.

Novo aqui? Sessão é uma conversa com o agente, do começo ao fim. Tudo o que foi dito dentro dela, ele lembra; quando a sessão fecha, essa memória vai embora. E aqui está a característica mais importante da tarefa agendada: cada disparo abre uma sessão nova. Nenhuma execução sabe o que a anterior fez.

Pense num funcionário terceirizado excelente que trabalha para você uma hora por dia — mas é uma pessoa diferente a cada dia, e todas elas leem apenas o bilhete que você deixou colado na porta. Se o bilhete diz "faça o de sempre", a pessoa de hoje não faz ideia do que é "o de sempre". A instrução da tarefa agendada é esse bilhete: ela precisa ser autossuficiente, ou seja, se explicar inteira sozinha, sem depender de nada que tenha sido dito antes.

Isso soa como uma limitação chata, e em parte é. Mas repare no outro lado: sessão limpa também significa que um erro de ontem não contamina hoje. Se a execução de terça se confundiu com um arquivo estranho, a de quarta começa do zero, sem carregar essa confusão. É uma amnésia que também protege.

Existe uma saída elegante para quando você realmente precisa de continuidade — e é o assunto inteiro do módulo 6.4. O truque, em uma frase: se a memória não sobrevive na cabeça do agente, ela sobrevive num arquivo. A execução de hoje escreve o que fez num arquivo de status; a de amanhã começa lendo esse arquivo. A memória sai de dentro da sessão e passa a morar no disco, onde ninguém a apaga.

Legenda: siga a seta tracejada ciano de volta — ela nunca passa pela caixa de memória. É por isso que a instrução precisa se explicar sozinha: nada atravessa esse retorno, exceto o que você escreveu.

Esta é a pergunta que todo mundo faz assim que entende o conceito — e é uma boa pergunta. Se a tarefa está marcada para as 8h e às 8h o computador estava desligado, viajando na mala, o que acontece? A resposta é tranquilizadora: nada se perde. A tarefa fica marcada como execução perdida e roda assim que a máquina volta a ligar.

A analogia é a correspondência. Você viajou uma semana; as cartas não deixaram de ser enviadas nem foram devolvidas — ficaram na caixa esperando. Você chega, abre a caixa, e tudo está lá. A diferença é que o conteúdo pode ter envelhecido: um resumo "dos e-mails de hoje" gerado com quatro dias de atraso resume um "hoje" que já passou.

Por isso a recuperação é uma rede de proteção, não um passe livre. Ela salva você do esquecimento eventual — o dia em que a máquina reiniciou sozinha, a manhã em que você saiu antes de ligar o computador. Não substitui um servidor que fica ligado 24 horas, e isso é exatamente a diferença que a Trilha 4 explorou ao falar de sair do seu laptop. Se a rotina é crítica de verdade, ela não deveria depender de você lembrar de ligar nada.

Legenda: os círculos cinza tracejados são execuções que não aconteceram; os rosa, as mesmas execuções depois de recuperadas. O círculo ciano da ponta é o retorno ao ritmo normal. Repare que a fila é executada em sequência, não tudo de uma vez.

Chega de teoria. Abaixo está um pedido completo, pronto para colar no app desktop. Ele foi escrito seguindo tudo o que você viu até aqui: se explica sozinho, não depende de memória anterior, diz onde salvar, e continua correto mesmo se rodar atrasado.

Crie uma tarefa agendada com estas configurações:

FREQUÊNCIA: diária
HORÁRIO: 08:00
NOME: Resumo matinal da caixa de entrada

INSTRUÇÃO (execute exatamente isto a cada disparo):
1. Abra minha caixa de entrada de e-mail em <seu endereco de e-mail>.
2. Olhe apenas as mensagens que chegaram desde a última vez
   que esta rotina rodou. Se não souber quando foi, use as
   últimas 24 horas.
3. Escolha as 5 mais importantes. Considere importante:
   - cobrança de resposta com prazo
   - mensagem de <pessoas ou empresas que voce nao pode ignorar>
   - qualquer coisa com "urgente", "prazo" ou "vencimento"
4. Para cada uma, escreva 2 linhas: quem mandou, e o que
   ela quer de mim.
5. Salve o resultado no arquivo
   <caminho da pasta onde voce quer o arquivo>/resumo-matinal.md
   Sobrescreva o arquivo anterior.
6. No fim do arquivo, escreva a data e a hora desta execução.

NÃO faça nada além disso: não responda e-mails, não apague
nada, não marque nada como lido.

Quase todo problema com tarefa agendada cai numa destas categorias. Vale ler antes de criar a sua — cada item aqui custou uma manhã perdida para alguém.