Ktx: Una Capa de Contexto Ejecutable para Corregir la Precisión del Agente de Datos

Ktx es una capa de contexto ejecutable de código abierto diseñada para que agentes de IA como Claude Code, Codex, Cursor y OpenCode consulten tu almacén de datos con precisión. Tras desarrollar agentes de datos de nivel productivo para docenas de empresas, el equipo de Kaelio descubrió que la precisión es el problema número uno: los agentes generan SQL válido pero a menudo incorrecto debido a columnas obsoletas, reglas de negocio ocultas, fanouts de joins y lógica de atribución faltante.

Ktx divide el problema en dos partes:

• Contexto de negocio se coloca en páginas wiki Markdown que se ingieren, organizan, deduplican y marcan por contradicciones automáticamente.
• Definiciones consultables se colocan en archivos YAML que definen tablas, granularidad de filas, joins, medidas, dimensiones, filtros y grupos de filtros.

Cuando un agente necesita una métrica, le pide a ktx una medida, dimensiones y filtros en lugar de escribir toda la consulta. El planificador de ktx elige la ruta de join, usa la granularidad y metadatos de relaciones, detecta problemas como fanout de joins y chasm joins, y compila el SQL del almacén aprovechando también conocimiento no estructurado de documentos ingeridos.

Ktx se integra con la mayoría de almacenes (BigQuery, Snowflake, Postgres, ClickHouse, MySQL, SQL Server, SQLite), herramientas de modelado (dbt, MetricFlow, LookML), herramientas de BI (Looker, Metabase) y herramientas de documentación como Notion.

Inicio rápido

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

Después de la configuración, ktx status muestra verificaciones de preparación para LLM, embeddings, bases de datos, fuentes de contexto e integración de agentes.

Primeros comandos

ktx setup          # Crear, reanudar o actualizar un proyecto ktx
ktx status         # Verificar preparación del proyecto
ktx ingest         # Construir contexto para cada conexión configurada
ktx sl "revenue"   # Buscar fuentes semánticas
ktx wiki "refund policy"  # Buscar páginas wiki locales
ktx mcp start      # Iniciar el servidor MCP para clientes agente

Para usuarios de agentes: ejecuta npx skills add Kaelio/ktx --skill ktx en el directorio de tu proyecto para instalar y configurar ktx mediante el skill.

Para quién es

Usa ktx si quieres que agentes como Claude Code o Codex consulten tu almacén con definiciones de métricas aprobadas, tienes conocimiento de negocio disperso en dbt, Looker, Metabase y Notion, o necesitas que los agentes reutilicen SQL canónico en lugar de inventarlo en cada consulta. Omítelo si no tienes un almacén SQL o solo necesitas consultas ad-hoc puntuales.