Solução de problemas de conexões de IA
Resolva erros de conexão, de controle exclusivo dos perfis e de referências de página desatualizadas sem assumir o controle de outro perfil.
Sem ferramentas IFox9 no cliente
Confirme que o IFox9 está em execução, o cliente esperado foi detectado e configurado, e o cliente de IA foi reiniciado. Verifique qualquer aprovação de servidor no lado do cliente. Teste o MCP em API & MCP. Não habilite redes públicas nem regenere certificados de assinatura como uma solução alternativa de conexão.
Erros comuns
| Erro | Recuperação |
|---|---|
UNAUTHORIZED | Verifique o token de API local atual; substitua um token antigo após a rotação. |
INVALID_ARGUMENT | Use o esquema de entrada atual da ferramenta e os campos obrigatórios. |
PROFILE_NOT_FOUND | Liste os perfis novamente e selecione um perfil exato que você possa acessar. |
SESSION_NOT_FOUND / STALE_BROWSER_SESSION | Reabra o perfil selecionado e obtenha novos IDs de sessão e página. |
PAGE_NOT_FOUND | Liste as páginas novamente e combine a URL e o título alvo. |
STALE_SNAPSHOT | Tire um novo snapshot; nunca reutilize referências de elementos antigas. |
LEASE_CONFLICT | Outro cliente controla este perfil. Peça para liberar o controle ou espere; não assuma um perfil diferente. |
BROWSER_MODE_MISMATCH | Mantenha o modo atual ou obtenha aprovação para interromper e reabrir com o modo solicitado. |
Uma tarefa aguarda a entrada humana
Login, CAPTCHA, chaves de acesso ou aprovação de dispositivo podem precisar do modo visível. Peça ao usuário para completar a verificação. Não reinicie um perfil silenciosamente em outro modo; reabrir altera o ID da sessão e pode interromper o trabalho.
Downloads ou uploads falham
Use browser_prepare_download antes da ação de download e browser_wait_download para obter o resultado. Verifique Downloads/IFox9 MCP, espaço disponível em disco e permissões de arquivo. Para uploads, escolha arquivos de um diretório permitido. Não declare sucesso até que um resultado seja realmente retornado.
O que incluir em uma solicitação de suporte
Informe a versão do IFox9, o sistema operacional, o nome e a versão do cliente de IA, o modo visível ou sem interface, o código exato do erro e os passos para reproduzir o problema em um perfil sem dados sensíveis. Antes de enviar a solicitação, oculte tokens, credenciais, cookies, conteúdo pessoal das páginas e caminhos de arquivos privados. Entre em contato com o suporte do IFox9.