Tarefas Agendadas e Ciclos

As tarefas agendadas e os ciclos permitem que o MBAgent trabalhe automaticamente no horário, sem ter de acionar manualmente cada vez. Este artigo detalha como configurar.

1. O Que É uma Tarefa Agendada?

Tarefa Agendada = uma tarefa MBAgent auto-acionada num horário ou intervalo específico.

Método de Acionamento	Cenário de Utilização
Expressão cron	9h diário, segunda-feira semanal, dia 1 de cada mês, etc.
Intervalo fixo	A cada 30 minutos, a cada 2 horas, a cada 5 segundos
Watcher do workspace	Acionado por alterações de ficheiros
Acionamento manual	Não agendado, mas pré-definido

2. Criar uma Tarefa Agendada

Passo 1: Abrir Gestão de Tarefas Agendadas

Na UI principal do MBAgent, clique no separador "Tarefa" → "Tarefa Agendada", ou insira o slash command:

/schedule list

Exibe todas as tarefas agendadas atuais.

Passo 2: Nova Tarefa

Clique no botão "+"; a nova janela aparece:

Nova Tarefa Agendada

Nome da tarefa:________________

Descrição da tarefa:____________________________

Método de acionamento:○ Cron○ Intervalo fixo○ Watcher

Expressão cron:________________

[Dica: 0 9 * * * significa todos os dias às 9h]

Ambiente Mbbrowser: Auto / Especificar / Tag

Concorrência: 5

Timeout: 300 segundos

Tratamento de falhas:○ Tentar 3 vezes○ Saltar○ Abortar

Passo 3: Preencher Descrição da Tarefa

A descrição da tarefa é o prompt que o AI recebe cada vez que a tarefa agendada é executada. Por exemplo:

Agregar a contagem de encomendas de hoje de todas as lojas, ordenar por valor descendente,
escrever em reports/orders-{YYYYMMDD}.xlsx.
Se houver anomalias (valor de encomenda > 10000 ou < 1),
enviar email para alerts@company.com.

Passo 4: Escolher Método de Acionamento

1. Expressão Cron

A forma mais comum. Sintaxe da expressão cron:

*  *  *  *  *
│  │  │  │  │
│  │  │  │  └── Dia da semana (0-7, 0=Domingo)
│  │  │  └───── Mês (1-12)
│  │  └─────── Dia (1-31)
│  └────────── Hora (0-23)
└───────────── Minuto (0-59)

Exemplos comuns:

Cron	Significado
`0 9 * * *`	Todos os dias 9:00
`0 9 * * 1-5`	Dias úteis 9:00
`0 0 1 * *`	Dia 1 de cada mês 0:00
`/30 * * *`	A cada 30 minutos
`0 /2 * *`	A cada 2 horas
`0 18 * * 5`	Toda sexta-feira 18:00
`0 0 1 1 *`	Todo dia 1 de janeiro 0:00

2. Intervalo Fixo

Defina a frequência de execução:

Campo	Descrição
Valor do intervalo	Número
Unidade do intervalo	Segundo / Minuto / Hora / Dia

Ex.: executar uma vez a cada 30 minutos.

3. Watcher do Workspace (watchWorkspace)

Acionar quando o conteúdo da pasta especificada muda:

Campo	Descrição
Caminho de watch	Qual pasta observar
Tipo de evento	Novo ficheiro / Ficheiro modificado / Ficheiro eliminado
Filtro de ficheiro	Padrão de nome de ficheiro (ex. `*.xlsx`)

Cenários de utilização:

Auto-processar quando chegam novos ficheiros de encomendas
Auto re-analisar quando os ficheiros de dados são atualizados

Passo 5: Configurar Ambiente de Execução

Ambiente Mbbrowser: Se precisa de abrir o navegador Mbbrowser
Concorrência: Paralelismo entre múltiplos ambientes
Timeout: Duração máxima por execução
Tratamento de falhas: Como lidar com falhas

Passo 6: Guardar

Clique em "Guardar"; a tarefa agendada aparece na lista de tarefas com o estado "Não ativada".

Passo 7: Ativar

Selecione a tarefa e clique no botão "Ativar". O MBAgent executará automaticamente conforme planeado.

3. Gerir Tarefas Agendadas

Ver Todas as Tarefas Agendadas

/schedule list

Ativar / Pausar

