AI SREClickHouse Workshops

Diarsipkan: 06b AI SRE dengan LibreChat ter-hosting

Referensi instruktur yang diarsipkan untuk modul LibreChat ter-hosting opsional yang dulu ada.

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

Modul diarsipkan

Modul 06b sudah bukan bagian dari run of show. Jangan menyiapkan LibreChat, akun pembelajar, atau koneksi MCP-nya untuk workshop yang berjalan saat ini. Lanjutkan langsung dari Modul 06 ke Modul 07. Catatan di bawah tetap ada hanya sebagai referensi historis.

Pendamping fasilitator untuk 06b AI SRE dengan LibreChat ter-hosting.

Waktu historis

Modul ini sebelumnya butuh sekitar 15 menit tepat sebelum Modul 07. Modul 06 sudah mencakup alur kerja remote ClickStack MCP.

Prework cloud historis

Pembelajar tidak boleh men-deploy LibreChat atau MongoDB secara lokal.

  1. Deploy satu instance LibreChat HTTPS sebelum acara memakai panduan one-click Railway resmi, atau gunakan instance ter-hosting yang disetujui organisasi.
  2. Buat akun pembelajar atau konfigurasikan identity provider Anda. Jangan pernah membagikan password workshop default.
  3. Konfigurasikan provider dan model LLM yang mampu memakai tool, simpan API key-nya hanya di deployment ter-hosting, dan terapkan batas belanja workshop.
  4. Tambahkan dan bagikan definisi remote MCP berikut:
    • clickstack → https://mcp.clickhouse.cloud/clickstack memakai CLICKSTACK_SERVICE_ID per pengguna dan OAuth.
    • github → https://api.githubcopilot.com/mcp/ memakai PAT fine-grained per pengguna, header read-only, dan toolset repository.
  5. Mount atau salin app/librechat/librechat.yaml jika deployment ter-hosting dikelola sebagai kode. File itu tidak memuat token pembelajar bersama.
  6. Buat agen SRE dari app/librechat/sre-agent-definition.md dan bagikan kepada pembelajar sebagai Viewer, atau biarkan pembelajar membuatnya selama latihan.
  7. Uji dari akun pembelajar non-admin: jalankan satu query ClickStack MCP dan satu pembacaan source GitHub dengan model yang dikonfigurasi. Kedua callback harus kembali ke domain HTTPS ter-hosting, bukan localhost.

LibreChat mendokumentasikan remote MCP OAuth, kredensial per pengguna, dan pembagian agen di panduan MCP dan panduan Agents mereka.

Alur pembicaraan

  • Modul 06 adalah agen di dalam editor; 06b adalah rantai bukti yang sama di UI chat ter-hosting.
  • LibreChat adalah permukaan klien. ClickStack/HyperDX dan telemetrinya tetap dikelola di ClickHouse Cloud; GitHub tetap menjadi service sumber kebenaran.
  • Setiap pembelajar memiliki sesi OAuth ClickHouse dan PAT GitHub mereka sendiri.

Kegagalan umum

  • URL ter-hosting tidak tersedia: lewati modul yang diarsipkan ini dan lanjutkan dengan Modul 06. Jangan berimprovisasi dengan deployment Docker lokal selama workshop.
  • OAuth kembali ke host yang salah: perbaiki DOMAIN_SERVER dan DOMAIN_CLIENT publik LibreChat ke URL deployment HTTPS, lalu hubungkan ulang.
  • Service ClickStack salah: ganti CLICKSTACK_SERVICE_ID pembelajar dengan UUID dari koneksi ClickStack mereka, lalu hubungkan ulang.
  • Error tool GitHub: ganti PAT pembelajar dengan token fine-grained yang dibatasi ke ClickHouse/ClickHouse_Demos, Contents: read.
  • Tidak ada telemetri fault dari browser: buka aplikasi lokal setelah menyuntikkan fault agar SDK browser merekamnya.

Langkah reset

  • Cabut koneksi MCP atau PAT pembelajar di LibreChat ter-hosting.
  • Hapus akun pembelajar sementara setelah acara sesuai kebijakan akses Anda.
  • Reset aplikasi workshop lokal dengan langkah stash-and-switch Modul 07.
  • Jaga instance ter-hosting tetap ter-patch atau bongkar project Railway setelah workshop.

Di halaman ini

ID