osFoundry / Platform
Tarefas cron do app
Agende tarefas recorrentes por app. Sintaxe cron, retries, execuções observáveis.
O que é
Os cron jobs de apps permitem agendar trabalho recorrente para um app específico dentro do osFoundry. Em vez de deixar um script rodando ou lembrar de disparar algo na mão, você anexa um agendamento ao próprio app e deixa que ele rode na cadência que você definir. Cada job é definido com sintaxe cron padrão, então uma expressão como `0 * * * *` roda de hora em hora e `30 6 * * 1-5` roda às 6:30 nos dias úteis. Como o agendamento pertence ao app, tudo de que o job precisa (sua lógica, seu ambiente, suas chaves) viaja junto com o app em vez de morar num agendador separado e desconectado.
Por baixo dos panos, cada execução agendada é tratada como uma unidade observável. Quando uma execução falha, o job tenta de novo em vez de descartar o trabalho em silêncio, e cada tentativa fica registrada para que você veja o que rodou, quando rodou, se teve sucesso e o que produziu. Esse histórico de execuções é a diferença entre uma linha de cron que você torce para estar disparando e um agendamento que você consegue de fato verificar. O osFoundry é um espaço de trabalho de desktop com sua própria chave (BYOK), então esses jobs rodam contra os modelos e serviços que você conecta com suas próprias chaves de API: não há margem de revenda sobre o que um job recorrente custa e, por ser local-first, o app e seu agendamento podem viver no seu próprio dispositivo em vez de nos servidores de um fornecedor.
Isso importa mais para o trabalho silencioso e repetitivo que os apps acumulam: puxar dados numa cadência, regerar uma saída, rodar uma verificação, disparar uma tarefa de agente por um temporizador. O cron dá controle preciso sobre o quando, as novas tentativas tornam o agendamento resiliente a uma falha passageira e o log de execuções torna tudo auditável. Ele fica ao lado do resto do osFoundry (chat e agentes, apps, código, conhecimento e dados), de modo que um job de app agendado pode alimentar o mesmo espaço em que você já trabalha em vez de um silo de automação à parte.
Principais recursos
- Defina agendamentos com sintaxe cron padrão, de um simples tique de hora em hora a expressões só em dias úteis ou de virada de mês
- Anexe o agendamento a um app específico para que sua lógica, seu ambiente e suas chaves rodem juntos como uma única unidade
- Novas tentativas automáticas numa execução com falha em vez de descartar o trabalho agendado em silêncio
- Histórico de execuções observável: veja o horário, o status e a saída de cada execução para confirmar que o agendamento realmente disparou
- BYOK e local-first: os jobs rodam contra seus próprios modelos e chaves conectados, sem taxa por usuário nem margem de revenda
Casos de uso
- Engenheiro de dados: agende um app para puxar e atualizar um dataset a cada hora com cron e confira o log para confirmar que cada sincronização foi concluída
- Líder de operações: rode um job de app de manhã nos dias úteis que regera um relatório e tenta de novo sozinho se a fonte estiver brevemente indisponível
- Desenvolvedor solo: coloque uma tarefa de agente recorrente num cron noturno para que o trabalho rotineiro rode sem supervisão na sua própria máquina e com suas próprias chaves de API
Perguntas frequentes
Qual sintaxe cron o osFoundry usa?
Expressões cron padrão: cinco campos para minuto, hora, dia do mês, mês e dia da semana. Assim, `0 * * * *` roda no início de cada hora e `30 6 * * 1-5` roda às 6:30 nos dias úteis. O agendamento é definido por app.
O que acontece se uma execução agendada falhar?
O job tenta de novo em vez de descartar o trabalho em silêncio, e cada tentativa fica registrada no histórico de execuções do app para que você veja quais execuções tiveram sucesso, quais falharam e o que cada uma produziu.
Onde os jobs rodam e quanto custam?
O osFoundry é um espaço de trabalho de desktop local-first e BYOK, então um job de app agendado roda contra os modelos e serviços que você conecta com suas próprias chaves de API. Não há margem de revenda sobre esse uso nem taxa por usuário para agendar.