Solução de problemas de conexões de IA
Recupere-se de erros de conexão, aluguel de perfil e página desatualizada sem assumir um perfil de navegador não relacionado.
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 uma nova captura; 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. Escolha envios 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
Inclua a versão do IFox9, sistema operacional, cliente de IA/versão, modo visível ou headless, código de erro exato e uma curta reprodução usando um perfil não sensível. Redija tokens, credenciais, cookies, conteúdo de página pessoal e caminhos de arquivos privados. Contate o suporte do IFox9.