AI SREClickHouse Workshops

アーカイブ済み: 06b ホスト型 LibreChat による AI SRE

かつてのオプションモジュールであるホスト型 LibreChat 版の、アーカイブ済みインストラクター向けリファレンス。

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

アーカイブ済みモジュール

モジュール 06b は現在の進行表には含まれていません。現行のワークショップでは、LibreChat、学習者アカウント、 その MCP 接続をプロビジョニングしないでください。モジュール 06 からそのまま モジュール 07 に進んでください。以下のノートは 過去の参考資料としてのみ残されています。

06b ホスト型 LibreChat による AI SRE に対応するファシリテーター用の手引きです。

当時のタイミング

このモジュールは以前、モジュール 07 の直前に約15分をかけていました。モジュール 06 が すでにリモート ClickStack MCP のワークフローを扱っています。

当時のクラウド事前準備

学習者が LibreChat や MongoDB をローカルにデプロイしてはいけません。

  1. イベント前に、公式の Railway ワンクリックガイド を使って HTTPS の LibreChat インスタンスを1つデプロイする。または組織が承認したホスト型インスタンスを使う。
  2. 学習者アカウントを作成するか、自分の ID プロバイダーを設定する。ワークショップ共通の デフォルトパスワードを共有しては絶対にいけない。
  3. ツール呼び出しに対応した LLM プロバイダーとモデルを設定し、その API キーはホスト型のデプロイ内にのみ保存し、 ワークショップ用の利用上限を設定する。
  4. 次のリモート MCP 定義を追加して共有する:
    • clickstack → https://mcp.clickhouse.cloud/clickstack。ユーザーごとの CLICKSTACK_SERVICE_ID と OAuth を使用。
    • github → https://api.githubcopilot.com/mcp/。ユーザーごとの fine-grained PAT、 読み取り専用のヘッダー、リポジトリのツールセットを使用。
  5. ホスト型のデプロイをコードとして管理している場合は、app/librechat/librechat.yaml を マウントまたはコピーする。共有の学習者トークンは含まれていない。
  6. app/librechat/sre-agent-definition.md から SRE エージェントを作成し、Viewer として学習者に共有する。 もしくは、演習中に学習者自身に作成させる。
  7. 管理者ではない学習者アカウントからテストする: 設定したモデルで ClickStack MCP のクエリを1つと、 GitHub のソース読み取りを1つ実行する。どちらのコールバックも localhost ではなく、ホスト型の HTTPS ドメインに戻ってこなければならない。

LibreChat は、リモート MCP の OAuth、ユーザーごとの認証情報、エージェントの共有について MCP ガイド と Agents ガイド に記載しています。

トークトラック

  • モジュール 06 はエディター内のエージェント。06b は同じ証拠の連鎖をホスト型のチャット UI で行うものだった。
  • LibreChat はクライアント側の面である。ClickStack/HyperDX とテレメトリーは ClickHouse Cloud で マネージドされたままであり、GitHub が真実のソースとなるサービスであり続ける。
  • 学習者はそれぞれ自分の ClickHouse OAuth セッションと GitHub PAT を持つ。

よくある失敗

  • ホストされた URL が利用できない: このアーカイブ済みモジュールをスキップしてモジュール 06 に進む。 ワークショップ中にローカルの Docker デプロイを即席で用意してはいけない。
  • OAuth が誤ったホストに戻る: LibreChat の公開設定である DOMAIN_SERVER と DOMAIN_CLIENT を HTTPS のデプロイ URL に修正し、再接続する。
  • ClickStack のサービスが違う: 学習者の CLICKSTACK_SERVICE_ID を、その学習者の ClickStack 接続の UUID に置き換えて再接続する。
  • GitHub ツールのエラー: 学習者の PAT を、ClickHouse/ClickHouse_Demos に限定した Contents: read の fine-grained トークンに置き換える。
  • ブラウザ側の障害テレメトリーがない: ブラウザ SDK が記録できるよう、障害を注入した後に ローカルのアプリを開く。

リセット手順

  • ホスト型 LibreChat で学習者の MCP 接続または PAT を失効させる。
  • イベント後、自組織のアクセスポリシーに従って一時的な学習者アカウントを削除する。
  • モジュール 07 の stash して switch する手順で、ローカルのワークショップアプリをリセットする。
  • ホスト型インスタンスにパッチを当て続けるか、ワークショップ後に Railway のプロジェクトを削除する。

このページの内容

当時のタイミング当時のクラウド事前準備トークトラックよくある失敗リセット手順
JA