จัดเก็บถาวรแล้ว: 06b AI SRE ด้วย LibreChat แบบโฮสต์
เอกสารอ้างอิงที่จัดเก็บถาวรของโมดูล LibreChat แบบโฮสต์ที่เคยเป็นตัวเลือก
โมดูลที่จัดเก็บถาวรแล้ว
โมดูล 06b ไม่ได้เป็นส่วนหนึ่งของเวิร์กช็อปแล้ว ห้ามจัดเตรียม LibreChat สำหรับ เส้นทางผู้เรียนปัจจุบัน ให้ไปต่อจาก 06 AI SRE ไปที่ 07 ทดสอบ ล้มเหลว และแก้ไข โดยตรง เนื้อหาด้านล่างยัง คงอยู่เพียงเพื่อเป็นเอกสารอ้างอิงทางประวัติศาสตร์
จุดเริ่มต้นในอดีต
เมื่อโมดูลนี้ยังใช้งานอยู่ ผู้เรียนอยู่บน build-workshop-v1 และตั้งงบเวลาประมาณ
15 นาที
ข้อกำหนดเบื้องต้น: โมดูล 05 เสร็จแล้ว ผู้สอนของคุณให้ URL ของ LibreChat แบบ HTTPS
และบัญชีมาแล้ว และคุณมี fine-grained GitHub token ที่มีสิทธิ์อ่านอย่างเดียวกับ
ClickHouse/ClickHouse_Demos ผู้เรียนที่เรียนด้วยตัวเองสามารถ deploy LibreChat ด้วย
คู่มือคลาวด์แบบคลิกเดียวบน Railway อย่างเป็นทางการของมันก่อน
เริ่มโมดูลนี้
โฮสต์บนคลาวด์เท่านั้น
ห้ามรัน LibreChat, MongoDB หรือฐานข้อมูลอื่นบนเครื่องเวิร์กช็อปของคุณ LibreChat
และการเก็บสถานะของมันรันในอินสแตนซ์ที่โฮสต์ไว้ callback ของ OAuth ต้องใช้ URL แบบ HTTPS
ของอินสแตนซ์นั้น ไม่ใช่ localhost เด็ดขาด
ทำไม
โมดูล 06 วาง agent ไว้ในเอดิเตอร์ของคุณ ที่นี่ SRE agent แบบแชทเป็นหลักจะสืบหาปัญหาใน สองระนาบระยะไกลพร้อมกัน: telemetry ของ ClickStack และซอร์สโค้ดสาธารณะของเวิร์กช็อปบน GitHub
ขั้นที่ 1 — ลงชื่อเข้าใช้ LibreChat แบบโฮสต์
เปิด URL แบบ HTTPS ที่ผู้สอนของคุณให้มาและลงชื่อเข้าใช้ด้วยบัญชีที่ได้รับมอบหมาย ผู้เรียนที่เรียนด้วยตัวเองใช้ URL สาธารณะของ Railway ที่สร้างขึ้นตอน deploy บนคลาวด์
ที่อยู่ของหน้าต้องเริ่มด้วย https:// ถ้ามันชี้ไป localhost ให้หยุดและใช้
URL แบบโฮสต์
ขั้นที่ 2 — เชื่อมต่อเซิร์ฟเวอร์ MCP ระยะไกล
เปิด MCP Settings ผู้สอนของคุณอาจแชร์นิยามเซิร์ฟเวอร์เหล่านี้ไว้แล้ว ถ้าไม่ ให้เพิ่มมันใน UI:
| ชื่อ | ประเภท | URL | การยืนยันตัวตน |
|---|---|---|---|
clickstack | Streamable HTTP | https://mcp.clickhouse.cloud/clickstack | Browser OAuth |
github | Streamable HTTP | https://api.githubcopilot.com/mcp/ | PAT แบบอ่านอย่างเดียวของคุณ |
สำหรับ clickstack ให้คัดลอก UUID จาก ClickStack Team Settings → Data →
Connections → Default → Service ID ไปใส่ในฟิลด์
CLICKSTACK_SERVICE_ID ต่อผู้ใช้ของ LibreChat ก่อน แล้วเลือก Connect และทำ OAuth ของ
ClickHouse Cloud ให้เสร็จ callback จะกลับไปที่ URL แบบ HTTPS ของ LibreChat ที่โฮสต์ไว้
สำหรับ github ให้ใส่ fine-grained PAT ของคุณเฉพาะในไดอะล็อกข้อมูลรับรองต่อผู้ใช้ของ
LibreChat จำกัดมันไว้ที่ ClickHouse/ClickHouse_Demos ด้วย Contents: read เปิดใช้
toolset แบบอ่านอย่างเดียว/repository ถ้าฟอร์มของเซิร์ฟเวอร์เปิดตัวควบคุมเหล่านั้น
เซิร์ฟเวอร์ทั้งสองต้องแสดง Connected ก่อนทำต่อ
ขั้นที่ 3 — สร้าง SRE agent
เปิด Agent Builder และสร้าง agent:
- ตั้งชื่อมันว่า
NYC Taxi Ops SRE - วางบล็อก Instructions จาก
workshops/build_workshop/app/librechat/sre-agent-definition.md - เลือกโมเดลที่แข็งแรงและใช้เครื่องมือได้ที่อินสแตนซ์แบบโฮสต์ให้มา
- เพิ่มเครื่องมือ MCP
clickstackและgithub - บันทึก agent และถาม
What can you investigate?
คำตอบควรกล่าวถึง telemetry ของ ClickStack และซอร์สโค้ด
ClickHouse/ClickHouse_Demos/workshops/build_workshop/app
ขั้นที่ 4 — ทำให้พังอะไรอย่างหนึ่ง แล้วสืบหาปัญหา
ฉีดความผิดพลาดของแผนที่เข้าไปและ build ใหม่เฉพาะแอปเวิร์กช็อปในเครื่อง:
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เปิดแอปเพื่อให้ browser 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 ผ่าน URL คลาวด์แบบ HTTPS ที่ผู้สอนให้มาหรือที่สร้างเองแบบเรียนด้วยตัวเอง
- agent เชื่อมต่อเครื่องมือ MCP
clickstackและgithubระยะไกลแล้ว - การวินิจฉัยของมันอ้างอิงทั้ง telemetry และไฟล์ซอร์สบน fault branch ที่เลือก
เวิร์กช็อปที่ใช้งานอยู่ดำเนินต่อที่ 07 ทดสอบ ล้มเหลว และแก้ไข