ktx 是一个自改进的上下文层,用于教 AI 智能体准确查询数据仓库。它从数据库、dbt、LookML、Looker、Metabase、Notion 摄取并组织元数据与知识,构建带已批准指标定义的语义层,再通过 CLI 与 MCP 暴露给智能体执行。
主要能力:学习公司知识(摄取 wiki 内容、去重、标记矛盾);映射数据栈(采样表、捕获元数据、检测可连接列);构建语义层(以连接图组合原始表与指标,解决 fan/chasm 陷阱);以 CLI 和 MCP 工具提供跨 wiki 与语义层实体的语义搜索。
安装:全局 npm install -g @kaelio/ktx;项目内 npm install --save-dev @kaelio/ktx 后运行 npx ktx setup;作为 MCP 技能可运行 npx skills add Kaelio/ktx --skill ktx。
常用命令:ktx setup 创建或恢复项目,ktx status 检查就绪状态,ktx ingest 构建上下文,ktx sl "revenue" 搜索语义层,ktx wiki "refund policy" 搜索 wiki,ktx mcp start 启动 MCP 服务,ktx query 与 ktx raw-query 执行查询。
配置:项目含 ktx.yaml、semantic-layer/、wiki/、raw-sources/ 与本地 .ktx/。支持 PostgreSQL、Snowflake、BigQuery、ClickHouse、MySQL、SQL Server、SQLite 等连接器,以及 dbt、Looker、LookML、Metabase、Notion 等上下文源。密钥可放 .ktx/secrets.yaml 或环境变量(如 KTX_ANTHROPIC_API_KEY、KTX_OPENAI_API_KEY)。
适用场景:让智能体复用已批准的指标定义和规范业务逻辑,从分散来源获取统一上下文,而不是每次自行编写 SQL。
限制:ktx 对数据库只读;建议使用 SELECT 权限账号。需配置 LLM 与嵌入模型。遥测可通过 KTX_TELEMETRY_DISABLED=1 或 ktx.yaml 中 telemetry.enabled: false 关闭。具体定价、平台与效果资料暂未提供。