Installation et configuration initiale

Récupérer la bonne révision

Le dépôt canonique du code complet est https://github.com/odahan/MAF-Course-Code. Conserver toute son arborescence : la solution est à la racine du dépôt, sans sous-dossier BaseTechnique supplémentaire. Télécharger l’archive de la révision liée par le cours ou cloner le dépôt puis sélectionner ce SHA. Une copie du seul dossier d’une démo omet les projets partagés et les versions centralisées.

git clone https://github.com/odahan/MAF-Course-Code.git MAF-Course-Code
Set-Location MAF-Course-Code
git checkout --detach 9a895c94534cd5fc6f3da883e37e5f7856e588c1
git rev-parse HEAD

Le clone nécessite Git et le réseau ; une archive complète offre l’autre voie. Après extraction, ouvrir PowerShell dans le dossier qui contient BaseTechnique.slnx, global.json, Directory.Packages.props, demos et shared. Le nom de ce dossier est libre. Les commandes suivantes partent toutes de cette racine.

Restaurer et compiler

dotnet --version
dotnet restore BaseTechnique.slnx -m:1 --configfile NuGet.Config --locked-mode --disable-parallel
dotnet build BaseTechnique.slnx -m:1 -c Release --no-restore
dotnet test BaseTechnique.slnx -m:1 -c Release --no-build --no-restore

Vérifier le SDK avant de modifier un projet pour contourner une erreur. Les fichiers packages.lock.json accompagnent les projets : --locked-mode refuse une résolution différente. --no-restore sépare compilation et restauration ; --no-build exécute les binaires déjà construits. Toutes les commandes build/test limitent explicitement MSBuild avec -m:1.

La preuve du Lot-005 porte sur une extraction propre de la candidate locale reconstruite : 79 projets compilés et 241 tests réussis. Les fichiers de code de cette candidate correspondent au SHA lié ; les notices MIT préparées n’y sont pas encore publiées. Ce n’est pas un nouvel essai de téléchargement ni une nouvelle qualification de modèle. Les journaux détaillés restent privés.

Première exécution sans modèle

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/Demo010_CodeOrAgent/Demo010.App.csproj -c Release --no-build

show affiche les réglages et validate contrôle leur cohérence stockée. Aucun des deux ne teste le réseau ou les capacités du modèle. Demo010 par défaut calcule une remise puis classe explicitement une demande vers Auth ; il quitte avant de créer le client de chat. Ce passage permet de distinguer un problème de SDK d’un problème de service IA.

Préparer les appels réels

ollama list
ollama pull granite4:3b
ollama pull embeddinggemma:300m
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- check chat
dotnet run --project demos/00-ConfigurateurDemo -c Release --no-build -- check embeddings

Pour suivre le profil local distribué, installer et démarrer Ollama séparément, puis installer les modèles nécessaires. Les commandes pull téléchargent les modèles ; ne télécharger les embeddings que pour les exercices qui les utilisent. check chat et check embeddings envoient chacun une requête réelle vers le profil sauvegardé. Avec un profil API choisi explicitement, ces requêtes vont au service API configuré.

• Configurateur central

• Connexion et capacités

Diagnostiquer sans changer de scénario

Une restauration échoue sans paquets disponibles ; --no-build échoue sans binaires. Un service arrêté, un modèle absent, un endpoint incorrect ou une clé absente n’entraîne aucune bascule cloud. Utiliser une base et un profil de travail isolés ; les programmes ne réinitialisent pas vos données. Le cours ne demande ni Qdrant ni Docker. Le RAG ultérieur utilisera Microsoft.Data.Sqlite, de vrais vecteurs et le cosinus exact C#.

Continuer le parcours

• Demo010 — Code ou agent

• Code, workflow et agent

• Demo020 — Connection Profiles