用途:ktx 是一个自我改进的上下文层,用于让 AI 代理准确查询数据仓库。它从 dbt、LookML、Looker、Metabase、Notion 及原始数据仓库表摄取元数据,再通过 CLI 和 MCP 工具把上下文暴露给 AI 代理使用。
主要能力:从公司知识学习(摄取 wiki 内容、去重、标记矛盾);映射数据栈(抽样表、采集元数据、检测可连接列);构建语义层(通过连接图组合原始表与指标,处理 chasm 和 fan trap);服务代理(提供 CLI 与 MCP 工具,支持对 wiki 和语义层实体做语义搜索)。语义层与 wiki 均支持语义检索,并返回指标定义、度量、维度及其 SQL。
使用方式:可全局安装 npm install -g @kaelio/ktx,或项目本地安装 npm install --save-dev @kaelio/ktx;随后运行 ktx setup 向导配置 LLM、嵌入提供方、数据库连接与上下文来源,并构建初始上下文。常用命令包括 ktx status 查看状态、ktx ingest 构建上下文(支持 --connection 与 --force)、ktx sl "revenue" 搜索语义层、ktx wiki "refund policy" 搜索 wiki,以及 ktx mcp start 启动 MCP 服务器(可用 --project-dir 指定项目目录)。代理集成方面,Codex 会自动注册到 .codex/mcp.json,Cursor 需在 MCP 设置中添加 ktx 命令,Claude Code 可通过技能方式安装配置。也可从 TypeScript 调用 CLI,或通过 Python 的 ktx_sl 使用 SemanticLayerEngine 查询指标。
适用场景:需要让 AI 代理基于已批准的指标定义与业务知识查询数据仓库的团队;使用 dbt、Looker、Metabase、Notion 或多数据仓库(PostgreSQL、Snowflake、BigQuery、ClickHouse、MySQL、SQL Server、SQLite)的分析项目。
限制:ktx 仅使用只读操作,不写入数据仓库;需要配置 LLM 与嵌入提供方的 API 密钥;摄取耗时可通过 sample_limit、skip_tables 控制;语义搜索无结果时可执行 ktx ingest --force 重建嵌入;遥测可通过 KTX_TELEMETRY_DISABLED=1 或 ktx.yaml 关闭。费用、价格与具体效果资料暂未提供。