Diarsipkan: 06b AI SRE dengan LibreChat terhosting

Modul diarsipkan

Modul 06b sudah bukan bagian dari workshop. Jangan menyediakan LibreChat untuk jalur learner saat ini. Lanjutkan langsung dari 06 AI SRE ke 07 Uji, gagalkan, dan perbaiki. Materi di bawah tetap tersedia hanya sebagai rujukan historis.

Titik awal historis

Ketika modul ini masih aktif, learner tetap di build-workshop-v1 dan menyiapkan sekitar 15 menit.

Prasyarat: Modul 05 selesai, instruktur Anda sudah menyediakan URL dan akun LibreChat HTTPS, dan Anda punya token GitHub fine-grained dengan akses hanya-baca ke ClickHouse/ClickHouse_Demos. Learner mandiri dapat men-deploy LibreChat dengan panduan cloud satu klik Railway resminya sebelum memulai modul ini.

Hanya dihosting di cloud

Jangan menjalankan LibreChat, MongoDB, atau database lain di mesin workshop Anda. LibreChat dan persistensinya berjalan di instans terhosting. Callback OAuth-nya harus memakai URL HTTPS instans tersebut, jangan pernah localhost.

Mengapa

Modul 06 menempatkan agent di editor Anda. Di sini sebuah agent SRE yang native-chat menyelidiki dua bidang jarak jauh sekaligus: telemetri ClickStack dan sumber workshop publik di GitHub.

Langkah 1 — Masuk ke LibreChat terhosting

Buka URL HTTPS yang disediakan instruktur Anda dan masuk dengan akun yang ditetapkan untuk Anda. Learner mandiri memakai URL Railway publik yang dibuat saat deployment cloud.

Alamat halamannya harus dimulai dengan https://. Jika mengarah ke localhost, berhenti dan gunakan URL terhostingnya.

Langkah 2 — Hubungkan server MCP jarak jauh

Buka MCP Settings. Instruktur Anda mungkin sudah membagikan definisi server ini; jika belum, tambahkan di UI:

Nama	Tipe	URL	Autentikasi
`clickstack`	Streamable HTTP	`https://mcp.clickhouse.cloud/clickstack`	Browser OAuth
`github`	Streamable HTTP	`https://api.githubcopilot.com/mcp/`	PAT hanya-baca Anda

Untuk clickstack, pertama salin UUID dari ClickStack Team Settings → Data → Connections → Default → Service ID ke kolom CLICKSTACK_SERVICE_ID per-pengguna di LibreChat. Lalu pilih Connect dan selesaikan OAuth ClickHouse Cloud. Callback-nya kembali ke URL HTTPS LibreChat terhosting.

Untuk github, berikan PAT fine-grained Anda hanya di dialog kredensial per-pengguna LibreChat. Batasi ke ClickHouse/ClickHouse_Demos dengan Contents: read. Aktifkan toolset read-only/repository jika form server-nya menampilkan kontrol tersebut.

Kedua server harus menampilkan Connected sebelum melanjutkan.

Langkah 3 — Buat agent SRE

Buka Agent Builder dan buat sebuah agent:

Beri nama NYC Taxi Ops SRE.
Tempel blok Instructions dari workshops/build_workshop/app/librechat/sre-agent-definition.md.
Pilih model kuat yang mendukung tool yang disediakan instans terhosting itu.
Tambahkan tool MCP clickstack dan github.
Simpan agent-nya dan tanyakan What can you investigate?

Jawabannya seharusnya menyebut telemetri ClickStack dan sumber ClickHouse/ClickHouse_Demos/workshops/build_workshop/app.

Langkah 4 — Rusak sesuatu, lalu selidiki

Suntikkan fault peta dan bangun ulang hanya aplikasi workshop lokal:

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

Buka aplikasinya agar SDK browser mencatat fault-nya. Di LibreChat terhosting, tanyakan:

Users report UI errors. Use ClickStack telemetry and the GitHub source to find the root cause. Is this a code bug?

Agent seharusnya menghubungkan error nyc-taxi-frontend ke frontend/src/ui/ZoneMap.tsx dan menunjukkan bukti yang dipakainya.

Pemeriksaan penyelesaian

LibreChat dijangkau melalui URL cloud HTTPS yang disediakan instruktur atau dibuat secara mandiri.
Agent sudah menghubungkan tool MCP jarak jauh clickstack dan github.
Diagnosisnya mengutip baik telemetri maupun sebuah berkas sumber di branch fault yang dipilih.

Workshop yang aktif berlanjut di 07 Uji, gagalkan, dan perbaiki.