A Letaido / docs
DOCUMENTATION

Automações

Como as execuções do Letaido funcionam para você em um cronograma. Dois tipos: uma executa um pequeno programa que o agente criou para você; a outra acorda o agente e permite que ele faça o trabalho sozinho.

Você descreve o que quer fazer e quando. O agente escreve a automação, escolhe um cronograma, pede aprovação uma vez e a executa a partir de então. A saída de cada execução (stdout, stderr, código de saída) é armazenada para que você possa revisá-la mais tarde.

Dois tipos de automações

1. Automação com script

O agente escreve um pequeno programa uma vez e depois o executa para você em um cronograma. Rápido, barato e previsível: as etapas não mudam entre as execuções. Use quando a tarefa for mecânica e o resultado tiver a mesma aparência toda semana.

Exemplos de pedidos:

  • "Toda segunda-feira às 9h, extraia os deltas de palavras-chave da semana passada e me envie uma mensagem direta no Slack."
  • "No primeiro dia de cada mês, arquive os dados do mês passado no arquivo de relatórios."
  • "A cada hora, atualize o cache do Brand Radar para que o painel de controle carregue instantaneamente."

2. Automação de agentes

Em vez de executar um programa salvo, a programação acorda o agente com uma instrução escrita (o prompt). O agente a lê do zero a cada vez, observa o que está na sua área de trabalho no momento e decide como agir, da mesma forma que faria em um chat com você.

Use quando o trabalho exigir julgamento, quando a situação mudar entre execuções ou quando você quiser que o agente faça uma pequena melhoria a cada ciclo e essas melhorias se acumulem ao longo do tempo.

Exemplos de pedidos:

  • "Todos os dias às 9h UTC, veja o que mudou na área de trabalho e atualize o wiki da equipe." (Esta é a automação de sincronização do Wiki na lista acima, abordada na próxima seção.)
  • "Toda sexta-feira à tarde, veja os dados dos concorrentes da semana e me diga o que merece minha atenção na segunda-feira."
  • "Toda segunda-feira, veja este rascunho de landing page, encontre a maior melhoria possível e aplique-a." Execute por algumas semanas e a página se reescreve sozinha: veja o que acontece após vários ciclos.

Observação: as automações de Agent custam mais do que as com script (uma chamada de LLM a cada execução em vez de Python simples), mas elas lidam com trabalhos que um script nunca conseguiria.

Automações gerenciadas (pré-instaladas pela Letaido)

Algumas automações são fornecidas pré-instaladas em cada Área de trabalho e permanecem atualizadas conforme a Letaido as aprimora. A primeira automação gerenciada é Sincronização do Wiki, uma automação de agente de IA que é executada diariamente e mantém a memória de longo prazo da sua Área de trabalho em ~/workspace/wiki/ atualizada, destilando novas sessões de chat, edições de arquivos e uploads.

A pasta wiki/ é uma prova de conceito para a memória de longo prazo da Área de trabalho: um lugar onde o agente registra decisões, entidades nomeadas, convenções e trabalhos recentes para que conversas futuras possam continuar de onde as anteriores pararam. A sincronização do wiki é o que o mantém atualizado sem que você precise se lembrar de atualizá-lo.

As automações gerenciadas são marcadas como pré-instaladas na aba Automações e são somente leitura por padrão. Se você quiser personalizar uma, clique em Personalizar para criar uma cópia editável. Sua cópia permanece na sua Área de trabalho; a original continua sendo executada com as atualizações da Letaido.

Triggers (em breve)

Hoje, todas as automações são acionadas por cron. A próxima onda adicionará acionadores orientados por eventos para que uma automação possa ser disparada quando algo acontecer em um aplicativo conectado: uma nova PR do GitHub aberta, um negócio do HubSpot movido para Fechado-Ganho, uma mensagem do Slack postada em um canal específico.

Isso desbloqueia padrões como:

  • "Sempre que um novo PR for aberto em nosso repositório principal, inicie o Claude Code e o Codex para fazer uma revisão de segurança e, em seguida, publique o resumo conjunto em #engineering."
  • "Sempre que alguém postar em #incoming-leads no Slack, pesquise a empresa na Ahrefs e responda com um resumo de contexto de 4 linhas."

Até lá, você já pode agir em eventos de terceiros hoje combinando uma automação com script que pesquisa a fila de webhook com as assinaturas descritas em Webhooks & triggers. Slack, GitHub, HubSpot, Linear, Notion, Webflow e dezenas de outros provedores já entregam eventos nessa fila; o script agendado por cron apenas os coleta e age.

