Tarefas do Menu Iniciar

As tarefas do Menu Iniciar são a entrada de atalho do MBAgent, permitindo-lhe guardar tarefas frequentes como botões para que possa clicar para executar na próxima vez sem voltar a descrever.

---

1. O Que É uma Tarefa do Menu Iniciar?

Tarefa do Menu Iniciar = um modelo de prompt guardado + config opcional de ambiente de execução.

Cena	Adequada para Tarefa do Menu Iniciar?
"Ajude-me a escrever um e-mail de outreach em inglês"	✅ Alta frequência → guardar como tarefa
"Consultar as encomendas de hoje da loja Mbbrowser 223223"	✅ Ambiente fixo → guardar como tarefa
"Organizar ficheiros em D:\Downloads"	✅ Operação repetitiva → guardar como tarefa
"Ajude-me a escrever um poema"	❌ Tarefa única

---

2. Abrir o Menu Iniciar

Há uma entrada "Menu Iniciar" à esquerda ou no topo da UI principal do MBAgent. Clique para exibir:

🔍[Pesquisa]

📂 Contas e Navegador

• Patrulhar todas as contas
• Iniciar ambiente especificado

📂 Recolha de Dados

• Resumo de encomendas de hoje
• Recolha de preços de produtos

📂 Processamento de Documentos

• Converter Excel para Markdown
• Extração de texto de PDF

📂 Scripts de Automação

• Executar script de verificação da manhã
• Gerar relatório diário

---

3. Executar uma Tarefa do Menu Iniciar

Passo 1: Encontrar a Tarefa

• Navegue na lista do menu iniciar
• Ou insira uma palavra-chave na caixa de pesquisa (ex. "encomenda", "relatório")

Passo 2: Clicar na Tarefa

Clique no botão da tarefa, o MBAgent irá automaticamente:

1. Carregar a descrição da tarefa
2. Preencher na caixa de entrada (pode modificar)
3. Configurar o ambiente de execução (ambiente Mbbrowser, modelo, etc.)
4. Aguardar que clique em Enviar

Passo 3: Confirmar e Enviar

1. Verifique o conteúdo da caixa de entrada (modifique se necessário)
2. Clique no botão "Enviar"
3. O AI começa a executar a tarefa

TIP

Execução rápida: Clique duas vezes no botão da tarefa para saltar o Passo 2 (não exibido na caixa de entrada) e iniciar a execução diretamente.

---

4. Categorias de Tarefas Incorporadas

O MBAgent vem com múltiplas tarefas oficiais, categorizadas por cenário de negócio:

1. Contas e Navegador

• Patrulhar todas as contas: Verificar o estado de login de cada conta, cookies, impressão digital
• Iniciar ambiente especificado: Iniciar ambiente Mbbrowser por ID de ambiente
• Exportar pacote de ambiente: Empacotar ambiente Mbbrowser para backup

2. Recolha de Dados

• Resumo de encomendas de hoje: Recolher encomendas de hoje de todas as lojas
• Recolha de preços de produtos: Extrair preços de produtos de sites especificados
• Agregação de info de clientes: Agregar info de clientes de múltiplas fontes de dados

3. Processamento de Documentos

• Excel para Markdown: Converter tabelas Excel para formato markdown
• Extração de texto de PDF: Extrair conteúdo de texto de PDF
• Mudança de nome em lote: Mudar nome de ficheiros em lote por regras

4. Scripts de Automação

• Executar script de verificação da manhã: Script de verificação auto-executado todas as manhãs
• Gerar relatório diário: Auto-gerar relatório diário com base em dados
• Publicação em lote: Publicar conteúdo em múltiplas plataformas

5. Manutenção do Sistema

• Verificar versão Mbbrowser: Detetar se Mbbrowser é a mais recente
• Limpar ficheiros temporários: Limpar ficheiros temporários do workspace
• Backup de dados importantes: Auto-backup do banco de memória AI e KMS

---

5. Criar uma Tarefa Personalizada

Passo 1: Clicar no Botão "+"

Clique no botão "+" no topo do menu iniciar; a janela "Nova Tarefa" aparece.

Passo 2: Preencher Informações da Tarefa

Campo	Descrição	Exemplo
Nome da tarefa	Conciso e claro	"Resumo de encomendas de hoje"
Categoria da tarefa	Selecionar ou criar nova	Recolha de dados / Geração de relatório
Descrição da tarefa	Prompt recebido pelo AI	"Agregar a contagem de encomendas de hoje de todas as lojas, ordenar por valor descendente, escrever em reports/orders-YYYYMMDD.xlsx"
Ícone	Escolha um emoji ou codicon	📊
Ambiente de execução	Opcional	ID do ambiente Mbbrowser / Concorrência / Timeout

Passo 3: Usar Variáveis (Opcional)

A descrição da tarefa pode usar placeholders ; os utilizadores serão solicitados a preenchê-los antes de executar:

Por favor organize as encomendas de {{Nome do Cliente}} em {{Data da Encomenda}} numa tabela

Ao executar:

