O que é uma automação, e por que ela roda no seu navegador

“Faz um relatório semanal de gastos por categoria” é um pedido de programa. Não um grande — uma consulta, um agrupamento, um gráfico — mas um programa que deveria rodar de novo na semana que vem sem que ninguém o reescreva. Isso é uma automação.

A forma

Uma automação é um programa curto feito de passos. Cada passo pode consultar suas tabelas, fazer as contas e exibir um número de destaque, um parágrafo, uma tabela ou um gráfico. O assistente escreve a partir da sua descrição, depois de conferir os nomes reais de tabelas e colunas, e valida — que faz parse, que está bem formado, que todo nome usado está definido — antes de permitir salvar. Uma automação quebrada nunca chega.

Por que o navegador

O design óbvio é um servidor que roda automações. Não construímos isso, por três motivos.

Isolamento. Código que roda sobre seus dados deveria rodar onde você está. A automação executa em um sandbox dentro da sua aba. Ela lê tabelas pela sua própria sessão autenticada, com as suas permissões, e nada mais. Não existe executor compartilhado de onde escapar.

Custo. Rodar todo relatório de todo usuário nos nossos servidores seria a maior linha da conta, e você pagaria por isso. Seu computador já está ligado.

Latência. Um relatório sobre alguns milhares de linhas roda em bem menos de um segundo localmente. Não há fila.

O que custa para você

A primeira execução inicia o sandbox — alguns segundos e alguns megabytes, em cache depois. Tabelas muito grandes são agregadas pelo motor de consulta antes de chegar ao navegador; a automação vê o resultado, não as linhas brutas. E uma automação não consegue rodar com o navegador fechado, por isso os relatórios agendados — “me manda isso toda segunda” — são a próxima coisa que estamos construindo: a mesma automação executada no mesmo tipo de sandbox em um servidor, com um token por execução que só consegue ler um projeto.

Incorporando

Uma automação é referenciada por um wikilink, [[automation:…]], então pode viver dentro de uma nota. Abra a nota e você vê a última execução; abra a automação e ela roda de novo. Rodar de novo ao abrir é o próximo passo. É todo o recurso de painel: notas com partes vivas dentro.