Ktx: データエージェントの精度を向上させる実行可能コンテキストレイヤー

Ktxはオープンソースの実行可能コンテキストレイヤーで、Claude Code、Codex、Cursor、OpenCodeなどのAIエージェントがデータウェアハウスを正確にクエリできるように設計されています。Kaelioチームは、数十の企業向けに本番グレードのデータエージェントを構築した結果、精度が最大の課題であることを発見しました。エージェントは有効なSQLを生成しますが、古いカラム、隠れたビジネスルール、ジョインのファンアウト、欠落した属性ロジックなどにより、しばしば不正確になります。

Ktxはこの問題を2つに分割します:

• ビジネスコンテキストはMarkdownのWikiページに記述され、自動的に取り込み、整理、重複排除、矛盾のフラグ付けが行われます。
• クエリ可能な定義はYAMLファイルに記述され、テーブル、行の粒度、ジョイン、メジャー、ディメンション、フィルター、フィルターグループを定義します。

エージェントがメトリクスを必要とする場合、クエリ全体を記述する代わりに、ktxにメジャー、ディメンション、フィルターを要求します。Ktxのプランナーはジョインパスを選択し、粒度とリレーションシップのメタデータを使用し、ジョインのファンアウトやカズムジョインなどの問題を検出し、ウェアハウスSQLをコンパイルします。同時に、取り込まれたドキュメントからの非構造化知識も活用します。

Ktxはほとんどのウェアハウス（BigQuery、Snowflake、Postgres、ClickHouse、MySQL、SQL Server、SQLite）、モデリングツール（dbt、MetricFlow、LookML）、BIツール（Looker、Metabase）、Notionなどのドキュメントツールと統合します。

クイックスタート

npm install -g @kaelio/ktx
ktx setup
ktx status

セットアップ後、ktx statusでLLM、埋め込み、データベース、コンテキストソース、エージェント統合の準備状態を確認できます。

最初のコマンド

ktx setup          # ktxプロジェクトの作成、再開、更新
ktx status         # プロジェクトの準備状態を確認
ktx ingest         # 設定されたすべての接続のコンテキストを構築
ktx sl "revenue"   # セマンティックソースを検索
ktx wiki "refund policy"  # ローカルWikiページを検索
ktx mcp start      # エージェントクライアント用のMCPサーバーを起動

エージェントユーザー向け: プロジェクトディレクトリでnpx skills add Kaelio/ktx --skill ktxを実行すると、スキル経由でktxをインストールおよび設定できます。

対象ユーザー

次のような場合にktxを使用してください: Claude CodeやCodexなどのエージェントに承認済みメトリクス定義でウェアハウスをクエリさせたい、ビジネス知識がdbt、Looker、Metabase、Notionに分散している、エージェントに毎回新しいSQLを生成させる代わりに正規SQLを再利用させたい。SQLウェアハウスがない場合や、一回限りのアドホッククエリのみが必要な場合はスキップしてください。