MICROSOFT AGENT FRAMEWORK · 0.16.0-rc.1
Configurateur central
Configurer les profils communs sans recompiler les démos.
Objectifs
- Utiliser cette page pour comprendre : Configurateur central.
L’entrée préalable du parcours
00-ConfigurateurDemo est un utilitaire console Spectre.Console en anglais, séparé des 49 démos. Après compilation de la solution complète, ouvrir son menu dans un terminal interactif normal. En entrée redirigée, utiliser les sous-commandes show, validate et set ; le programme refuse le menu interactif.
Menu et commandes de diagnostic
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- show
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- validate
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- modelscase "validate" when args.Count == 1:
file.Validate();
AnsiConsole.MarkupLine("[green]Stored configuration is valid.[/] Network connectivity and API keys were not tested.");
Code source · 00-ConfigurateurDemo · Dossier
show affiche les réglages sans les clés ; validate vérifie la configuration stockée sans tester réseau ni clés. models interroge la liste des modèles Ollama à l’endpoint choisi, sans installer de modèle ni écrire le profil. check chat et check embeddings envoient une vraie requête avec les réglages sauvegardés, sans qualifier le tool calling ou la qualité métier.
Modifier et sauvegarder
Le menu règle chat local ou API compatible, embeddings indépendants, timeouts, chemins absolus de bases et d’états, corpus et date d’éligibilité RAG, politique read-only, URLs backend, stockage de sessions, serveur MCP précompilé et profils d’instructions. Il ne démarre aucun service et ne choisit aucune décision d’approbation à votre place.
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- set AI:LocalChat:Model granite4:3bLe fichier central est shared/Configuration/ai-settings.json. Save valide les profils stockés, conserve les sections non concernées et crée une sauvegarde unique à côté du fichier. Une édition périmée ne peut écraser une sauvegarde concurrente. Les processus déjà lancés doivent redémarrer ; aucun rebuild n’est requis. Les variables d’environnement et arguments de démo gardent la priorité.
Profil isolé et secrets
Pour expérimenter, copier le JSON vers un nouveau fichier de travail puis sélectionner son chemin absolu avec MAF_DEMO_CONFIG. --config <file> ne sélectionne un fichier alternatif que pour le configurateur ; les démos ont aussi besoin de la variable. Changer le chat laisse embeddings et données intactes. Changer les vecteurs exige une reconstruction explicite de l’index.
Le JSON contient uniquement les noms des variables de clé. Store API key utilise une saisie masquée et l’environnement utilisateur Windows ; les valeurs déjà présentes dans le processus sont prioritaires. Cette action accepte les noms commençant par MAF_ ou finissant par _API_KEY. Configurer le modèle API avant de sélectionner ce fournisseur. Aucun secret n’est passé à set ni aux arguments et aucun compte ChatGPT n’est connecté.
Échecs à comprendre
Un fichier absent, une URL invalide, un modèle API vide lors de l’activation, un chemin non absolu ou une sauvegarde concurrente doit échouer explicitement. Un check échoue si le service ou modèle manque ; il ne bascule pas automatiquement vers le cloud. Les commandes show/validate sont sans modèle ; models exige le service Ollama ; check exige le service et le modèle. Le menu graphique et les appels réels n’ont pas été rejoués pour cette fiche.