Ativar: Selecione a tarefa → clique no botão "Ativar"
Pausar: Selecione a tarefa → clique no botão "Pausar" (config preservada mas não executada)

Eliminar Tarefa

Selecione a tarefa
Clique no botão "Eliminar"
Confirme a eliminação

Ver Histórico de Execução

Selecione a tarefa
Clique no separador "Histórico"
Exibe por execução: hora de acionamento / estado / duração / resultado

Execução Imediata (Acionamento Manual)

Selecione a tarefa
Clique no botão "Executar Imediatamente"

4. MBAgent Daemon

Daemon = um processo residente em segundo plano que permite que tarefas agendadas executem conforme planeado mesmo que não tenha iniciado ativamente o MBAgent. O daemon do mbAgent suporta dois hosts em segundo plano:

macOS: launchd (escrever em ~/Library/LaunchAgents/sh.mbagent.scheduler.plist)
Linux: systemd --user (escrever em ~/.config/systemd/user/mbagent-scheduler.service)

Estado de Suporte por Plataforma

Plataforma	Estado	Descrição
macOS	✅ Suportado	Auto `launchctl bootstrap gui/$UID` na instalação
Linux	✅ Suportado	Gerar ficheiro unit; utilizador precisa de correr `systemctl --user enable --now` ele próprio
Windows	⏳ Ainda não suportado	Código marca explicitamente "Windows daemon support is deferred"; deteção PID no módulo schedules devolve `false` diretamente no Windows, sem branch de registo launchd / SCM / Windows Service

Método de Instalação (macOS / Linux)

Vá a "Definições → Tarefas Agendadas"
Clique no botão "Instalar Daemon"
macOS auto launchctl bootstrap; Linux escreve o ficheiro unit em ~/.config/systemd/user/ e dá o comando systemctl --user enable --now

Estado do Daemon

MBAgent Scheduler daemon
  Estado: Em execução
  PID: 12345
  pidfile: ~/.local/share/mbagent/scheduler.pid
  Tarefas carregadas: 12

Desinstalar Daemon

Vá a "Definições → Tarefas Agendadas"
Clique no botão "Desinstalar Daemon"
macOS corre launchctl bootprint gui/$UID sh.mbagent.scheduler; Linux dá o comando systemctl --user disable --now

WARNING

Pause todas as tarefas agendadas antes de desinstalar, caso contrário as tarefas falharão após a desinstalação.

NOTE

Utilizadores Windows: Atualmente, se precisar de execução "não assistida" de tarefas agendadas, ainda precisa de manter o processo principal do MBAgent em execução. Para execução não assistida de longo prazo, pode usar o Windows Task Scheduler para empacotar mbagent schedule tick como uma tarefa agendada auto-executada no arranque (esta é uma solução alternativa, não o mbAgent Daemon).

5. Monitorização por Ciclo (Mais Avançado)

Tarefa de Ciclo = uma versão simplificada de tarefa agendada que executa repetidamente em intervalos fixos.

Diferença da Tarefa Agendada

Dimensão	Tarefa Agendada	Tarefa de Ciclo
Hora de acionamento	Ponto exato no tempo	Intervalo fixo
Complexidade de config	Alta (expressão cron)	Baixa (valor de intervalo)
Cenário adequado	Relatório diário 9h	Verificar inventário a cada 30 min
Tratamento de falhas	Detalhado	Simples

Criar uma Tarefa de Ciclo

Abrir painel de tarefas
Selecionar "Tarefa de Ciclo" ao criar nova tarefa
Definir:
- Intervalo (a cada X segundos/minutos/horas)
- Condição de fim (parar após N execuções / nunca parar)
Guardar e ativar

Tarefas de Ciclo Típicas

A cada 30 minutos verificar inventário da loja, notificar quando abaixo do limiar
A cada hora verificar se o Token da conta Mbbrowser expirou
A cada 5 minutos verificar email para novas encomendas
Monitorizar continuamente uma página web para alterações

6. Objetivo de Longo Prazo

Objetivo de Longo Prazo = deixar o MBAgent iterar autonomamente em torno de um objetivo de longo prazo, até o objetivo estar completo ou terminar manualmente.

Criar um Objetivo de Longo Prazo

Insira slash command na UI principal do MBAgent:

/goal start Otimizar continuamente a taxa de conversão destas 20 lojas, produzir relatório de análise semanal

