Archivado: 06b SRE con IA mediante LibreChat alojado

Material del facilitador correspondiente a 06b SRE con IA mediante LibreChat alojado.

Tiempos históricos

Este módulo antes duraba unos 15 minutos, justo antes del módulo 07. El módulo 06 ya cubre el flujo de trabajo con ClickStack MCP remoto.

Preparación histórica en la nube

Los participantes no deben implementar LibreChat ni MongoDB localmente.

1. Antes del evento, implementa una instancia HTTPS de LibreChat mediante la guía de Railway con un solo clic, o utiliza una instancia alojada y aprobada por la organización.
2. Crea cuentas para los participantes o configura tu proveedor de identidad. Nunca compartas una contraseña predeterminada para el taller.
3. Configura un proveedor y un modelo de LLM compatibles con herramientas, guarda su clave de API solo en la implementación alojada y establece un límite de gasto para el taller.
4. Añade y comparte estas definiciones de MCP remoto:
   • clickstack → https://mcp.clickhouse.cloud/clickstack con CLICKSTACK_SERVICE_ID y OAuth por usuario.
   • github → https://api.githubcopilot.com/mcp/ con un PAT de alcance preciso por usuario, encabezados de solo lectura y el conjunto de herramientas del repositorio.
5. Monta o copia app/librechat/librechat.yaml si la implementación alojada se administra como código. No contiene ningún token compartido de los participantes.
6. Crea el agente de SRE a partir de app/librechat/sre-agent-definition.md y compártelo con los participantes como Viewer, o deja que lo creen durante el ejercicio.
7. Prueba con una cuenta de participante que no sea administradora: ejecuta una consulta de ClickStack MCP y una lectura del código fuente en GitHub con el modelo configurado. Ambas devoluciones de llamada deben regresar al dominio HTTPS alojado, no a localhost.

LibreChat documenta el OAuth de MCP remoto, las credenciales por usuario y el uso compartido de agentes en su guía de MCP y su guía de Agents.

Guion de presentación

• En el módulo 06 el agente está en el editor; 06b mostraba la misma cadena de pruebas en una interfaz de chat alojada.
• LibreChat es una interfaz cliente. ClickStack/HyperDX y la telemetría permanecen administrados en ClickHouse Cloud; GitHub sigue siendo el servicio que contiene la fuente de referencia.
• Cada participante controla su sesión OAuth de ClickHouse y su PAT de GitHub.

Fallos habituales

• La URL alojada no está disponible: omite este módulo archivado y continúa con el módulo 06. No improvises una implementación local con Docker durante el taller.
• OAuth regresa al host incorrecto: corrige DOMAIN_SERVER y DOMAIN_CLIENT públicos de LibreChat para que usen la URL HTTPS de la implementación y vuelve a conectarte.
• Servicio ClickStack incorrecto: sustituye CLICKSTACK_SERVICE_ID del participante por el UUID de su conexión de ClickStack y vuelve a conectarte.
• Errores de las herramientas de GitHub: sustituye el PAT del participante por un token de alcance preciso limitado a ClickHouse/ClickHouse_Demos, con Contents: read.
• No hay telemetría del fallo del navegador: abre la aplicación local después de inyectar el fallo para que el SDK del navegador lo registre.

Pasos de restablecimiento

• Revoca las conexiones MCP o el PAT del participante en el LibreChat alojado.
• Elimina las cuentas temporales de los participantes después del evento conforme a tu política de acceso.
• Restablece la aplicación local del taller con los pasos del módulo 07 para guardar cambios y cambiar de branch.
• Mantén actualizada la instancia alojada o desmonta el proyecto de Railway después del taller.