アーカイブ: 06b ホスト型 LibreChat で学ぶ AI SRE

かつて任意モジュールだったホスト型 LibreChat のアーカイブ用リファレンスです。

アーカイブされたモジュール

モジュール 06b はワークショップの一部ではなくなりました。現在の受講者向けの経路では LibreChat をプロビジョニングしないでください。06 AI SRE から 07 テスト、故障、修復へ直接進んでください。以下の内容は歴史的なリファレンスとしてのみ残されています。

当時の開始時点

このモジュールが有効だった当時、受講者は build-workshop-v1 に留まり、約 15分 を見込んでいました。

前提条件: モジュール 05 が完了していること、講師から HTTPS の LibreChat の URL とアカウントが提供されていること、そして ClickHouse/ClickHouse_Demos への読み取り専用アクセスを持つ fine-grained な GitHub トークンがあること。自習の受講者は、このモジュールを始める前に公式の Railway ワンクリッククラウドガイドで LibreChat をデプロイできます。

クラウドホストのみ

LibreChat、MongoDB、その他のデータベースをワークショップのマシンで動かさないでください。 LibreChat とその永続化層は、ホストされたインスタンスで動きます。その OAuth のコールバックはそのインスタンスの HTTPS URL を使わなければならず、localhost は使えません。

なぜ

モジュール 06 ではエディターの中にエージェントを置きました。ここでは、チャットネイティブな SRE エージェントが2つのリモートな面を同時に調査します。ClickStack のテレメトリと、GitHub 上の公開ワークショップソースです。

ステップ 1 — ホスト型 LibreChat にサインインする

講師から提供された HTTPS の URL を開き、割り当てられたアカウントでサインインします。自習の受講者は、クラウドデプロイ時に作成した公開の Railway URL を使います。

ページのアドレスは https:// で始まっていなければなりません。localhost を指している場合は、そこで止めてホストされた URL を使ってください。

ステップ 2 — リモートの MCP サーバーを接続する

MCP Settings を開きます。講師がすでにこれらのサーバー定義を共有している場合もあります。そうでなければ、UI で追加してください。

名前	種別	URL	認証
`clickstack`	Streamable HTTP	`https://mcp.clickhouse.cloud/clickstack`	ブラウザ OAuth
`github`	Streamable HTTP	`https://api.githubcopilot.com/mcp/`	自分の読み取り専用 PAT

clickstack については、まず ClickStack の Team Settings → Data → Connections → Default → Service ID から UUID をコピーし、LibreChat のユーザーごとの CLICKSTACK_SERVICE_ID フィールドに入れます。次に Connect を選び、ClickHouse Cloud の OAuth を完了します。コールバックはホストされた LibreChat の HTTPS URL に戻ります。

github については、fine-grained な PAT を LibreChat のユーザーごとの認証情報ダイアログにのみ入力してください。Contents: read を付けて ClickHouse/ClickHouse_Demos に限定します。サーバーのフォームにそうしたコントロールがある場合は、読み取り専用／リポジトリのツールセットを有効にしてください。

次に進む前に、両方のサーバーが Connected と表示されている必要があります。

ステップ 3 — SRE エージェントを作成する

Agent Builder を開き、エージェントを作成します。

名前を NYC Taxi Ops SRE にします。
workshops/build_workshop/app/librechat/sre-agent-definition.md の Instructions ブロックを貼り付けます。
ホストされたインスタンスが提供する、ツール利用に強いモデルを選びます。
clickstack と github の MCP ツールを追加します。
エージェントを保存し、What can you investigate? と尋ねます。

回答では ClickStack のテレメトリと ClickHouse/ClickHouse_Demos/workshops/build_workshop/app のソースに言及するはずです。

ステップ 4 — 何かを壊してから調査する

マップの障害を注入し、ローカルのワークショップアプリだけを再ビルドします。

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

ブラウザの SDK が障害を記録するように、アプリを開きます。ホスト型 LibreChat で次のように尋ねます。

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

エージェントは nyc-taxi-frontend のエラーを frontend/src/ui/ZoneMap.tsx に結び付け、使った証拠を示すはずです。

完了チェック

講師から提供された、または自習でデプロイした HTTPS のクラウド URL で LibreChat にアクセスしている。
エージェントにリモートの clickstack と github の MCP ツールが接続されている。
その診断が、テレメトリと選んだ fault ブランチ上のソースファイルの両方を引用している。

現行のワークショップは 07 テスト、故障、修復から続きます。