O MBAgent aceita o objetivo e começa a auto-planeamento:
- Semana 1: Recolher dados de base
- Semana 2: Identificar lojas com baixa conversão
- Semana 3: Formular plano de otimização
- Iteração contínua...

Ver Estado do Objetivo de Longo Prazo

/goal status

Exibe:

Objetivo #1 - Otimizar continuamente taxa de conversão de 20 lojas
  Estado: Em progresso
  Em execução há: 14 dias
  Fase atual: Semana 3 (Formulação do plano de otimização)
  Conclusão: 45%
  Próxima avaliação: 2026-10-01

Parar Objetivo de Longo Prazo

/goal stop

7. Tarefa de Pesquisa

Tarefa de Pesquisa = o MBAgent pesquisa profundamente um tópico e produz um relatório estruturado.

Criar uma Tarefa de Pesquisa

/research start Pesquisar o impacto das novas políticas Amazon 2026 nos pequenos vendedores

Fluxo de Pesquisa

[1] Decompor tópico de pesquisa
    - Subtópico 1: Interpretação completa da nova política
    - Subtópico 2: Impacto nos pequenos vendedores
    - Subtópico 3: Estratégias de应对
    - Subtópico 4: Casos da indústria
    ↓
[2] Recolher materiais em paralelo
    - Chamar base de conhecimento Mbbrowser RAG
    - Chamar WebSearch
    - Chamar WebFetch
    ↓
[3] Analisar e sintetizar
    - Extrair informação chave
    - Verificar factos
    - Resumir pontos de vista
    ↓
[4] Produzir relatório
    - Markdown estruturado
    - Citar fontes
    - Incluir gráficos

Ver Relatório de Pesquisa

Vá à barra lateral "Pesquisa"
Selecione tarefa de pesquisa concluída
Ver relatório

8. Melhores Práticas

Seleção de Horário

✅ Recomendado:

Horas de baixo pico de negócio (madrugada, noite)
Antes da atualização da quota da conta Mbbrowser (fim do mês)
Navegador Mbbrowser ocioso

❌ Evitar:

Horas de pico (horário de trabalho diurno)
Sobreposição de múltiplas tarefas (CPU / memória demasiado alta)
Horários sensíveis cross-timezone (ex. Double 11)

Decomposição de Tarefas

✅ Boa prática:

Dividir grandes tarefas em múltiplas tarefas agendadas pequenas
Cada tarefa foca-se num objetivo
Tarefas não dependem umas das outras

❌ Má prática:

Uma grande tarefa faz demasiado
Fortes dependências entre tarefas (falha de A leva a falha de B)

Tratamento de Erros

✅ Configurar notificações de alerta (enviar email / WeChat em caso de falha)
✅ Definir timeout razoável (não esperar demasiado tempo)
✅ Manter logs em caso de falha (mais fácil resolução de problemas)

Gestão de Recursos

✅ Limitar concorrência (não deixar múltiplas tarefas esgotar CPU)
✅ Monitorizar uso de recursos (monitor de recursos no painel de tarefas)
✅ Tarefas importantes usam Daemon / processo independente (evitar ser afetado por outras tarefas; Windows atualmente não tem Daemon, pode usar instância MBAgent independente para hospedar tarefas importantes)

9. Cenários Típicos

Cenário 1: Relatório de Vendas Diário

Nome da tarefa: Relatório de vendas diário
Acionamento: Cron 0 9 * * * (todos os dias 9h)
Descrição: Agregar dados de encomendas de ontem de todas as lojas, gerar relatório diário, escrever em reports/daily-{YYYYMMDD}.xlsx,
            e enviar o conteúdo do relatório diário para wechat-bot.

Cenário 2: Monitorização de Inventário

Nome da tarefa: Monitorização de inventário
Acionamento: Intervalo fixo 30 minutos
Descrição: Verificar inventário de todas as lojas, registar as abaixo de 10 unidades em alerts/low-stock-{YYYYMMDD}.csv,
            e enviar email para a equipa de operações.
Condição de fim: Correr para sempre

Cenário 3: Patrulha de Saúde de Conta

Nome da tarefa: Patrulha de saúde de conta
Acionamento: Cron 0 */6 * * * (a cada 6 horas)
Descrição: Verificar estado de login, integridade de cookies, anomalias de IP para todas as contas Mbbrowser,
            produzir relatório para health-check/{YYYYMMDD-HH}.json.
Tratamento de falhas: Tentar 3 vezes depois saltar

