FAQ (Foire aux questions)

Cette page compile les questions fréquentes et les solutions lors de l'utilisation de MBAgent.

NOTE

Vous ne trouvez pas la réponse ? Contactez le service client Houniao ou soumettez un commentaire dans la console : https://www.mbbrowser.com/console

---

I. Installation et démarrage

Q1 : Quelles versions de Windows MBAgent prend-il en charge ?

R : Windows 10 / 11. Windows 7 nécessite une ancienne version de MBAgent (non maintenue séparément).

Q2 : Quelle est la taille du package d'installation de MBAgent ?

R : Environ 80 Mo, incluant l'exécutable compilé Rust, les dépendances, les composants UI, la police d'icônes, les modèles de prompts intégrés.

Q3 : Aucun effet après un double-clic sur l'installation ?

R :

1. Clic droit → Exécuter en tant qu'administrateur
2. Vérifiez si Windows Defender le signale à tort, ajoutez MBAgent à la liste blanche
3. Consultez le journal : %LOCALAPPDATA%\mbagent\logs\install.log
4. Désinstallez puis réinstallez

Q4 : Peut-on utiliser hors ligne ?

R : MBAgent lui-même peut démarrer hors ligne, mais l'appel aux modèles IA nécessite un réseau. Si le modèle est déployé localement (par exemple Ollama), une utilisation entièrement hors ligne est possible.

Q5 : Comment désinstaller complètement ?

R :

1. Panneau de configuration → Programmes → Désinstaller MBAgent
2. Supprimez manuellement les dossiers restants :
   • %LOCALAPPDATA%\mbagent
   • %APPDATA%\mbagent
3. Nettoyez le registre (optionnel)

---

II. Configuration et clé API

Q6 : Où obtenir la clé API ?

R :

• Houniao officiel : console Houniao → Mon compte → Crédits IA → Créer une clé
• OpenAI : https://platform.openai.com/api-keys
• Anthropic : https://console.anthropic.com/settings/keys
• Passerelle auto-hébergée : contactez l'administrateur de votre passerelle

Q7 : La clé API sera-t-elle téléchargée ?

R : Non. La clé API est stockée uniquement dans le Windows Credential Manager local, et n'est téléchargée sur aucun serveur.

Q8 : Oublié de sauvegarder la clé API, que faire ?

R : Supprimez la configuration existante, puis ajoutez à nouveau. Toutes les clés sont stockées localement uniquement, impossible à récupérer, vous devez en créer une nouvelle.

Q9 : Comment basculer entre les clés API de différents modèles ?

R : Dans Paramètres → Provider, chaque Provider peut être configuré séparément avec une clé. Les clés de différents modèles sont indépendantes.

Q10 : Comment configurer la clé d'une plateforme de transit tierce ?

R :

