Dépannage des connexions IA
Résolvez les erreurs de connexion, de contrôle exclusif des profils et de références de page périmées sans prendre le contrôle d’un autre profil.
Pas d'outils IFox9 dans le client
Vérifiez qu’IFox9 est en cours d’exécution, que le client attendu est détecté et configuré, et que le client IA a été redémarré. Vérifiez également les autorisations du serveur dans le client. Testez MCP dans API & MCP. N’activez pas l’accès réseau public et ne régénérez pas les certificats de signature pour résoudre un problème de connexion.
Erreurs courantes
| Erreur | Récupération |
|---|---|
UNAUTHORIZED | Vérifiez le jeton API local actuel ; remplacez un ancien jeton après rotation. |
INVALID_ARGUMENT | Utiliser le schéma d'entrée actuel de l'outil et les champs requis. |
PROFILE_NOT_FOUND | Listez à nouveau les profils et sélectionnez un profil exact auquel vous pouvez accéder. |
SESSION_NOT_FOUND / STALE_BROWSER_SESSION | Rouvrir le profil sélectionné et obtenir de nouveaux identifiants de session et de page. |
PAGE_NOT_FOUND | Listez à nouveau les pages et associez l'URL et le titre cible. |
STALE_SNAPSHOT | Prenez un nouvel instantané ; ne réutilisez jamais d’anciennes références d’éléments. |
LEASE_CONFLICT | Un autre client contrôle ce profil. Demandez-lui de libérer le contrôle ou attendez ; ne prenez pas le contrôle d'un autre profil. |
BROWSER_MODE_MISMATCH | Conservez le mode actuel ou obtenez l'approbation pour arrêter et rouvrir avec le mode demandé. |
Une tâche attend l'intervention humaine
La connexion, le CAPTCHA, les clés d'accès ou l'approbation de l'appareil peuvent nécessiter le mode visible. Demandez à l'utilisateur de compléter la vérification. Ne redémarrez pas silencieusement un profil dans un autre mode ; la réouverture change l'ID de session et peut interrompre le travail.
Les téléchargements ou téléversements échouent
Appelez browser_prepare_download avant de lancer un téléchargement, puis browser_wait_download pour en obtenir le résultat. Vérifiez le dossier Downloads/IFox9 MCP, l’espace disque disponible et les droits d’accès aux fichiers. Pour un téléversement, choisissez un fichier dans un dossier autorisé. N’annoncez pas la réussite de l’opération tant qu’un résultat n’a pas été renvoyé.
Que faut-il inclure dans une demande d'assistance
Indiquez la version d’IFox9, le système d’exploitation, le nom et la version du client IA, le mode visible ou sans interface, le code d’erreur exact et quelques étapes pour reproduire le problème dans un profil sans données sensibles. Avant d’envoyer votre demande, masquez les jetons, identifiants, cookies, contenus personnels des pages et chemins de fichiers privés. Contacter le support IFox9.