FAQ et dépannage
Commencez par la boucle de diagnostic courte :
anyy --version
anyy config
anyy status
anyy doctor
anyy gateway status
Ces commandes identifient profil, répertoire résolu, santé de configuration, environnement résident et remédiations courantes sans afficher de secrets.
Questions générales
Anyy est-il un modèle local ?
Non. Anyy est l’environnement résident de l’assistant. Il utilise des points de modèles distants ou compatibles/locaux configurés, mais le modèle est une route fournisseur plutôt que le produit.
Anyy fonctionne-t-il uniquement en local ?
Les données canoniques restent locales, mais fournisseurs, web, MCP et messageries reçoivent les données requises par les tâches. Consultez Données et confidentialité.
Quelle différence entre profil, rôle et session ?
- Un profil isole données, identifiants, configuration et exécution.
- Un rôle change l’identité durable dans un profil.
- Une session est une conversation et son historique.
Séparez les profils si comptes ou domaines de confiance ne doivent pas se mélanger.
Anyy retient-il tout ?
Non. L’historique appartient aux sessions ; faits et préférences durables, à la mémoire du profil. Anyy peut rechercher les sessions si disponible, mais les détails temporaires ne doivent pas devenir automatiquement mémoire.
Puis-je supprimer une seule session ?
Le RPC session.delete supprime une session inactive, mais v0.1.107 n’expose pas de commande/bouton général CLI, TUI ou Dashboard. Supprimer un profil retire toutes ses données et ne remplace pas la suppression d’une conversation. Consultez Opérations de session.
Combien coûte l’utilisation ?
Anyy ne rend pas gratuits les appels fournisseur. Le coût dépend de modèle, raisonnement, contexte, médias, web et intégrations. Consultez les tarifs du fournisseur et /usage ou Dashboard si compatible.
Installation et mises à jour
anyy est introuvable
Ouvrez un shell neuf puis inspectez répertoire installé et PATH. Une installation native standard place le binaire sous bin/ du répertoire Anyy et une entrée utilisateur si les autorisations le permettent.
Relancez l’installateur seulement après lecture de l’erreur ; il vérifie les sommes et conserve un historique borné.
Espace insuffisant à l’installation
Libérez de l’espace dans le répertoire temporaire et Anyy. Utilisez ANYY_INSTALL_COMPACT=1 seulement si vous acceptez moins d’historique de retour arrière.
Mise à jour terminée mais ancienne version dans Dashboard
Comparez anyy --version, anyy gateway status et Dashboard → About. Un ancien processus manuel peut rester actif. Suivez la remédiation sans supprimer les versions à la main.
Modèles et fournisseurs
Setup ne vérifie pas le modèle
Vérifiez point, protocole, ID, identifiant, réseau et limites du compte. Utilisez le catalogue installé ; un nom valide sur un point ne l’est pas automatiquement sur un autre.
Dashboard Chat ne peut pas envoyer
Dans Dashboard → Models, vérifiez une route principale. Test connection vérifie catalogue et appartenance, sans génération. Enregistrez, créez une conversation et demandez une courte réponse. Avec secours, confirmez la cible productrice avant d’y voir une vérification du modèle choisi. Lancez aussi anyy status : Gateway doit être joignable.
Un média échoue malgré une conversation fonctionnelle
Compréhension image/vidéo, génération, transcription et TTS sont indépendants. Configurez/testez la route spécifique ; un modèle textuel n’implique pas les points vocaux/image. Dashboard classe PNG/JPEG comme images et le reste comme fichiers ; importer audio/vidéo n’invoque donc pas automatiquement leur traitement. Consultez Compréhension des médias.
Le raisonnement a augmenté le coût
Changer l’effort peut invalider le cache. Créez une session après un changement majeur si contexte et cache prévisibles comptent.
Dashboard et profils
L’URL Dashboard ne s’ouvre pas
Lancez :
anyy dashboard --status
anyy status
Redémarrez avec --no-open pour afficher l’URL actuelle. Utilisez This machine sur l’hôte Anyy ; l’URL LAN exige écoute accessible et réseau fiable.
Dashboard et CLI montrent des sessions différentes
Comparez Dashboard → About et anyy config. Vérifiez --profile, --profile-root, --home, ANYY_HOME, ANYY_DEFAULT_HOME et sélection active.
Profil impossible à supprimer
La cible doit être non par défaut, non courante, hors sélection persistante active et arrêtée. La CLI exige --force et refuse les secrets non vides sans --purge-secrets.
Sessions absentes après basculement
Le changement ne migre pas les données. Revenez au profil d’origine et vérifiez son répertoire dans About/config.
Outils, Skills et MCP
Outil configuré mais invisible
Vérifiez Dashboard → Tools, ensembles de session, santé facultative et besoin éventuel de nouvelle session. Identifiants, santé et périmètre restent déterminants.
Pour Codemode et les outils différés, consultez aussi Codemode et Recherche d’outils. Un défaut de profil enregistré ne change pas automatiquement une session existante.
Échec de fichier ou de commande
Inspectez résultat, chemin/commande, autorisations système et limites. Les outils activés s’exécutent directement. Si Chat montre une clarification, répondez ou interrompez.
Skill absent
Confirmez l’activation pour profil/interface puis lancez :
anyy skills reload
Réessayez à la demande suivante et vérifiez les avertissements. Les Skills système ne se retirent/basculent pas comme ceux installés. L’installateur accepte seulement les ZIP locaux ; consultez Skills.
MCP connecté mais outils absents
Vérifiez activation, offre actuelle, exposition et sélection de session. direct utilise les déclarations ; codemode/deferred la découverte correspondante activée ; hidden reste indisponible. Une sonde aide à inspecter le catalogue. Consultez Exposition MCP.
Référence @ bloquée
Chemins d’identifiants, binaires, URL privées/internes, échappements, contenu trop grand et changements Git sensibles sont refusés. Choisissez une plage sûre plus petite ou une source publique permise.
Problèmes web
Recherche web échouée
Ouvrez Dashboard → Tools ou anyy tools websearch, vérifiez fournisseur/identifiant et testez. La récupération d’URL publiques bloque aussi les cibles de réseau privé.
Messagerie
Canal sans réception
Lancez son diagnostic, vérifiez activation/connexion puis règles privées/groupes et associations. Certaines plateformes exigent aussi accessibilité webhook ou abonnements aux événements.
Livraison sortante échouée
Confirmez liaison de destination, santé, capacité et reçu. Un appel réussi sans reçu confirmé peut nécessiter une enquête propre à la plateforme.
Un inconnu peut joindre Anyy
Désactivez le compte ou resserrez les règles, révoquez les associations indésirables, renouvelez les identifiants exposés et inspectez l’activité récente.
Automatisations et arrière-plan
Travail Cron jamais exécuté
Vérifiez activation, interprétation du fuseau, Gateway résident et existence rôle/ensembles. Dans sa conversation créatrice, demandez l’exécution immédiate puis inspectez historique achevé et livraison. Consultez Automatisations.
Exécution planifiée en attente
Ouvrez sa conversation d’arrière-plan et inspectez exécution, outil ou clarification. Vérifiez les identifiants du modèle, la route de livraison et la santé de l’environnement.
Travail d’arrière-plan disparu
Vérifiez Background et profil d’origine. Utilisez les contrôles de cette session ; changer de profil change le périmètre visible.
Sauvegarde et récupération
La cible de restauration existe
La restauration exige volontairement un nouveau répertoire inexistant. Choisissez un autre chemin sans recouvrir un profil actif.
Fournisseurs restaurés sans authentification
Les sauvegardes courantes omettent secrets/ géré et mcp/oauth/ compatible. Reconnectez ou restaurez une archive protégée les incluant. Une archive normale peut encore contenir des secrets en clair dans configuration/Workspace ; toutes exigent un traitement privé. Consultez Sauvegarde et restauration.
Doctor signale encore un problème
Suivez la remédiation de la sonde échouée, puis le diagnostic spécifique. Conservez journaux et dossier de débogage seulement après examen de leur sensibilité.
Toujours bloqué ?
Rassemblez les preuves minimales reproductibles :
- version et commit de Dashboard → About ;
- ID du profil avec segments privés du chemin masqués ;
- commande exacte et erreur sûre ;
- noms des sondes
status/doctor; - changement précédant immédiatement l’échec.
Ne publiez jamais URL Dashboard à jeton, clés API, codes OAuth, secrets de canal, environnement complet, messages privés ou sauvegardes non relues.