Đã lưu trữ: 06b AI SRE với LibreChat được host

Tài liệu đồng hành của người điều phối cho 06b AI SRE với LibreChat được host.

Thời lượng trước đây

Module này trước đây mất khoảng 15 phút, ngay trước Module 07. Module 06 đã bao gồm quy trình làm việc với ClickStack MCP từ xa.

Chuẩn bị trước trên cloud trước đây

Học viên không được triển khai LibreChat hay MongoDB cục bộ.

1. Triển khai một instance LibreChat qua HTTPS trước sự kiện, dùng hướng dẫn một cú nhấn trên Railway chính thức, hoặc dùng một instance được host đã được tổ chức phê duyệt.
2. Tạo tài khoản cho học viên hoặc cấu hình nhà cung cấp danh tính của bạn. Tuyệt đối không chia sẻ một mật khẩu workshop mặc định.
3. Cấu hình một nhà cung cấp LLM và model có khả năng dùng tool, chỉ lưu khoá API của nó trong bản triển khai được host, và áp một mức giới hạn chi tiêu cho workshop.
4. Thêm và chia sẻ các định nghĩa MCP từ xa sau:
   • clickstack → https://mcp.clickhouse.cloud/clickstack dùng CLICKSTACK_SERVICE_ID riêng theo từng người dùng và OAuth.
   • github → https://api.githubcopilot.com/mcp/ dùng một PAT fine-grained riêng theo từng người dùng, header chỉ đọc, và toolset repository.
5. Mount hoặc copy app/librechat/librechat.yaml nếu bản triển khai được host được quản lý dưới dạng code. File này không chứa token dùng chung nào của học viên.
6. Tạo SRE agent từ app/librechat/sre-agent-definition.md và chia sẻ nó với học viên ở quyền Viewer, hoặc để học viên tự tạo nó trong lúc làm bài.
7. Kiểm thử từ một tài khoản học viên không phải admin: chạy một truy vấn ClickStack MCP và một lượt đọc nguồn từ GitHub với model đã cấu hình. Cả hai callback phải trở về đúng domain HTTPS được host, không phải localhost.

LibreChat tài liệu hoá MCP OAuth từ xa, thông tin đăng nhập riêng theo từng người dùng và việc chia sẻ agent trong hướng dẫn MCP và hướng dẫn Agents.

Nội dung dẫn giảng

• Module 06 là một agent trong editor; 06b là cùng một chuỗi bằng chứng đó nhưng trong giao diện chat được host.
• LibreChat là một bề mặt client. ClickStack/HyperDX và telemetry vẫn được quản lý trong ClickHouse Cloud; GitHub vẫn là service nguồn-của-sự-thật.
• Mỗi học viên sở hữu phiên ClickHouse OAuth và PAT GitHub của riêng mình.

Lỗi thường gặp

• URL được host không truy cập được: hãy bỏ qua module đã lưu trữ này và tiếp tục với Module 06. Đừng tuỳ hứng triển khai một bản Docker cục bộ trong lúc đang chạy workshop.
• OAuth trở về sai host: hãy sửa DOMAIN_SERVER và DOMAIN_CLIENT công khai của LibreChat thành URL triển khai HTTPS, rồi kết nối lại.
• Sai ClickStack service: hãy thay CLICKSTACK_SERVICE_ID của học viên bằng UUID lấy từ kết nối ClickStack của họ, rồi kết nối lại.
• Lỗi công cụ GitHub: hãy thay PAT của học viên bằng một token fine-grained bị hạn chế chỉ trong ClickHouse/ClickHouse_Demos, Contents: read.
• Không có telemetry lỗi từ trình duyệt: hãy mở ứng dụng cục bộ sau khi tiêm lỗi để SDK phía trình duyệt ghi lại nó.

Các bước khôi phục

• Thu hồi các kết nối MCP hoặc PAT của học viên trong bản LibreChat được host.
• Xoá các tài khoản học viên tạm thời sau sự kiện theo chính sách truy cập của bạn.
• Khôi phục ứng dụng workshop cục bộ bằng các bước stash-and-switch của Module 07.
• Hãy giữ instance được host luôn được vá lỗi, hoặc dỡ bỏ project Railway sau workshop.