Cenário 4: Backup Automático de Dados

Nome da tarefa: Backup de dados
Acionamento: Cron 0 3 * * * (todos os dias 3h da madrugada)
Descrição: Fazer backup do banco de memória AI, KMS, todas as sessões para backup/{YYYYMMDD}/.
Condição de fim: Correr para sempre

10. FAQ

Q1: A tarefa agendada não foi acionada como esperado

Resolução:

Verifique se a expressão cron está correta
Verifique se o MBAgent está em execução (Windows atualmente não suporta Daemon, precisa de manter o processo principal em execução; macOS/Linux com Daemon instalado podem acionar não assistido)
Verifique info de erro no histórico de tarefas
Confirme se a hora do sistema está correta

Q2: As tarefas não executam quando o computador hiberna

Soluções:

macOS / Linux: Instale Daemon (deixe launchd / systemd-user acordar tarefas)
Windows: Atualmente Daemon não suportado; use Windows Task Scheduler + workaround mbagent schedule tick (consulte a NOTE no final da secção 4 MBAgent Daemon)
Configure o computador para não hibernar (Painel de Controlo → Energia)
Defina timers de wake

Q3: As tarefas falham continuamente

Resolução:

Execute sozinho uma vez para ver info de erro
Verifique se o navegador Mbbrowser está online
Verifique a ligação de rede
Simplifique a descrição da tarefa, resolva problemas passo a passo

Q4: As tarefas agendadas consomem demasiados Tokens

Soluções:

Use modelo mais barato (gpt-5-mini)
Feche "mostrar processo de pensamento"
Encurte a descrição da tarefa
Reduza a frequência de execução

Q5: As tarefas agendadas podem ser sincronizadas entre múltiplos computadores?

Sincronização na nuvem ainda não suportada. Recomenda-se:

Configure separadamente em cada computador
Ou use um ficheiro de gestão de tarefas unificado + sincronização Git

Próximo: Dicas e Melhores Práticas → Resumo de experiência de utilizadores veteranos.

Tarefas Agendadas e Ciclos ​

1. O Que É uma Tarefa Agendada? ​

2. Criar uma Tarefa Agendada ​

Passo 1: Abrir Gestão de Tarefas Agendadas ​

Passo 2: Nova Tarefa ​

Passo 3: Preencher Descrição da Tarefa ​

Passo 4: Escolher Método de Acionamento ​

1. Expressão Cron ​

2. Intervalo Fixo ​

3. Watcher do Workspace (watchWorkspace) ​

Passo 5: Configurar Ambiente de Execução ​

Passo 6: Guardar ​

Passo 7: Ativar ​

3. Gerir Tarefas Agendadas ​

Ver Todas as Tarefas Agendadas ​

Ativar / Pausar ​

Eliminar Tarefa ​

Ver Histórico de Execução ​

Execução Imediata (Acionamento Manual) ​

4. MBAgent Daemon ​

Estado de Suporte por Plataforma ​

Método de Instalação (macOS / Linux) ​

Estado do Daemon ​

Desinstalar Daemon ​

5. Monitorização por Ciclo (Mais Avançado) ​

Diferença da Tarefa Agendada ​

Criar uma Tarefa de Ciclo ​

Tarefas de Ciclo Típicas ​

6. Objetivo de Longo Prazo ​

Criar um Objetivo de Longo Prazo ​

Ver Estado do Objetivo de Longo Prazo ​

Parar Objetivo de Longo Prazo ​

7. Tarefa de Pesquisa ​

Criar uma Tarefa de Pesquisa ​

Fluxo de Pesquisa ​

Ver Relatório de Pesquisa ​

8. Melhores Práticas ​

Seleção de Horário ​

Decomposição de Tarefas ​

Tratamento de Erros ​

Gestão de Recursos ​

9. Cenários Típicos ​

Cenário 1: Relatório de Vendas Diário ​

Cenário 2: Monitorização de Inventário ​

Cenário 3: Patrulha de Saúde de Conta ​

Cenário 4: Backup Automático de Dados ​

10. FAQ ​

Q1: A tarefa agendada não foi acionada como esperado ​

Q2: As tarefas não executam quando o computador hiberna ​

Q3: As tarefas falham continuamente ​

Q4: As tarefas agendadas consomem demasiados Tokens ​

Q5: As tarefas agendadas podem ser sincronizadas entre múltiplos computadores? ​