Quando pedir uma automação em vez de uma tarefa única

O formato da solicitação indica qual delas você deseja.

  • Se você disser "toda segunda-feira", "a cada trimestre", "sempre que X acontecer": automação.
  • Se você disser "nesta segunda-feira", "agora mesmo", "para esta URL": execução única de chat.

Por outro lado, uma tarefa única é qualquer coisa que você deseja fazer apenas uma vez agora:

  • "Extraia os dados da semana passada e me dê o resumo."
  • "Verifique esta lista de 100 URLs e me diga quais retornam 404."

Como é a aprovação

Na primeira vez que uma automação é registrada, você vê um cartão de aprovação com:

  • O nome e a descrição de uma linha.
  • O cronograma (expressão cron).
  • O tipo (com script ou agente de IA).
  • O modelo e o limite de contexto (para automações de agente de IA).
  • O corpo do script ou o corpo do prompt.

O proprietário ou administrador clica uma vez. Depois disso, a automação é executada conforme programado. Você pode pausar, retomar, acionar manualmente (Executar agora), personalizar ou excluir na guia Automações.

Cronogramas comuns

Cadência Expressão Cron
A cada 5 minutos */5 * * * *
A cada hora às :00 0 * * * *
Diariamente às 9h UTC 0 9 * * *
Segundas-feiras às 8h UTC 0 8 * * 1
Duas vezes ao dia (9h, 18h) 0 9,18 * * *

Os horários do Cron são UTC neste host. Se você precisar de um fuso horário local, o agente escolherá um horário UTC que corresponda ao seu horário local durante todo o ano ou adicionará uma proteção de zoneinfo no script que só age quando o horário local estiver na janela correta. O horário de verão é irritante; o agente avisa quando isso acontece.

Dependências

Se uma automação precisar de um pacote Python ou de um conector que ainda não foi aprovado, o agente irá:

  1. Verifique se a dependência existe.
  2. Caso contrário, solicite a instalação ou a aprovação do conector por meio do fluxo de aprovação padrão.
  3. Aguarde a aprovação do proprietário/administrador.
  4. Em seguida, registre a automação.

Você pode ver um cartão de aprovação para a dependência e um para a automação. O agente normalmente agrupa solicitações relacionadas para que você clique uma vez para todo o fluxo, em vez de três vezes.

Quais automações estão em execução nesta área de trabalho

Você pode listá-los na aba Automations na sua área de trabalho. O site de documentação que você está lendo é mantido por três deles:

  • Sincronização do wiki (diária, gerenciada pela Letaido): uma automação de Agent A que lê novas sessões de chat, edições de arquivos e uploads, e os destila no wiki da área de trabalho em ~/workspace/wiki/. Esta é a memória de longo prazo na qual as próximas duas automações se baseiam.
  • Sincronização de documentos (a cada 30 min): uma automação com script que lê markdown de ~/workspace/docs/, renderiza para HTML e envia para o site público para que os visitantes vejam a versão mais recente em até meia hora.
  • Sugestões de atualização automática de documentos (segundas-feiras às 10h00, horário da Europa/Bucareste): uma automação de Agent A que lê o wiki, lista o que mudou na área de trabalho na última semana e propõe edições específicas por capítulo para Andrei revisar. Apenas sugestões; sem publicação automática.

Limites

  • Uma execução de automação expira após 1 hora. Trabalhos mais longos devem ser divididos em etapas e gravar o estado intermediário no banco de dados.
  • stdout e stderr são limitados a 50 KB por execução. Qualquer coisa maior deve ir para um arquivo ou linha de banco de dados.
  • Os agendamentos são gerenciados pela plataforma após aprovação. Para alterar um agendamento, o agente registra uma nova automação e remove a antiga; ele não edita o cron silenciosamente.

Nos bastidores. Cada automação é uma linha na tabela de automações da plataforma mais uma entrada no crontab. O executor executa o script (Scripted) ou inicia um novo chat de agente com o prompt salvo (Agent) com stdin/stdout/stderr capturados, define uma variável de ambiente de ID de execução e grava o registro de execução de volta. Se um script importar algo que não esteja instalado em todo o sistema, a execução falha rapidamente com um erro claro no histórico de execuções.

Last updated 2026-07-16