已归档：06b 使用托管 LibreChat 的 AI SRE
原先那个可选的托管 LibreChat 模块的归档参考资料。
已归档的模块
模块 06b 已不再是本课程的一部分。学习过程中无需部署 LibreChat。请直接从 06 AI SRE 继续到 07 测试、失败与修复。下面的内容仅作为 历史参考保留。
历史起点
当这个模块还在使用时，学员会留在 build-workshop-v1 上，并预留约
15 分钟。
前置条件：模块 05 已完成，你的讲师已提供一个 HTTPS 的 LibreChat URL 和账号，并且你有一个
对 ClickHouse/ClickHouse_Demos 具有只读权限的细粒度 GitHub token。自主学习的学员可以在
开始本模块之前，按照官方的
Railway 一键云部署指南 部署 LibreChat。
仅限云托管
不要在实训设备上运行 LibreChat、MongoDB 或其他数据库。LibreChat 及其持久化都运行在
托管实例中。它的 OAuth 回调必须使用那个实例的 HTTPS URL，绝不能用 localhost。
为什么
模块 06 把 agent 放进了你的编辑器。这里则是一个 chat 原生的 SRE agent，同时排查两个远程 平面：ClickStack 遥测数据和 GitHub 上公开的实训源码。
第 1 步：登录托管的 LibreChat
打开讲师提供的 HTTPS URL，并用分配给你的账号登录。 自主学习的学员使用云部署过程中创建的公开 Railway URL。
页面地址必须以 https:// 开头。如果它指向 localhost，请停下来并改用托管的 URL。
第 2 步：连接远程 MCP 服务器
打开 MCP Settings。你的讲师可能已经分享了这些服务器定义； 如果没有，就在界面中添加它们：
| 名称 | 类型 | URL | 认证方式 |
|---|---|---|---|
clickstack | Streamable HTTP | https://mcp.clickhouse.cloud/clickstack | 浏览器 OAuth |
github | Streamable HTTP | https://api.githubcopilot.com/mcp/ | 你的只读 PAT |
对于 clickstack，先把 ClickStack 中 Team Settings → Data →
Connections → Default → Service ID 的 UUID 复制到 LibreChat 的用户级
CLICKSTACK_SERVICE_ID 字段中。然后选择 Connect 并完成 ClickHouse Cloud
的 OAuth。回调会返回到托管的 LibreChat HTTPS URL。
对于 github，只在 LibreChat 的用户级凭据对话框中提供你的细粒度 PAT。把它限制到
ClickHouse/ClickHouse_Demos，权限为 Contents: read。如果服务器表单暴露了这些控制项，
请启用只读/仓库工具集。
两个服务器都必须显示 Connected 之后才能继续。
第 3 步：创建 SRE agent
打开 Agent Builder 并创建一个 agent：
- 把它命名为
NYC Taxi Ops SRE。 - 粘贴来自
workshops/build_workshop/app/librechat/sre-agent-definition.md的 Instructions 段落。 - 选择托管实例提供的、工具调用能力强的模型。
- 添加
clickstack和github这两个 MCP 工具。 - 保存这个 agent 并问它
What can you investigate?
答案里应该提到 ClickStack 遥测数据和
ClickHouse/ClickHouse_Demos/workshops/build_workshop/app 源码。
第 4 步：弄坏点东西，然后排查
注入地图故障，并只重新构建本地的实训应用：
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 --build打开应用，让浏览器 SDK 记录下这个故障。在托管的 LibreChat 中提问：
Users report UI errors. Use ClickStack telemetry and the GitHub source to find the root cause. Is this a code bug?agent 应该把 nyc-taxi-frontend 的错误关联到
frontend/src/ui/ZoneMap.tsx，并展示它所使用的证据。
完成检查
- LibreChat 是通过讲师提供的或自主部署的 HTTPS 云 URL 访问的。
- agent 已连接远程的
clickstack和githubMCP 工具。 - 它的诊断结论同时引用了遥测数据和所选故障分支上的某个源文件。
当前课程请继续学习 07 测试、失败与修复。