Archivé : 06b SRE assistée par l’IA avec LibreChat hébergé
Référence archivée pour l’ancien module facultatif consacré à LibreChat hébergé.
Module archivé
Le module 06b ne fait plus partie de l’atelier. Ne provisionnez pas LibreChat pour le parcours participant actuel. Passez directement de 06 SRE assistée par l’IA à 07 Tester, provoquer une panne et réparer. Les ressources ci-dessous restent disponibles uniquement comme référence historique.
Point de départ historique
Lorsque ce module était actif, les participants restaient sur build-workshop-v1 et
prévoyaient environ 15 minutes.
Prérequis : le module 05 est terminé, votre formateur vous a fourni une URL HTTPS LibreChat
et un compte, et vous disposez d’un jeton GitHub à permissions fines donnant un accès en
lecture seule à ClickHouse/ClickHouse_Demos. Les participants autonomes peuvent déployer
LibreChat avec son guide cloud Railway en un clic
officiel avant de commencer ce module.
Hébergement cloud uniquement
N’exécutez ni LibreChat, ni MongoDB, ni aucune autre base de données sur la machine de
l’atelier. LibreChat et sa persistance s’exécutent sur l’instance hébergée. Ses rappels
OAuth doivent utiliser l’URL HTTPS de cette instance, jamais localhost.
Pourquoi
Au module 06, l’agent se trouvait dans votre éditeur. Ici, un agent SRE conçu pour le chat enquête simultanément sur deux plans distants : la télémétrie ClickStack et le code source public de l’atelier sur GitHub.
Étape 1 — Se connecter à LibreChat hébergé
Ouvrez l’URL HTTPS fournie par votre formateur et connectez-vous avec le compte qui vous a été attribué. Les participants autonomes utilisent l’URL Railway publique créée lors du déploiement cloud.
L’adresse de la page doit commencer par https://. Si elle pointe vers localhost,
arrêtez-vous et utilisez l’URL hébergée.
Étape 2 — Connecter les serveurs MCP distants
Ouvrez MCP Settings. Votre formateur a peut-être déjà partagé ces définitions de serveur ; sinon, ajoutez-les dans l’interface :
| Nom | Type | URL | Authentification |
|---|---|---|---|
clickstack | Streamable HTTP | https://mcp.clickhouse.cloud/clickstack | OAuth dans le navigateur |
github | Streamable HTTP | https://api.githubcopilot.com/mcp/ | Votre jeton PAT en lecture seule |
Pour clickstack, commencez par copier l’UUID indiqué sous ClickStack Team Settings →
Data → Connections → Default → Service ID dans le champ CLICKSTACK_SERVICE_ID propre
à l’utilisateur dans LibreChat. Choisissez ensuite Connect et terminez OAuth pour
ClickHouse Cloud. Le rappel revient vers l’URL HTTPS de LibreChat hébergé.
Pour github, fournissez votre jeton PAT à permissions fines uniquement dans la boîte de
dialogue d’identifiants propres à l’utilisateur de LibreChat. Limitez-le à
ClickHouse/ClickHouse_Demos avec Contents: read. Activez l’ensemble d’outils en lecture
seule ou pour le dépôt si le formulaire du serveur propose ces options.
Les deux serveurs doivent afficher Connected avant de poursuivre.
Étape 3 — Créer l’agent SRE
Ouvrez Agent Builder et créez un agent :
- Nommez-le
NYC Taxi Ops SRE. - Collez le bloc Instructions depuis
workshops/build_workshop/app/librechat/sre-agent-definition.md. - Sélectionnez le modèle performant et capable d’utiliser des outils fourni par l’instance hébergée.
- Ajoutez les outils MCP
clickstacketgithub. - Enregistrez l’agent et demandez-lui
What can you investigate?
La réponse doit mentionner la télémétrie ClickStack et le code source
ClickHouse/ClickHouse_Demos/workshops/build_workshop/app.
Étape 4 — Provoquer une panne, puis enquêter
Injectez la panne de la carte et ne reconstruisez que l’application locale de l’atelier :
cd "$(git rev-parse --show-toplevel)/workshops/build_workshop/app"
git checkout fault/01-map-not-loading
docker compose --env-file .env.workshop \
-f docker-compose.workshop.yml -f docker-compose.otel.yml up -d --buildOuvrez l’application afin que le SDK du navigateur enregistre la panne. Dans LibreChat hébergé, demandez :
Users report UI errors. Use ClickStack telemetry and the GitHub source to find the root cause. Is this a code bug?L’agent doit relier l’erreur nyc-taxi-frontend à frontend/src/ui/ZoneMap.tsx et
présenter les preuves utilisées.
Vérification finale
- LibreChat est accessible par une URL cloud HTTPS fournie par le formateur ou créée en autonomie.
- L’agent a connecté les outils MCP distants
clickstacketgithub. - Son diagnostic cite à la fois la télémétrie et un fichier source de la branche de panne sélectionnée.
L’atelier actif se poursuit avec 07 Tester, provoquer une panne et réparer.