[Entrada] Nome do Cliente = Loja Flagship Mbbrowser
[Entrada] Data da Encomenda = 2026-09-24

Passo 4: Guardar

Clique no botão "Guardar"; a tarefa aparece no menu iniciar.

---

6. Editar / Eliminar / Copiar Tarefas

Editar

1. Clique com o botão direito na tarefa → "Editar"
2. Modifique o nome, descrição, variáveis, etc.
3. Guarde

Eliminar

1. Clique com o botão direito na tarefa → "Eliminar"
2. Confirme (irrecuperável)

Copiar

1. Clique com o botão direito na tarefa → "Copiar"
2. Auto-cria uma nova tarefa (nome com sufixo "Cópia")

Mover para Outra Categoria

1. Clique com o botão direito na tarefa → "Mover para..."
2. Selecione a categoria alvo

---

7. Categorias Personalizadas

Criar Nova Categoria

1. Clique no botão "+" do menu iniciar → "Nova Categoria"
2. Insira o nome da categoria (ex. "Meu Workflow")
3. Escolha o ícone
4. Guarde

Renomear Categoria

1. Clique com o botão direito no título da categoria → "Renomear"

Eliminar Categoria

1. Clique com o botão direito no título da categoria → "Eliminar Categoria"
2. As tarefas dentro da categoria mover-se-ão para "Sem categoria"

---

8. Mecanismo de Sincronização do Menu Iniciar

Atualizações de Tarefas Oficiais

O Mbbrowser oficial mantém um XML oficial do menu iniciar; ao publicar uma nova versão, faz push para todos os clientes MBAgent:

mbAgent official.xml local
  → POST /api/mbagent/start_menu_manifest
  → Devolve version + árvore de diretórios + content_hash de cada tarefa
  → SHA-256 local reutiliza prompts não alterados
  → POST /api/mbagent/start_menu_contents
  → Verificar SHA-256 de cada prompt
  → Reconstruir official.xml completo
  → Substituir atomicamente a cache local

Design chave:

• ✅ Cliente apenas descarrega as partes alteradas, não o pacote inteiro
• ✅ Verificar SHA-256 para garantir que os prompts não foram adulterados
• ✅ Em caso de falha, manter o XML local antigo sem partir a experiência

Sincronização de Tarefas Personalizadas

Tarefas personalizadas só existem localmente, não são auto-sincronizadas para a nuvem.

Se precisar de partilha entre dispositivos:

1. Exporte manualmente a lista de tarefas (JSON)
2. Importe noutra máquina

---

9. Atalhos

Atalho	Função
Ctrl + Shift + M	Abrir menu iniciar
↑ / ↓	Mover para cima/baixo na lista de tarefas
Enter	Executar tarefa atualmente selecionada
Esc	Fechar menu iniciar

---

10. Melhores Práticas

Dicas para Nomear Tarefas

✅ Bom nome:

• "Resumo de encomendas de hoje"
• "Patrulha de loja Amazon"
• "Excel para Markdown"

❌ Mau nome:

• "Tarefa 1"
• "Nova tarefa"
• "teste"

Escrita da Descrição da Tarefa

✅ Boa descrição:

Agregar a contagem de encomendas de hoje de todas as lojas (incluindo ID de encomenda, valor, cliente, estado),
ordenar por valor descendente, escrever em reports/orders-{data de hoje}.xlsx.
Se algum valor de encomenda > 1000, marcar "Encomenda grande" na coluna de notas.

❌ Má descrição:

Agregar encomendas

Quando Criar uma Tarefa

• ✅ Coisas feitas semanal/diariamente de forma repetida
• ✅ Coisas partilhadas pela equipa
• ✅ Coisas complexas e fáceis de esquecer parâmetros

❌ Tarefas únicas não precisam de ser guardadas

Gestão de Versão de Tarefas

Recomenda-se adicionar um número de versão à descrição da tarefa:

[Versão 1.2 - 2026-09-24]
Agregar as encomendas de hoje de todas as lojas...

Mais fácil para manutenção futura.

---

11. FAQ

Q1: Tarefas incorporadas desapareceram / ficaram confusas

Solução: Em "Definições → Menu Iniciar", clique em "Restaurar Menu Oficial".

Q2: Posso partilhar as minhas tarefas personalizadas com colegas?

Sim:

1. Clique com o botão direito na tarefa → "Exportar" → guardar JSON
2. Envie para o colega
3. Colega clica com o botão direito → "Importar" → seleciona JSON

Q3: Erros de tarefa em tempo de execução, o que fazer?

1. Ver info de erro
2. Verifique se a descrição da tarefa é clara
3. Verifique config do ambiente de execução (o ambiente Mbbrowser está online?)
4. Re-edite a tarefa se necessário

Q4: Existe um limite superior no número de tarefas do menu iniciar?

Teoricamente sem limite superior, mas recomenda-se manter < 50, caso contrário difícil de encontrar.

---

Próximo: Tarefas Agendadas e Ciclos → Deixe o AI trabalhar automaticamente no horário.