Agent Switchboard
Télécharger

Langue

Votre choix de langue est conservé dans un cookie.

Thème
Documents du guide

Dépannage

À vérifier en premier

  • Mettez l'application à jour : beaucoup de problèmes sont déjà corrigés dans les nouvelles versions. Pour les fonctionnalités qui impliquent un téléphone ou un autre PC, le PC relié doit lui aussi être à jour.
  • Relevez le message d'erreur exact : l'application n'affiche pas les mêmes indications selon la cause.

Installation et mises à jour

Windows affiche un avertissement SmartScreen

Cet avertissement apparaît parce que les fichiers d'installation Windows ne sont pas encore signés avec Authenticode. Vérifiez que le fichier vient bien de la page de téléchargement officielle, puis cliquez sur Informations complémentaires → Exécuter quand même. Les détails sont dans Installation et premier lancement.

La version Portable ne se met pas à jour toute seule

Windows Portable ne peut pas installer de mise à jour depuis l'application. Téléchargez le nouveau fichier sur la page de téléchargement et remplacez l'ancien. Pour profiter des mises à jour automatiques, utilisez la version Setup.

Impossible de joindre le serveur de mises à jour

Si l'application ne parvient pas à joindre l'adresse de mise à jour, elle ouvre la page des versions dans votre navigateur par défaut : il suffit d'y télécharger le fichier d'installation. Les mises à jour ne demandent ni compte ni jeton d'accès.

Aucune notification de mise à jour

  • Si vous avez choisi 「나중에」 (Plus tard), l'application ne vous relance pas pendant 4 heures tant qu'elle reste ouverte.
  • Si vous avez choisi 「이번 버전 건너뛰기」 (Ignorer cette version), cette version n'est plus signalée automatiquement.
  • Une vérification manuelle avec l'icône de téléchargement en haut de la fenêtre réaffiche les versions reportées et ignorées.

L'installation de la mise à jour échoue

La raison de l'échec s'affiche dans la fenêtre de mise à jour et dans celle de confirmation du redémarrage.

  • macOS : en cas d'erreur pendant la vérification de l'installation ou de dépassement du délai de 120 secondes, vous pouvez réessayer.
  • Linux .deb : une fenêtre de privilèges administrateur doit s'ouvrir pendant l'installation. Si elle n'apparaît pas dans les 3 minutes, l'installation s'arrête et l'application vous donne la commande pour installer vous-même depuis un terminal. Le message n'est pas le même selon que vous avez annulé dans la fenêtre de privilèges ou que les privilèges n'ont pas pu être obtenus.
  • Linux, application lancée depuis un shell en bac à sable : la restriction NoNewPrivs peut empêcher l'élévation de privilèges. L'application ouvre alors la fenêtre d'authentification via systemd utilisateur et, si cela échoue encore, explique comment installer avec sudo depuis un terminal hors de l'application.

Connexion du téléphone et QR code

Impossible de cliquer sur 「연결 QR 만들기」 (Créer un QR code de connexion)

Le QR code ne peut être créé qu'une fois le PC connecté au serveur relais. Vérifiez dans 「환경 설정 › 휴대폰」 (Préférences › Téléphone) que 「휴대폰 연결 켜기」 (Activer la connexion du téléphone) est activé et que l'état indique « connecté ».

Impossible d'activer la connexion du téléphone

Si le PC ne peut pas utiliser le stockage sécurisé du système, la connexion du téléphone ne peut pas être activée, et rien n'est enregistré en clair à la place. Sous Linux, activez un keyring tel que Secret Service puis redémarrez l'application.

Le QR code est indiqué comme expiré ou déjà utilisé

Un QR code reste valable 5 minutes et ne sert qu'une fois. Créez-en un nouveau sur le PC et reconnectez-vous.

Le message 「연결 시도가 너무 잦습니다」 (Trop de tentatives de connexion) s'affiche

Après un échec d'authentification, le PC bloque brièvement la connexion (environ 1 minute) au niveau du serveur relais. Patientez une minute, puis réessayez avec un nouveau QR code.

Le message 「연결이 해제되었습니다」 (La connexion a été supprimée) s'affiche

Ce message apparaît quand le PC a déconnecté ce téléphone ou que l'identité du bureau a été recréée. Créez un nouveau QR code sur le PC et reconnectez-vous. Si vous passiez par un compte Google, il suffit d'autoriser à nouveau l'appareil dans la fenêtre d'approbation du PC.

Le PC est indiqué comme éteint

