Formation — Du protocole MCP à l'usine logicielle IA

Repo support des travaux pratiques. Fil rouge unique : on fait produire un serveur MCP par un agent, on distille ce savoir-faire dans un Skill, on évalue le Skill, puis on le gouverne.

Guides pas à pas

Le site Guides des TP propose une préparation du poste et des instructions détaillées pour chaque exercice : commandes, résultats attendus, points de contrôle, livrables et dépannage. Il sera accessible après activation de GitHub Pages et premier déploiement.

Les guides sont aussi consultables dans le dépôt : accueil, préparation, TP1, TP2, TP2 Bonus, TP3, TP4 en variantes GitLab et GitHub, TP5 optionnel (bâtir la gateway agentgateway, dossier tp5-gateway/), fiche de sortie de l'atelier M7.

Supports et références formateur

• slides/Support_formation_SCIAM.pptx : le deck (61 diapositives), notes formateur incluses.
• Plaquette_IA-PLT-USINE.pdf : la plaquette, générée depuis plaquette/plaquette.html par python3 plaquette/build.py (PyMuPDF requis).
• formateur/ : démonstration du scorer trompeur (M4), corrigé possible des assertions (TP3), trace fictive du mini-exercice (M5), démonstration d'une gateway de modèles LiteLLM sur le poste formateur (M5). Réservé au formateur ; les squelettes participants restent incomplets.

Fil rouge

TP	On fait…	Artefact produit
TP1	Piloter OpenCode → serveur MCP « vanilla »	Un serveur Quarkus et des écarts éventuels constatés
TP2	Distiller le savoir-faire dans un Skill	skills/create-quarkus-mcp-server
TP3	Évaluer le Skill	Un harnais JUnit (assertions + grille de juge)
TP4	Gouverner le Skill	Repo GitLab ou GitHub : MR/PR, protection, permissions

Le domaine métier commun aux TP est un catalogue de services interne (voir domaine/). Tout est auto-contenu : aucune dépendance réseau côté domaine.

Essentiel et approfondissement

Le programme détaillé propose 14 h d'enseignement hors pauses, dont 6 h 30 de TP essentiels : TP1 1 h 30, TP2 1 h 30, TP3 2 h, TP4 1 h 30. Chaque guide distingue les sections essentielles, leurs preuves de sortie et les approfondissements (répétitions, mutations supplémentaires, installation CI de zéro, test de suppression répété). Ces derniers sont hors des 14 h, ou à faire si vous avez de l'avance sans supprimer d'étape essentielle.

Ces durées sont des cibles, pas une garantie : elles supposent les accès, le modèle, le juge LLM et l'environnement forge/runner (GitLab ou GitHub) prévalidés par le formateur avant la séance. La checklist de préparation précise les contrôles et le repli en cas d'accès manquant. Le dépôt fournit des squelettes pédagogiques, pas une CI de génération prête à l'emploi, ni GitLab ni GitHub Actions.

Prérequis

• Lecture de Java / familiarité JVM (on relit et complète, on n'écrit pas tout à la main)
• JDK 21+, Maven
• OpenCode installé et un modèle LLM câblé (cf. note formateur — prérequis n°1 du Jour 1)
• Fournisseur du juge et environnement d'atelier GitLab ou GitHub préparés pour le parcours complet

Principe directeur (rappel M0)

Écrire du code qu'on veut supprimer. Le Skill = le delta résiduel entre ce que le modèle de base sait déjà faire et la conformité maison. Le jour où le socle absorbe Quarkus+MCP, le Skill rétrécit — c'est le test de suppression.

Publier et maintenir le site

Le site Jekyll est dans docs/. Pour activer sa publication sur ce dépôt :

1. Dans Settings → Pages → Build and deployment, choisir GitHub Actions comme source (droits d'administration requis).
2. Fusionner les fichiers du site et .github/workflows/pages.yml sur main.
3. Dans Actions, vérifier le workflow Publier les guides des TP. Il peut aussi être lancé manuellement depuis main avec Run workflow.

Les pull requests modifiant le site déclenchent sa construction, sans déploiement. Les changements dans docs/ ou dans le workflow, poussés sur main, publient le site à l'adresse ci-dessus. Le workflow ne déploie que docs/, pas les projets Java ni les fichiers d'atelier. Pour un fork ou un domaine personnalisé, adapter url, baseurl et repository_url dans docs/_config.yml.

Pour prévisualiser localement, avec Ruby 3.3 et Bundler disponibles :

cd docs
bundle install
bundle exec jekyll serve --host 127.0.0.1

Ouvrir http://127.0.0.1:4000/formation-ia/. Pour vérifier seulement la génération : bundle exec jekyll build --strict_front_matter. Les guides sont rédigés en Markdown ; la navigation commune se configure dans docs/_config.yml et l'habillage dans docs/_layouts/ et docs/assets/.