Configuration

La configuration Anyy appartient à un profil. Chaque profil possède routes de modèles, canaux, outils, planifications, identifiants, Workspace et état propres.

Méthodes recommandées de modification

Modification	Interface recommandée
Première configuration	anyy setup
Modèles et identifiants	Dashboard → Models ou anyy setup model
Canaux	Dashboard → Channels ou anyy setup channel
Routes image, vidéo et parole	Dashboard → Models ou page Tools correspondante
Recherche web	Dashboard → Tools → Web Search
Rôles, Skills, MCP et Cron	Leur section Dashboard
Inspection de la configuration résolue	anyy config

anyy config est en lecture seule. Il indique profil, chemins, fournisseur/modèle et santé des références d’identifiants sans afficher de secrets.

Utiliser l’éditeur pris en charge

Dashboard et les commandes setup valident les changements, protègent les identifiants et rechargent l’environnement actif si possible. L’édition YAML directe aide à la récupération avancée mais omet ces contrôles guidés.

Disposition du profil

Le répertoire actif contient les données utilisateur canoniques du profil. Chemins importants :

Chemin	Usage
config.yaml	Paramètres et références d’identifiants ; les valeurs MCP gardent les chaînes saisies
secrets/	Secrets gérés par Anyy
state.db	Sessions, messages, travaux, audit et autres états durables
memory/USER.md	Faits et préférences durables de l’utilisateur
memory/MEMORY.md	Mémoire durable de l’assistant
objects/	Charges durables adressées par contenu référencées par l’état canonique
workspace/	Fichiers de contexte et de travail produits par l’utilisateur
skills/	Skills installés localement dans le profil
roles/	Définitions de rôles locales au profil

Ne traitez pas workspace/ comme une frontière de sécurité. Un outil suit toujours les autorisations système et limites d’exécution.

Quel profil est actif ?

anyy status
anyy config

Pour inspecter un autre profil nommé :

anyy --profile work config

Les commandes acceptant --home PATH peuvent cibler un répertoire explicite. Évitez de mélanger --profile, --profile-root et --home ad hoc, sauf pour diagnostiquer volontairement la résolution des chemins.

Configuration du raisonnement et migration

La préférence globale de raisonnement réside dans main_model.inference ; les remplacements facultatifs propres à une cible exacte sont dans la map racine model_thinking_levels :

main_model:
  provider_id: your-provider
  model: your-model
  inference:
    enabled: true
    # Leave level omitted to keep the global level unset.
model_thinking_levels:
  "your-provider/your-model": high

Utilisez vos ID de fournisseur/modèle configurés. Les clés se divisent au premier / ; les deux côtés doivent être non vides. La validation ne normalise pas les clés et la recherche est exacte. Une clé de modèle non enregistré peut être sauvegardée pour plus tard. Les valeurs sont les niveaux Pi nommés off, minimal, low, medium, high, xhigh ou max ; les instantanés d’exécution retirent les espaces de bord des valeurs. Une valeur vide dans la map est invalide.

enabled global vaut true par défaut. Avec true ou omis, l’absence de niveau signifie non défini ; enabled: false demande explicitement l’arrêt, même sans niveau. Le nom off est aussi valide. Le modèle borne la demande ; inference.effective_level est en lecture seule et n’est pas un paramètre YAML. Consultez l’ordre de sélection.

À la migration vers v0.1.107 :

• Supprimez prompt_program.inference_level, même vide. Null et autres valeurs typées sont aussi rejetés. Déplacez la préférence globale vers main_model.inference, ou celle d’un modèle précis vers model_thinking_levels.
• Supprimez prompt_program.render_profile dès qu’il est présent, même null ou vide. Il n’a ni sélecteur de remplacement ni exigence de niveau élevé.
• Remplacez les valeurs produit provider_default par un niveau Pi nommé. Globalement, omettre level conserve l’absence de préférence ; pour une entrée de map, choisissez une valeur nommée ou supprimez l’entrée.

JSON/YAML et les API produit rejettent explicitement les anciennes entrées ; aucun alias ni conversion silencieuse vers medium n’existe. Anyy ne réécrit pas ces valeurs ; migrez-les explicitement. Les paramètres publics prompt_program ne gardent que resource_class. L’inférence native de bas niveau omise reste valide.

