Ktx: Исполняемый контекстный слой для исправления точности агентов данных

Ktx — это исполняемый контекстный слой с открытым исходным кодом, предназначенный для того, чтобы AI-агенты, такие как Claude Code, Codex, Cursor и OpenCode, могли точно обращаться к вашему хранилищу данных. Создав производственные агенты данных для десятков компаний, команда Kaelio выяснила, что точность — проблема №1: агенты генерируют валидный SQL, но он часто неверен из-за устаревших колонок, скрытых бизнес-правил, разветвления JOIN и отсутствия логики атрибуции.

Ktx разбивает проблему на две части:

• Бизнес-контекст помещается в вики-страницы Markdown, которые автоматически импортируются, систематизируются, дедублицируются и проверяются на противоречия.
• Запросные определения попадают в YAML-файлы, описывающие таблицы, гранулярность строк, JOINы, меры, измерения, фильтры и группы фильтров.

Когда агенту нужна метрика, он запрашивает у ktx меру, измерения и фильтры вместо написания всего запроса. Планировщик Ktx выбирает путь JOIN, использует метаданные гранулярности и связей, обнаруживает проблемы вроде разветвления JOIN и расщепляющих JOIN, компилирует 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"  # Поиск по локальным вики-страницам
ktx mcp start      # Запустить MCP-сервер для клиентов-агентов

Для пользователей агентов: выполните npx skills add Kaelio/ktx --skill ktx в директории проекта, чтобы установить и настроить ktx через скилл.

Для кого это

Используйте ktx, если хотите, чтобы такие агенты, как Claude Code или Codex, запрашивали ваше хранилище с утверждёнными определениями метрик, если бизнес-знания разбросаны по dbt, Looker, Metabase и Notion, или если нужно, чтобы агенты переиспользовали канонический SQL вместо создания его каждый раз. Пропустите, если у вас нет SQL-хранилища или нужны только разовые произвольные запросы.