MBAgent FAQ
Este artigo agrega problemas comuns de uso do MBAgent e soluções. Se o seu problema não estiver neste artigo, por favor contacte o suporte ao cliente Mbbrowser.
1. Instalação e Arranque
Q1.1: Clicar duas vezes no ícone do MBAgent não faz nada
Possíveis causas:
- Mbbrowser não iniciado
- Conta Mbbrowser sem sessão iniciada
- Permissões insuficientes do diretório de trabalho
Solução:
- Iniciar Mbbrowser e iniciar sessão
- Verificar se o diretório de trabalho do MBAgent existe
- Iniciar MBAgent com privilégios de administrador
Q1.2: "Selecionar Diretório de Trabalho" permanece após o arranque
Causa: O programa principal Mbbrowser não está iniciado; o MBAgent não consegue ler as informações da conta Mbbrowser.
Solução:
- Fechar MBAgent
- Iniciar Mbbrowser e iniciar sessão
- Reiniciar MBAgent
Q1.3: Chinês aparece ilegível após o arranque
Solução:
- Definições do Windows → Hora e Idioma → Idioma → Idioma de exibição do Windows → Chinês Simplificado (China)
- Reiniciar o computador
Q1.4: Instalador diz "Já está instalada uma versão mais recente"
Solução:
- Painel de Controlo → Programas e Funcionalidades → Desinstalar Mbbrowser antigo
- Eliminar
C:\Program Files\Mbbrowser - Reinstalar a versão nova
2. Ligação ao Mbbrowser
Q2.1: MBAgent mostra "À espera do Mbbrowser CDP"
Possíveis causas:
- Mbbrowser não iniciado
- Porta ControlV2 ocupada
- Bloqueio por firewall
Solução:
- Iniciar Mbbrowser
- Verificar Mbbrowser → Definições → se ControlV2 está ativado
- Fechar firewall / antivírus
Q2.2: AI não consegue operar o Mbbrowser
Passos de resolução:
- Vá a "Definições → Deteção de Serviço Oficial"
- Clique em "Iniciar Deteção" sob "Mbbrowser Client ControlV2"
- Ver o passo específico que falhou
Q2.3: Operações AI no Mbbrowser falham sempre
Possíveis causas:
- Quota da conta Mbbrowser esgotada
- Ambiente Mbbrowser corrompido
- Problema de rede
Solução:
- Verificar a quota AI da conta Mbbrowser
- Testar manualmente o ambiente dentro do Mbbrowser
- Contactar o suporte ao cliente Mbbrowser
Q2.4: Pode ser controlado um Mbbrowser remoto?
❌ Não. Para mais informações, consulte Integração Mbbrowser ControlV2.
3. Modelos e Provider
Q3.1: Lista de modelos vazia
Causa: A conta Mbbrowser não ativou a quota de modelo de IA.
Solução:
- Visitar a consola Mbbrowser
- Ir a "Modelos de IA" → ativar quota
- Voltar ao MBAgent → atualizar lista de modelos
Q3.2: Lista não muda depois de trocar Provider
Resolução:
- Verificar se esse Provider tem API Key configurada
- Testar se a ligação foi bem-sucedida
- Reiniciar MBAgent
Q3.3: Provider personalizado não consegue ligar
Resolução:
- Verificar se API Key e Base URL estão corretos
- Testar conectividade de rede (ping / curl)
- Verificar logs do MBAgent (
%LOCALAPPDATA%\mbagent\logs\)
Q3.4: Modelo responde muito lentamente
Possíveis causas:
- Problema de rede
- Modelo sobrecarregado
- Contexto demasiado longo
Solução:
- Mudar para um modelo mais rápido
- Comprimir histórico da sessão (
/compact) - Verificar rede
4. Tarefas e Agendamento
Q4.1: Tarefa agendada não foi acionada como esperado
Resolução:
- Verificar expressão cron
- Verificar se o MBAgent está em execução (Daemon não instalado)
- Ver histórico de tarefas
- Confirmar hora do sistema
Q4.2: As tarefas não executam quando o computador hiberna
Solução:
- Instalar MBAgent Daemon
- Configurar computador para não hibernar
- Configurar timers de wake
Q4.3: As tarefas falham continuamente
Resolução:
- Executar tarefa sozinha para ver erro
- Verificar estado online do navegador Mbbrowser
- Simplificar descrição da tarefa, resolver problemas passo a passo
- Contactar suporte ao cliente Mbbrowser
Q4.4: Tarefa agendada consome demasiados Tokens
Solução:
- Usar modelo barato
- Fechar "mostrar processo de pensamento"
- Reduzir frequência de execução
- Otimizar prompt
5. Ficheiros e Anexos
Q5.1: Upload de ficheiro grande falhou
Limite:
- Ficheiro único recomendado < 50 MB
- Para ficheiros muito grandes (>100 MB), usar ferramenta AI para ler caminho
Solução:
- Comprimir ficheiro (zip)
- Usar ferramenta Read para deixar AI lê-lo ele próprio
- Carregar em pedaços
Q5.2: AI não consegue ver a imagem
Possíveis causas:
- Modelo atual não suporta multimodal
- Imagem demasiado grande
- Formato de imagem não suportado
Solução:
- Mudar para um modelo com capacidade multimodal (gpt-5, claude-sonnet-4)
- Comprimir a imagem
- Converter para JPG / PNG
Q5.3: Ficheiros modificados pelo AI não foram guardados
Resolução:
- Clicou acidentalmente em "Rejeitar"?
- O diretório de trabalho tem permissão de escrita?
- Verificar se o banco de memória AI registou caminhos errados
6. Permissões e Segurança
Q6.1: Como revogar a operação incorreta do AI?
Passos:
- Premir imediatamente
Escpara parar AI - Ver log de operação
- Revogar manualmente a operação incorreta do AI
Q6.2: AI eliminou os meus ficheiros, como recuperar?
Caso 1: Ficheiro está dentro da sandbox (diretório de trabalho)
- Se "backup" estava ativado, recuperar do backup
- Caso contrário, precisa de ferramentas de recuperação profissional
Caso 2: Ficheiro está fora da sandbox (diretório do sistema)
- ⚠️ Tais operações são bloqueadas por predefinição
- Se aconteceu, por favor contacte o suporte ao cliente Mbbrowser imediatamente
Prevenção:
- Deixar AI fazer backup de ficheiros importantes antes de os operar
- Usar modo Ask (confirmação popup)
Q6.3: A API Key é segura?
✅ Segura:
- MBAgent não carrega a API Key
- Key apenas guardada no Windows Credential Manager
- Credenciais são limpas quando MBAgent é desinstalado
⚠️ Recomendações:
- Rodar regularmente a API Key
- Não colar Key em texto simples no banco de memória ou sessões
7. Banco de Memória AI
Q7.1: AI parece não "lembrar" o que disse antes
Resolução:
- Verificar se a memória existe no banco de memória AI
- Pedir novamente ao AI para lembrar e confirmar
- Verificar se o diretório de trabalho mudou
Q7.2: AI usou memória errada
Solução:
- Editar essa memória
- Corrigir ou eliminar
Q7.3: Como fazer backup do banco de memória?
- Encontrar diretório:
%LOCALAPPDATA%\mbagent\memory\ - Copiar pasta inteira
- Guardar num local seguro
8. Interface e Exibição
Q8.1: Lag da interface
Possíveis causas:
- Recursos de sistema insuficientes
- Demasiadas sessões / KMS / MCP carregados
- Problema de renderização do tema
Solução:
- Fechar separadores desnecessários
- Reduzir contagem de sessões
- Mudar tema (escuro < claro)
- Reiniciar MBAgent
Q8.2: Exibição de fonte anormal
Solução:
- Verificar se as fontes do sistema estão completas
- Mudar fonte nas definições do MBAgent
Q8.3: Barra de separadores não visível
Solução:
- Definições → Interface e Navegação → Mostrar quais separadores → marcar todos
- Reiniciar MBAgent
9. Otimização de Desempenho
Q9.1: Uso elevado de memória do MBAgent
Intervalo normal:
- Inativo: 200-500 MB
- Tarefa complexa: 1-2 GB
- Alta concorrência: 2-4 GB
Otimização:
- Fechar sessões desnecessárias
- Reduzir contagem de tarefas concorrentes
- Desinstalar serviços MCP não utilizados
Q9.2: Respostas AI lentas
Possíveis causas:
- Latência do servidor de modelos
- Problema de rede
- Contexto demasiado longo
Otimização:
- Mudar para um modelo mais rápido
- Comprimir histórico
- Verificar rede
10. Atualização e Upgrade
Q10.1: Como atualizar o MBAgent?
O MBAgent atualiza com o Mbbrowser:
- Mbbrowser deteta automaticamente a nova versão no arranque
- Prompt de atualização aparece
- Clique em "Atualizar Agora"
- Reiniciar após atualização
Q10.2: Dados perdidos após atualização?
Não:
- Banco de memória AI, sessões, KMS todos preservados
- Apenas ficheiros de config podem ser repostos
Se os dados foram perdidos:
- Verificar diretório de backup
- Recuperar do backup
- Contactar suporte ao cliente Mbbrowser
Q10.3: Pode reverter para uma versão anterior?
Sim, mas precisa:
- Fazer backup dos dados atuais
- Desinstalar a versão atual
- Instalar a versão antiga
- Restaurar dados
⚠️ Nota: Versões antigas podem não suportar novas funcionalidades.
11. Códigos de Erro
BROWSER_AUTO_UNAVAILABLE
Significado: Capacidade de automação do navegador indisponível. Causa: Browser Playwright MCP não iniciado. Solução:
- Instalar Node.js e npx
- Deixar MBAgent auto-instalar Playwright
- Reiniciar MBAgent
CONTROL_V2_DISCOVERING
Significado: A descobrir instâncias cliente Mbbrowser. Causa: Acabou de iniciar ou a fazer scan. Solução: Aguardar alguns segundos e tentar novamente.
CONTROL_V2_HANDSHAKE_SPEC_MISMATCH
Significado: MBAgent e cliente Mbbrowser usam versões de especificação ControlV2 diferentes. Solução:
- Atualizar Mbbrowser para a versão mais recente
- Atualizar MBAgent para a versão mais recente
TOOL_ENABLE_PREREQUISITE_MISSING
Significado: Pré-requisitos da ferramenta não cumpridos. Solução:
- Verificar se a Skill correspondente está ativada
- Verificar nível de autorização da conta Mbbrowser
Base de Conhecimento Mbbrowser RAG Atualmente Indisponível
Significado: Serviço da base de conhecimento RAG oficial Mbbrowser anormal. Solução:
- Verificar se a conta Mbbrowser é válida
- Verificar rede
- Contactar suporte ao cliente Mbbrowser
Mbbrowser Client ControlV2 Atualmente Indisponível
Significado: Protocolo ControlV2 do navegador Mbbrowser anormal. Solução:
- Reiniciar navegador Mbbrowser
- Reiniciar MBAgent
- Verificar Mbbrowser → Definições → ControlV2
12. Obter Ajuda
Canais Oficiais
- Documentos oficiais: https://help.mbbrowser.com/mbagent
- Consola Mbbrowser: https://www.mbbrowser.com/console
- WeChat do cliente: Ver site oficial Mbbrowser
- Email do cliente: support@mbbrowser.com
Auto Resolução
- Verificar log do MBAgent:
%LOCALAPPDATA%\mbagent\logs\ - Verificar log do navegador Mbbrowser
- Usar "Definições → Deteção de Serviço Oficial" para verificar estado do serviço
Feedback
Ao contactar o suporte ao cliente, por favor forneça:
- Número da versão MBAgent
- Número da versão do navegador Mbbrowser
- Versão Windows
- Mensagem de erro completa
- Passos de operação
- Fornecer ficheiros de log quando necessário
Voltar: Intro MBAgent ou Transferir e Instalar MBAgent.