ClickHouse ユースケースシリーズ

勝者を決める。
コストを証明する。

90 分で自分のコンテストを走らせます — 6 つのモデルと 3 つのプロンプト戦略が、ClickHouse に対する SQL で実際のビジネス上の問いに答えます。採用は公開リーダーボードではなく、正解 1 件あたりのコストという証拠で決めます。

90 分 · 通しで18 構成を採点Langfuse は step 0 から$0 トライアルクレジット

公開リーダーボードではなく、 自分のコンテスト。

モデル選びはエージェントアプリケーションで最初に効く判断で、そして最も勘で決められがちな判断でもあります。高く見積もれば、タスクに必要のない能力にフロンティア価格を払い続けます。低く見積まれば、実際のワークロードで静かに間違える何かを出荷することになります。

だから、コンテストは自分で走らせます。6 つのモデルと 3 つのプロンプト戦略のグリッドが、正解が用意されたビジネス上の問いに、ライブの ClickHouse データセットに対して答えます。

採点はすべて 実行精度 — 正しそうな SQL ではなく、クエリが正しい結果を返したか — で行い、各構成は 正解 1 件あたりのコスト で順位付けします。それは自分のタスクにおける 1 ドルあたりの品質であり、議論に決着をつけられる唯一の数字です。

Langfuse はモジュール 00 から組み込まれていて、最後に付け足すものではありません。コンテストを experiments として実行し、コード評価器と LLM ジャッジで採点し、すべてのトレースを保存して、勝者を本番まで追い続けます。

持ち帰るもの

終わりに動いているもの、すべて。

自分の ClickHouse Cloud トライアル、自分の Langfuse プロジェクト、そして OpenRouter のキー 1 本で。

01

決着までやり切ったコンテスト

18 通りのモデル × プロンプト構成を、自分のゴールデン質問で採点し、正解 1 件あたりのコスト で順位付け。

02

Langfuse の experiments と評価器

正答性の評価器と LLM ジャッジ が、自分の Langfuse プロジェクトのサーバー側で全実行を採点。

03

説明できる採点

回答はキャッシュ済みのゴールデン 結果セット と比較 — 列の位置、浮動小数点の丸め、行集合の正規化まで見るので、たまたま正しそうに見えるクエリは通りません。

04

継続的改善のループ

レビュー済みの回答が新しいゴールデン質問になり、グリッドを再実行 — ループ全体が Langfuse でエンドツーエンドに 見えます。

05

本番で動く勝者

勝った構成が POST /ask の背後で稼働し、セッション単位でトレースされ、高評価/低評価が Langfuse のスコアとして書き戻されます。

+

リポジトリまるごと

ハーネス、エージェント、読み取り専用の SQL ガード、サービング API、アリーナ UI — 自分のデータ に向けて使えます。

行程 · ハンズオン約 90 分

5 つのステップを、順番に。

ひと続きの流れ: 証拠でモデルを選び、理解し、改善し、そして本番で見守ります。

  1. 00

    セットアップ

    20 分

    OpenRouter、ClickHouse Cloud、Langfuse を接続 — モデルを選ぶ前にトレースを配線し、アリーナのデータセットを投入します。

  2. 01

    ベースモデルを選ぶ

    20 分

    モデル × プロンプトのグリッドを Langfuse の experiments として実行し、正解 1 件あたりのコストで勝者を決めます。

  3. 02

    品質を測る

    15 分

    「勝った」で終わらせません: ティア別の精度、llm_judge のシグナル、そしてプロンプトから生成 SQL までの個別トレース。

  4. 03

    継続的に改善する

    20 分

    レビュー済みの回答をアノテーションキュー経由で新しいゴールデン質問に変え、それに対してグリッドを再実行します。

  5. 04

    本番へリリースする

    15 分

    勝った構成を実際の API の背後で提供し、本番のトレース、セッション、コスト、高評価/低評価のフィードバックを見ます。

既定は自習形式です。 どのモジュールにも開始チェックポイントがあり、自分で確認できる検証で終わるので、会場のペースに取り残される人は出ません。

参加する前に

対象者と、持ち物。

こんな方に 対象者

  • エージェント機能のモデルをこれから選ぶエンジニアとアーキテクト
  • 「なぜこのモデルなのか」 と聞かれて、根拠を示したい方
  • LLM の評価をこれから初めて立ち上げるチーム
  • SQL とターミナルに慣れていれば十分 — ML の知識は不要です

持ち物 前提条件

  • ノート PC 上の Python 3.11 と Node 18+
  • トライアルクレジットのある ClickHouse Cloud サービス
  • Langfuse Cloud のプロジェクト
  • OpenRouter の API キー — OpenAI 互換のエンドポイント 1 つがロスターの全モデルの窓口になるので、プロバイダーごとの認証情報を管理する必要はありません

進め方 形式

  • 5 モジュールすべて 100% ハンズオン — コマンドとクエリはすべてコピー&ペースト
  • 完全に自習可能。ファシリテーター向けに、各モジュールに対応した講師トラックもあります
  • 採点は 自分の Langfuse プロジェクトで走るので、証拠は自分の手元に残ります
  • ロスターは意図的に低コスト — NL→SQL にフロンティアモデルは要りません

コンテストを始めますか?

ClickHouse Cloud のトライアル、Langfuse のプロジェクト、OpenRouter のキーを持って参加してください。どのモデルを採用すべきか、正解 1 件あたりいくらかかるか、そして来四半期にもう一度それを証明する方法を持ち帰れます。

181 回の実行で採点されるモデル × プロンプト構成の数。
$0トライアルクレジットと低コストなロスターでセッション全体をカバー。
あなたのものハーネスは自分の問いに向けて使えます。
JA