Archivado: 06b SRE con IA mediante LibreChat alojado
Referencia archivada del antiguo módulo opcional de LibreChat alojado.
Módulo archivado
El módulo 06b ya no forma parte del taller. No aprovisiones LibreChat para el recorrido actual del participante. Continúa directamente desde 06 SRE con IA hasta 07 Probar, fallar y corregir. El material siguiente se conserva únicamente como referencia histórica.
Punto de partida histórico
Cuando este módulo estaba activo, los participantes permanecían en build-workshop-v1 y reservaban unos
15 minutos.
Requisitos previos: módulo 05 completo, una URL HTTPS y una cuenta de LibreChat proporcionadas por el instructor,
y un token de GitHub de alcance preciso con acceso de solo lectura a
ClickHouse/ClickHouse_Demos. Quienes realicen el taller por su cuenta pueden implementar LibreChat mediante la
guía oficial de Railway con un clic antes de
iniciar este módulo.
Solo alojado en la nube
No ejecutes LibreChat, MongoDB ni otra base de datos en el equipo del taller. LibreChat
y su persistencia se ejecutan en la instancia alojada. Sus devoluciones de llamada OAuth deben usar la URL HTTPS
de esa instancia, nunca localhost.
Por qué
El módulo 06 colocó al agente en tu editor. Aquí, un agente de SRE nativo de chat investiga dos planos remotos a la vez: la telemetría de ClickStack y el código fuente público del taller en GitHub.
Paso 1: inicia sesión en LibreChat alojado
Abre la URL HTTPS proporcionada por el instructor e inicia sesión con la cuenta que se te haya asignado. Quienes realicen el taller por su cuenta usan la URL pública de Railway creada durante la implementación en la nube.
La dirección de la página debe empezar por https://. Si apunta a localhost, detente y usa
la URL alojada.
Paso 2: conecta los servidores MCP remotos
Abre MCP Settings. Es posible que el instructor ya haya compartido estas definiciones de servidor; si no, añádelas desde la interfaz:
| Nombre | Tipo | URL | Autenticación |
|---|---|---|---|
clickstack | Streamable HTTP | https://mcp.clickhouse.cloud/clickstack | Browser OAuth |
github | Streamable HTTP | https://api.githubcopilot.com/mcp/ | Tu PAT de solo lectura |
Para clickstack, copia primero el UUID de ClickStack Team Settings → Data →
Connections → Default → Service ID en el campo por usuario
CLICKSTACK_SERVICE_ID de LibreChat. Después, elige Connect y completa el OAuth de ClickHouse Cloud.
La devolución de llamada regresa a la URL HTTPS del LibreChat alojado.
Para github, introduce tu PAT de alcance preciso únicamente en el cuadro de credenciales por usuario
de LibreChat. Limítalo a ClickHouse/ClickHouse_Demos con Contents: read. Activa el
conjunto de herramientas de solo lectura o del repositorio si el formulario del servidor ofrece esos controles.
Ambos servidores deben mostrar Connected antes de continuar.
Paso 3: crea el agente de SRE
Abre Agent Builder y crea un agente:
- Llámalo
NYC Taxi Ops SRE. - Pega el bloque Instructions de
workshops/build_workshop/app/librechat/sre-agent-definition.md. - Selecciona el modelo potente y compatible con herramientas que ofrece la instancia alojada.
- Añade las herramientas MCP
clickstackygithub. - Guarda el agente y pregunta
What can you investigate?
La respuesta debe mencionar la telemetría de ClickStack y el código fuente de
ClickHouse/ClickHouse_Demos/workshops/build_workshop/app.
Paso 4: provoca un fallo e investígalo
Inyecta el fallo del mapa y recompila solo la aplicación local del taller:
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 --buildAbre la aplicación para que el SDK del navegador registre el fallo. En el LibreChat alojado, pregunta:
Users report UI errors. Use ClickStack telemetry and the GitHub source to find the root cause. Is this a code bug?El agente debe relacionar el error de nyc-taxi-frontend con
frontend/src/ui/ZoneMap.tsx y mostrar las pruebas utilizadas.
Comprobación final
- Se accede a LibreChat mediante una URL de nube HTTPS proporcionada por el instructor o creada por ti.
- El agente tiene conectadas las herramientas MCP remotas
clickstackygithub. - Su diagnóstico cita tanto la telemetría como un archivo de código fuente del branch de fallo elegido.
El taller actual continúa en 07 Probar, fallar y corregir.