AI SREClickHouse Workshops

เก็บเข้าคลัง: 06b AI SRE ด้วย LibreChat แบบโฮสต์

เอกสารอ้างอิงสำหรับผู้สอนที่เก็บเข้าคลังของโมดูล LibreChat แบบโฮสต์ที่เคยเป็นทางเลือก

Your computer
macOS terminal: Run workshop commands in Terminal using zsh or bash.

โมดูลที่เก็บเข้าคลัง

โมดูล 06b ไม่อยู่ในลำดับการดำเนินงานอีกต่อไป อย่า provision LibreChat, บัญชีผู้เรียน หรือการเชื่อมต่อ MCP ของมันสำหรับเวิร์กช็อปปัจจุบัน ให้ต่อจาก โมดูล 06 ไปที่ โมดูล 07 โดยตรง บันทึกด้านล่างเหลือไว้ เพื่อเป็นการอ้างอิงเชิงประวัติเท่านั้น

คู่มือประกอบของผู้ดำเนินเวิร์กช็อปสำหรับ 06b AI SRE ด้วย LibreChat แบบโฮสต์

เวลาในอดีต

โมดูลนี้เคยใช้เวลาประมาณ 15 นาที ก่อนโมดูล 07 ทันที ตัวโมดูล 06 ครอบคลุม workflow ของ remote ClickStack MCP อยู่แล้ว

งานเตรียมล่วงหน้าบนคลาวด์ในอดีต

ผู้เรียนต้องไม่ deploy LibreChat หรือ MongoDB ในเครื่อง

  1. Deploy LibreChat instance แบบ HTTPS หนึ่งตัวก่อนวันงานโดยใช้ คู่มือ Railway แบบคลิกเดียว อย่างเป็นทางการ หรือใช้ instance แบบโฮสต์ที่องค์กรอนุมัติแล้ว
  2. สร้างบัญชีผู้เรียนหรือตั้งค่า identity provider ของคุณ ห้ามแบ่งปันรหัสผ่านเวิร์กช็อป แบบค่าเริ่มต้น
  3. ตั้งค่า LLM provider และโมเดลที่รองรับการใช้เครื่องมือ เก็บ API key ของมันไว้ใน deployment ที่โฮสต์เท่านั้น และตั้งเพดานค่าใช้จ่ายสำหรับเวิร์กช็อป
  4. เพิ่มและแบ่งปันนิยาม MCP แบบ remote เหล่านี้:
    • clickstack → https://mcp.clickhouse.cloud/clickstack โดยใช้ CLICKSTACK_SERVICE_ID ต่อผู้ใช้ และ OAuth
    • github → https://api.githubcopilot.com/mcp/ โดยใช้ fine-grained PAT ต่อผู้ใช้, header แบบอ่านเท่านั้น และ toolset ของ repository
  5. Mount หรือคัดลอก app/librechat/librechat.yaml ถ้า deployment ที่โฮสต์ถูกจัดการแบบ code มันไม่มี token ของผู้เรียนที่ใช้ร่วมกัน
  6. สร้าง SRE agent จาก app/librechat/sre-agent-definition.md แล้วแบ่งปันกับ ผู้เรียนในสิทธิ์ Viewer หรือปล่อยให้ผู้เรียนสร้างเองระหว่างทำแบบฝึกหัด
  7. ทดสอบจากบัญชีผู้เรียนที่ไม่ใช่ admin: รัน ClickStack MCP query หนึ่งครั้งและอ่าน source ของ GitHub หนึ่งครั้งด้วยโมเดลที่ตั้งค่าไว้ callback ทั้งสองต้องกลับไปที่โดเมน HTTPS ที่โฮสต์ ไม่ใช่ localhost

LibreChat มีเอกสารเรื่อง remote MCP OAuth, credential ต่อผู้ใช้ และการแบ่งปัน agent ใน คู่มือ MCP และ คู่มือ Agents

แนวการบรรยาย

  • โมดูล 06 คือ agent ในตัวแก้ไขโค้ด ส่วน 06b คือห่วงโซ่หลักฐานเดียวกันใน chat UI แบบโฮสต์
  • LibreChat เป็นแค่พื้นผิวฝั่ง client ตัว ClickStack/HyperDX และ telemetry ยังถูกจัดการใน ClickHouse Cloud และ GitHub ยังเป็น service ที่เป็นแหล่งความจริง
  • ผู้เรียนแต่ละคนเป็นเจ้าของ session OAuth ของ ClickHouse และ GitHub PAT ของตนเอง

ปัญหาที่พบบ่อย

  • URL ที่โฮสต์ใช้งานไม่ได้: ข้ามโมดูลที่เก็บเข้าคลังนี้แล้วดำเนินต่อด้วยโมดูล 06 อย่าเลี่ยงไป deploy บน Docker ในเครื่องแบบเฉพาะหน้าระหว่างเวิร์กช็อป
  • OAuth กลับไปที่ host ผิด: แก้ค่าสาธารณะ DOMAIN_SERVER และ DOMAIN_CLIENT ของ LibreChat ให้เป็น URL ของ deployment แบบ HTTPS แล้วเชื่อมต่อใหม่
  • ClickStack service ผิดตัว: แทนที่ CLICKSTACK_SERVICE_ID ของผู้เรียนด้วย UUID จากการเชื่อมต่อ ClickStack ของเขา แล้วเชื่อมต่อใหม่
  • เครื่องมือ GitHub เกิด error: แทนที่ PAT ของผู้เรียนด้วย fine-grained token ที่จำกัด ไว้เฉพาะ ClickHouse/ClickHouse_Demos, Contents: read
  • ไม่มี telemetry ของ fault จากเบราว์เซอร์: เปิดแอปในเครื่องหลังจากใส่ fault เข้าไป เพื่อให้ browser SDK บันทึกมันไว้

ขั้นตอนรีเซ็ต

  • เพิกถอนการเชื่อมต่อ MCP หรือ PAT ของผู้เรียนใน LibreChat แบบโฮสต์
  • ลบบัญชีผู้เรียนชั่วคราวหลังจบงานตามนโยบายการเข้าถึงของคุณ
  • รีเซ็ตแอปเวิร์กช็อปในเครื่องด้วยขั้นตอน stash-and-switch ของโมดูล 07
  • คง instance ที่โฮสต์ให้ patch อยู่เสมอ หรือรื้อโปรเจกต์ Railway ทิ้งหลังจบเวิร์กช็อป

ในหน้านี้

เวลาในอดีตงานเตรียมล่วงหน้าบนคลาวด์ในอดีตแนวการบรรยายปัญหาที่พบบ่อยขั้นตอนรีเซ็ต
TH