Nouvelles tentatives et interfaces de modèles

Tentatives de session, du SDK fournisseur, secours et rappels de modèles virtuels ont des contrôles distincts ; retry.enabled ne les désactive pas tous. Consultez Protocoles et interfaces de modèles pour les enregistrements typés providers[].models[], l’échantillonnage et les réglages exacts retry/httpIdleTimeoutMs.

Configuration MCP

Les définitions du profil restent sous mcp.client.servers dans config.yaml. Le Workspace canonique peut aussi contenir .anyy/mcp.json, actuellement <ProfileHome>/workspace/.anyy/mcp.json. Les définitions complètes de projet remplacent celles de même nom ; les entrées partielles remplacent uniquement activation, exposition et règles ordonnées complètes d’exposition d’outils. Consultez Configuration profil et projet pour format et expressions.

Activation/exposition sont enregistrées dans la définition sélectionnée ou le remplacement projet existant et n’affectent que ce serveur. Description, remplacements d’outils, transport et identifiants modifiés par les commandes de profil restent des modifications brutes du profil. Paramètres CLI et options de profil doivent être soumis séparément. enable/disable --project crée un remplacement limité à l’activation pour un serveur encore sans remplacement. add/remove --local n’édite que les définitions natives de projet, préserve profil et identifiants indépendants et s’applique après démarrage ou rechargement d’une session inactive.

anyy mcp reload reconnecte avec les valeurs chargées sans relire les fichiers. Le démarrage et le RPC existant session.reload à l’état inactif relisent profil/projet. Consultez MCP pour expressions, exposition et OAuth.

Identifiants

Les identifiants gérés utilisent des références dans la configuration plutôt que les secrets. Les opérations explicites compatibles de Dashboard/setup écrivent sous secrets/ avec permissions restreintes. Les écritures ordinaires de valeurs MCP conservent chaînes et expressions sans créer automatiquement de secrets gérés. Consultez Valeurs MCP.

Remplacez, effacez, connectez ou déconnectez les identifiants via la fonction qui les a créés. Ne collez jamais de secrets dans demandes, captures, historique shell ou dossiers d’assistance.

Appliquer les changements

De nombreuses opérations Dashboard/setup rechargent la partie concernée après écriture réussie. Les canaux peuvent aussi être rechargés explicitement :

anyy channel reload

Si le changement est enregistré sans effet visible, vérifiez :

anyy status
anyy doctor
anyy gateway status

Redémarrez uniquement si la remédiation le demande ou qu’un rechargement actif ne peut aboutir.

v0.1.107 rejette les anciens réglages MCP suivants. Supprimez-les ou migrez-les dans les configurations manuelles :

• mcp.client.enabled : utilisez enabled par serveur.
• mcp.client.session_idle_ttl_ms : retiré ; les catalogues s’actualisent par notifications et opérations explicites.
• connect_timeout_ms du serveur : utilisez call_timeout_ms existant pour chaque initialisation, découverte ou requête.
• tools.include, tools.exclude et tools.trusted : utilisez exposure et toolExposure ; tools.resources et tools.prompts sont aussi retirés.

Il n’existe aucune nouvelle clé request_timeout_ms. Consultez Serveurs MCP pour formats et migration complets.

Sauvegarder avant l’édition manuelle

anyy backup create

Par défaut, les répertoires gérés secrets/ et compatibles mcp/oauth/ sont omis ; --include-secrets les ajoute. Configuration canonique et fichiers Workspace restent capturés : leurs identifiants en clair peuvent donc entrer même dans une archive par défaut. Les sauvegardes ne sont pas garanties entièrement masquées. Protégez chaque archive comme privée et incluez les magasins de secrets seulement avec la protection d’un magasin d’identifiants. Consultez Sauvegarde et restauration.

Dépannage

Symptôme	Points à vérifier
Un paramètre semble inchangé	Confirmez le profil actif et inspectez anyy config
Gateway utilise encore l’ancienne valeur	Lancez le rechargement concerné, puis anyy status
Échec de validation	Utilisez formulaire ou assistant pour identifier le champ invalide
Identifiant configuré non résolu	Remplacez-le depuis sa page Models, Tools ou Channels
YAML manuel empêchant le démarrage	Restaurez le dernier fichier valide ou une sauvegarde dans un nouveau profil