Đã lưu trữ: 06b AI SRE với LibreChat được host
Tài liệu tham chiếu đã lưu trữ cho module LibreChat được host tùy chọn trước đây.
Module đã lưu trữ
Module 06b không còn là một phần của workshop. Đừng cấp phát LibreChat cho lộ trình học viên hiện tại. Hãy tiếp tục trực tiếp từ 06 AI SRE tới 07 Kiểm thử, lỗi, và sửa. Nội dung bên dưới chỉ còn được giữ lại như một tài liệu tham chiếu lịch sử.
Điểm khởi đầu trong quá khứ
Khi module này còn hoạt động, học viên ở lại build-workshop-v1 và dự trù khoảng
15 phút.
Yêu cầu tiên quyết: Module 05 đã hoàn thành, người hướng dẫn của bạn đã cung cấp một URL LibreChat
dạng HTTPS cùng một tài khoản, và bạn có một token GitHub fine-grained với quyền chỉ đọc trên
ClickHouse/ClickHouse_Demos. Học viên tự học có thể triển khai LibreChat bằng
hướng dẫn cloud một cú nhấp trên Railway chính thức của nó trước khi
bắt đầu module này.
Chỉ host trên cloud
Đừng chạy LibreChat, MongoDB, hay một database khác trên máy workshop của bạn. LibreChat
và phần lưu trữ của nó chạy trong instance được host. Các callback OAuth của nó phải dùng URL HTTPS
của instance đó, không bao giờ dùng localhost.
Vì sao
Module 06 đặt agent vào editor của bạn. Ở đây một agent SRE kiểu chat sẽ điều tra hai mặt phẳng từ xa cùng lúc: telemetry ClickStack và mã nguồn công khai của workshop trên GitHub.
Bước 1 — Đăng nhập vào LibreChat được host
Hãy mở URL HTTPS do người hướng dẫn của bạn cung cấp và đăng nhập bằng tài khoản được gán cho bạn. Học viên tự học dùng URL Railway công khai đã tạo trong lúc triển khai lên cloud.
Địa chỉ trang phải bắt đầu bằng https://. Nếu nó trỏ tới localhost, hãy dừng lại và dùng
URL được host.
Bước 2 — Kết nối các MCP server từ xa
Hãy mở MCP Settings. Người hướng dẫn của bạn có thể đã chia sẻ các định nghĩa server này; nếu chưa, hãy thêm chúng trong UI:
| Tên | Loại | URL | Xác thực |
|---|---|---|---|
clickstack | Streamable HTTP | https://mcp.clickhouse.cloud/clickstack | Browser OAuth |
github | Streamable HTTP | https://api.githubcopilot.com/mcp/ | PAT chỉ đọc của bạn |
Với clickstack, trước tiên hãy copy UUID từ ClickStack Team Settings → Data →
Connections → Default → Service ID vào field CLICKSTACK_SERVICE_ID theo từng người dùng
của LibreChat. Sau đó chọn Connect và hoàn tất OAuth của ClickHouse Cloud.
Callback sẽ trở về URL HTTPS của LibreChat được host.
Với github, chỉ cung cấp PAT fine-grained của bạn trong hộp thoại thông tin đăng nhập theo từng
người dùng của LibreChat. Hãy giới hạn nó ở ClickHouse/ClickHouse_Demos với Contents: read. Hãy bật
toolset chỉ đọc/repository nếu form của server có phơi bày các control đó.
Cả hai server phải hiển thị Connected trước khi tiếp tục.
Bước 3 — Tạo agent SRE
Hãy mở Agent Builder và tạo một agent:
- Đặt tên nó là
NYC Taxi Ops SRE. - Dán khối Instructions từ
workshops/build_workshop/app/librechat/sre-agent-definition.md. - Chọn model mạnh có khả năng dùng tool mà instance được host cung cấp.
- Thêm các tool MCP
clickstackvàgithub. - Lưu agent và hỏi
What can you investigate?
Câu trả lời phải nhắc tới telemetry ClickStack và mã nguồn
ClickHouse/ClickHouse_Demos/workshops/build_workshop/app.
Bước 4 — Làm hỏng một thứ gì đó, rồi điều tra
Hãy tiêm lỗi bản đồ và chỉ build lại ứng dụng workshop chạy local:
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 --buildHãy mở ứng dụng để SDK trên browser ghi lại lỗi. Trong LibreChat được host, hãy hỏi:
Users report UI errors. Use ClickStack telemetry and the GitHub source to find the root cause. Is this a code bug?Agent sẽ nối lỗi nyc-taxi-frontend với
frontend/src/ui/ZoneMap.tsx và trình bày bằng chứng nó đã dùng.
Kiểm tra hoàn thành
- LibreChat được truy cập qua một URL cloud HTTPS do người hướng dẫn cung cấp hoặc do bạn tự triển khai.
- Agent đã kết nối các tool MCP từ xa
clickstackvàgithub. - Phần chẩn đoán của nó dẫn ra cả telemetry lẫn một file mã nguồn trên fault branch đã chọn.
Workshop đang hoạt động tiếp tục tại 07 Kiểm thử, lỗi, và sửa.