Vérifiez que le PC est allumé et qu'Agent Switchboard est en cours d'exécution. Dès que le PC est rallumé, la connexion se rétablit d'elle-même.

L'application Android affiche uniquement 「네트워크 연결을 확인하세요」 (Vérifiez votre connexion réseau)

L'application Android signée avec la clé de distribution (0.6.0 ou ultérieure) ne peut se connecter par compte Google qu'à un PC en version 0.65.2 ou ultérieure. Mettez à jour l'application sur le PC.

Le message 「Google 계정을 확인하지 못했습니다」 (Impossible de vérifier le compte Google) s'affiche

Si l'horloge du PC retarde, la preuve de connexion Google peut ne pas être vérifiée. La version 0.65.3 pour PC corrige le cas d'une horloge légèrement en retard. Mettez à jour l'application sur le PC et activez la synchronisation automatique de l'heure du système d'exploitation.

Le PC affiche 「Google에 다시 로그인해 주세요」 (Reconnectez-vous à Google)

La connexion Google du PC a expiré. Cliquez sur 「Google 다시 로그인」 (Se reconnecter à Google) dans Préférences › Téléphone. Tant que vous ne vous êtes pas reconnecté, aucun autre appareil ne peut établir de nouvelle connexion.

Impossible d'installer à nouveau l'application Android

Si un APK portant une autre signature est déjà installé, le nouveau ne peut pas s'installer par-dessus. Désinstallez l'ancienne application, installez le nouvel APK, puis reconnectez le PC et votre compte Google.

La liste des PC est vide après le changement d'adresse de l'application web

L'application web mobile se trouve désormais à l'adresse https://app.switchboard.twentyoz.kr. Les informations de connexion de l'ancienne adresse ne suivent pas vers la nouvelle. Reconnectez-vous par QR code ou, si vous utilisiez un compte Google, reconnectez-vous pour charger la liste des PC.

Clés et authentification

「저장 후 적용」 (Enregistrer et appliquer) est désactivé (Linux)

Sur un PC qui ne peut pas utiliser le stockage sécurisé du système (keyring), les clés API ne peuvent pas être enregistrées ; la raison s'affiche au-dessus du bouton. Activez un keyring puis redémarrez l'application.

Le modèle choisi n'est pas appliqué

Au test de connexion comme à l'application, le modèle choisi est vérifié ; s'il n'est pas utilisable, l'application des paramètres s'arrête. Choisissez à nouveau un modèle disponible dans la liste.

Le CLI renvoie l'erreur « credential is not configured »

Cette erreur peut apparaître si un CLI est lancé avec un ancien profil d'exécution après un changement de connexion du dossier. Réappliquez la connexion dans la configuration de l'outil, puis relancez le CLI. Si le dossier a des paramètres Codex mais que seul son profil de connexion a disparu, l'application recrée le profil à partir des paramètres enregistrés.

L'erreur « SECURE_STORAGE_BOOTSTRAP_FAILED » persiste

  1. Vérifiez qu'Agent Switchboard et tous les processus associés sont arrêtés.
  2. Si seul le fichier de verrou .secure-storage-bootstrap.lock est resté à la suite d'un arrêt forcé pendant l'initialisation, copiez ce fichier ailleurs, supprimez-le, puis relancez l'application.
  3. Ne supprimez ni ne modifiez le fichier Local State ou le dossier credentials. Laissez les originaux tels quels et contactez-nous.

Un message indique que la prise en charge du niveau de raisonnement n'a pas pu être vérifiée

Si la prise en charge d'un niveau de raisonnement n'a pas pu être vérifiée, la valeur par défaut de l'outil est envoyée et un message vous le signale. Si ce message vous empêchait de démarrer une conversation dans une version précédente, mettez l'application à jour.

Sous Windows, la fenêtre de connexion OAuth s'ouvre sur un terminal vide

Le problème venait du profil de démarrage PowerShell de l'utilisateur, qui bloquait la commande de connexion. Depuis la version 0.61.2, la fenêtre d'authentification ignore ce profil. Mettez l'application à jour.

Pour nous contacter

Pour signaler un problème de sécurité, ne joignez pas de clé API, de jeton OAuth, de fichier d'authentification ni de fichier de configuration complet. Envoyez seulement l'adresse de connexion, le système d'exploitation, la version de l'application, les étapes pour reproduire le problème et le message d'erreur, valeurs sensibles masquées. Écrivez-nous à hello@twentyoz.kr.