1. Ajoutez un Provider personnalisé
2. URL de base : adresse de la plateforme de transit (par exemple https://ai.ehouniao.com/v1)
3. Clé API : clé attribuée par la plateforme de transit
4. Sélectionnez le modèle correspondant

---

III. Questions sur les modèles

Q11 : Quels modèles MBAgent prend-il en charge ?

R : Prise en charge actuelle :

• Houniao officiel : deepseek-v4-flash, deepseek-v4-pro, deepseek-v4-vision, deepseek-v4-coder, gpt-5-mini, gpt-5-nano, gpt-5.6, gpt-5.6-sol, gpt-6.0, gpt-6.0-sol, claude-sonnet-4, claude-opus-4.5, gemini-2.5-flash, gemini-2.5-pro
• OpenAI : série GPT
• Anthropic : série Claude
• Google : série Gemini
• Personnalisé : services compatibles avec l'API OpenAI

Q12 : Le modèle reste en "chargement" indéfiniment ?

R :

1. Vérifiez la connexion réseau
2. Vérifiez que la clé API est correcte
3. Vérifiez les crédits API
4. Essayez un autre modèle
5. Consultez les journaux pour le dépannage

Q13 : Réponse du modèle très lente ?

R :

1. Passez à un modèle plus petit (par exemple deepseek-v4-flash)
2. Vérifiez le réseau (peut-être un accès international)
3. Évitez les heures de pointe API
4. Activez la sortie en streaming (activée par défaut)

Q14 : Réponse du modèle tronquée ?

R :

1. Peut-être que la fenêtre de contexte est insuffisante, ouvrez une nouvelle session
2. Peut-être un délai d'expiration côté API, laissez l'IA continuer
3. Peut-être des fluctuations réseau, renvoyez

Q15 : Comment consulter la consommation de tokens ?

R :

• Dans la session : affiché sous chaque réponse
• Barre d'état : consommation cumulée
• Console : https://www.mbbrowser.com/console → Crédits IA

---

IV. Session et banque de mémoire

Q16 : Où les sessions sont-elles stockées ?

R : %LOCALAPPDATA%\mbagent\sessions\

Q17 : Comment migrer des sessions vers un nouvel ordinateur ?

R :

1. Exportez la session au format JSON
2. Importez sur le nouvel ordinateur
3. Ou copiez directement le répertoire sessions

Q18 : Trop de sessions occupent de l'espace ?

R :

1. Supprimez les anciennes sessions inutiles
2. Configurez le nettoyage automatique (conserver les N plus récentes)
3. Exportez puis supprimez localement

Q19 : Quelle est la différence entre banque de mémoire et session ?

R :

• Session : historique d'une conversation spécifique, non partagé entre sessions
• Banque de mémoire : informations à long terme conservées entre sessions

Q20 : Après avoir vidé la banque de mémoire, l'IA se souvient-elle encore ?

R : Non. Toutes les mémoires à long terme seront effacées. Il est recommandé d'exporter une sauvegarde avant de vider.

Q21 : Puis-je supprimer une mémoire individuellement ?

R : Oui. Trouvez-la dans le panneau de mémoire, cliquez sur supprimer.

---

V. Contrôle du navigateur

Q22 : MBAgent ne peut pas se connecter au navigateur Houniao ?

R :

1. Vérifiez que le navigateur Houniao est démarré
2. Vérifiez que l'environnement est ouvert
3. Redémarrez le navigateur Houniao et MBAgent
4. Vérifiez le pare-feu
5. Essayez de changer de port

Q23 : Crash lorsque l'IA opère le navigateur ?

R :

1. Consultez le journal de crash : %LOCALAPPDATA%\mbagent\logs\crash.log
2. Mettez à jour vers la dernière version
3. Redémarrez le navigateur Houniao et MBAgent
4. Soumettez un commentaire avec les journaux

Q24 : Échec de la connexion au compte ?

R :

1. Vérifiez que l'identifiant et le mot de passe sont corrects
2. Vérifiez que le réseau est fluide
3. Vérifiez que le compte n'est pas sous contrôle des risques
4. Vérifiez si le site nécessite une vérification SMS
5. Essayez de changer d'empreinte

Q25 : L'IA opère trop lentement ?

R :

1. Augmentez la bande passante réseau
2. Réduisez la fréquence des captures d'écran
3. Fermez les attentes inutiles
4. Utilisez des prompts plus efficaces

Q26 : Le navigateur Houniao doit-il être démarré ?

R : Oui. MBAgent se connecte au navigateur Houniao via CDP, les fonctions liées au navigateur ne peuvent pas être utilisées si le navigateur Houniao n'est pas démarré.

---

VI. Fichiers et commandes

Q27 : L'IA a lu/écrit mes fichiers personnels ?

R :

1. Vérifiez immédiatement le journal des opérations
2. Ajustez les paramètres d'accès aux fichiers
3. Ajoutez les chemins sensibles à "Toujours refuser"
4. Changez les mots de passe associés si nécessaire

Q28 : Échec d'exécution de la commande ?

R :

1. Vérifiez que la syntaxe de la commande est correcte
2. Vérifiez que le répertoire de travail est correct
3. Vérifiez que vous avez les autorisations d'exécution
4. Consultez le message d'erreur

Q29 : L'IA peut-elle exécuter des commandes PowerShell ?

R : Oui. MBAgent utilise PowerShell par défaut, avec une fenêtre de confirmation avant l'exécution.

Q30 : L'IA a supprimé mes fichiers, peut-on les récupérer ?

R :

1. Vérifiez la corbeille
2. Si géré par Git, restaurez depuis Git
3. S'il y a une sauvegarde, restaurez depuis la sauvegarde
4. Utilisez un logiciel de récupération de fichiers (taux de réussite faible)

WARNING

Fortement recommandé :

• Utilisez Git pour gérer les projets importants
• Sauvegardez régulièrement les fichiers importants
• Ouvrez la fenêtre d'approbation avant les opérations IA

---

VII. Tâches planifiées et cycliques

Q31 : La tâche planifiée ne s'est pas exécutée à l'heure prévue ?

R :

1. Vérifiez que MBAgent est en cours d'exécution (la version actuelle dépend du processus principal)
2. Vérifiez que les paramètres d'heure sont corrects
3. Vérifiez que le fuseau horaire est correct
4. Consultez le statut de la tâche

Q32 : Comment arrêter toutes les tâches en arrière-plan ?

R :

• Barre d'état → Tout arrêter
• Raccourci Ctrl+Shift+Alt+K
• Ligne de commande mbagent task stop-all

Q33 : Les tâches cycliques s'exécutent-elles indéfiniment ?

R : Par défaut, oui, jusqu'à :

• Arrêt manuel
• Nombre maximal d'exécutions atteint
• Heure de fin atteinte
• Modèle de tâche supprimé

Q34 : Comment faire en sorte que les tâches continuent de s'exécuter après la fermeture de MBAgent ?

R : Non pris en charge dans la version actuelle. Recommandations :

• Maintenir MBAgent en cours d'exécution
• Ou utiliser le Planificateur de tâches Windows pour réveiller MBAgent

---

VIII. Performance et stabilité

Q35 : MBAgent consomme beaucoup de CPU ?

R :

1. Vérifiez le nombre de tâches en arrière-plan
2. Réduisez les tâches concurrentes
3. Fermez les onglets inutiles
4. Mettez à jour vers la dernière version

Q36 : MBAgent consomme beaucoup de mémoire ?

R :

1. Nettoyez les anciennes sessions
2. Fermez les tâches en arrière-plan inutiles
3. Redémarrez MBAgent

Q37 : MBAgent est lent ?

R :

1. Redémarrez MBAgent
2. Libérez de l'espace disque
3. Vérifiez les interférences de l'antivirus
4. Mettez à jour vers la dernière version

Q38 : Comment récupérer après un crash de MBAgent ?

R :

1. Redémarrez MBAgent
2. Les sessions précédentes se chargeront automatiquement
3. Consultez le journal de crash
4. Si les crashes persistent, désinstallez et réinstallez

---

IX. Sécurité et confidentialité

Q39 : MBAgent télécharge-t-il mon code ?

R : Cela dépend du modèle :

• Houniao officiel : envoyé via l'API Houniao, mais Houniao ne le stocke pas
• OpenAI, etc. : envoyé à un tiers, soumis à sa politique de confidentialité
• Modèle local : traitement entièrement local

Q40 : Comment protéger les informations sensibles ?

R :

1. Ne les envoyez pas en clair dans la conversation
2. Utilisez des variables locales
3. Configurez le filtrage des mots sensibles
4. Revoyez les opérations importantes avant de les exécuter

Q41 : Le journal des opérations sera-t-il téléchargé ?

R : Non. Le journal des opérations est stocké uniquement localement.

Q42 : MBAgent se met-il à jour automatiquement ?

R : Non. MBAgent est mis à jour via le programme principal Houniao Browser. Lorsque Houniao Browser se met à jour, MBAgent est inclus.

---

X. Dépannage des erreurs

Q43 : Erreur "Failed to bind port 9527"

R :

1. Le port 9527 est occupé
2. Trouvez le processus qui occupe : netstat -ano | findstr 9527
3. Tuez le processus ou redémarrez l'ordinateur
4. Si l'erreur persiste, changez le port MBAgent (Paramètres → Avancé)

Q44 : Erreur "API authentication failed"

R :

1. Clé API invalide ou expirée
2. Régénérez une clé API
3. Vérifiez la configuration du Provider

Q45 : Erreur "Context length exceeded"

R :

1. Le contexte dépasse la fenêtre du modèle
2. Ouvrez une nouvelle session
3. Compressez l'historique
4. Utilisez un modèle à plus grande fenêtre de contexte

Q46 : Erreur "Tool execution timeout"

R :

1. L'exécution de l'outil a expiré (par défaut 30 secondes)
2. Vérifiez le réseau
3. Augmentez le délai d'expiration (Paramètres → Avancé)
4. Exécutez par étapes

Q47 : Erreur "Browser disconnected"

R :

1. Le navigateur Houniao est déconnecté
2. Reconnectez-vous
3. Redémarrez le navigateur Houniao

---

XI. Divers

Q48 : Relation entre MBAgent et Houniao Browser ?

R :

• MBAgent est un composant intégré de Houniao Browser
• Installé et mis à jour avec Houniao Browser
• Désinstaller Houniao Browser désinstalle MBAgent
• Nécessite que Houniao Browser soit en cours d'exécution pour utiliser les fonctions de contrôle du navigateur

Q49 : MBAgent est-il payant ?

R :

• MBAgent lui-même est gratuit
• L'appel aux modèles IA nécessite une clé API, ce qui entraîne des frais d'API
• Les utilisateurs officiels de Houniao peuvent utiliser les crédits IA赠és

Q50 : Comment mettre à niveau MBAgent ?

R :

1. Lorsque le programme principal Houniao Browser se met à niveau, MBAgent est automatiquement mis à niveau
2. Ou téléchargez manuellement le nouveau package d'installation

Q51 : MBAgent est-il open source ?

R : Les composants principaux ne sont pas open source, mais des API standard et des mécanismes d'extension sont fournis.

Q52 : Comment contacter le service client ?

R :

• Site officiel : https://www.mbbrowser.com
• Console : https://www.mbbrowser.com/console
• E-mail : support@mbbrowser.com
• Téléphone : en bas du site officiel Houniao

---

XII. Annexe

A. Liste des raccourcis

Raccourci	Fonction
Ctrl+N	Nouvelle session
Ctrl+O	Ouvrir une session
Ctrl+S	Enregistrer la session
Ctrl+,	Paramètres
Ctrl+Q	Quitter
F1	Aide
Ctrl+Enter	Envoyer un message
Echap	Annuler la réponse
Ctrl+Shift+P	Basculer le mode d'autorisation
Ctrl+Shift+T	Liste des tâches planifiées
Ctrl+Shift+K	Panneau des tâches en arrière-plan

B. Emplacement des fichiers de configuration

%LOCALAPPDATA%\mbagent\
├── config.json          # Configuration principale
├── memory\              # Banque de mémoire
├── sessions\            # Historique des sessions
├── tasks\               # Modèles de tâches
├── logs\                # Journaux
├── screenshots\         # Captures d'écran
└── ...

C. Ports par défaut

Service	Port
Processus principal MBAgent	9527
CDP (navigateur Houniao)	attribué dynamiquement par le client Houniao

D. Liens connexes

• Site officiel : https://www.mbbrowser.com
• Console : https://www.mbbrowser.com/console
• Centre d'aide : https://help.mbbrowser.com
• Plateforme de transit NEWAPI : https://ai.ehouniao.com

---

TIP

Vous ne trouvez pas la réponse ?

1. Consultez la documentation d'aide
2. Faites part de vos commentaires dans le groupe utilisateurs Houniao
3. Contactez le service client Houniao
4. Soumettez un Issue