Ktx: Uma Camada de Contexto Executável para Corrigir a Precisão do Agente de Dados

Ktx é uma camada de contexto executável de código aberto projetada para fazer com que agentes de IA como Claude Code, Codex, Cursor e OpenCode consultem seu data warehouse com precisão. Após construir agentes de dados de nível de produção para dezenas de empresas, a equipe da Kaelio descobriu que a precisão é o problema número um: os agentes geram SQL válido, mas muitas vezes incorreto devido a colunas desatualizadas, regras de negócio ocultas, fanout de joins e lógica de atribuição ausente.

Ktx divide o problema em duas partes:

• Contexto de negócio vai para páginas wiki em Markdown que são automaticamente ingeridas, organizadas, deduplicadas e sinalizadas por contradições.
• Definições consultáveis vão para arquivos YAML que definem tabelas, granularidade de linhas, joins, medidas, dimensões, filtros e grupos de filtros.

Quando um agente precisa de uma métrica, ele solicita ao ktx uma medida, dimensões e filtros em vez de escrever toda a consulta. O planejador do ktx escolhe o caminho do join, usa metadados de granularidade e relacionamento, detecta problemas como fanout de joins e chasm joins, e compila o SQL do warehouse enquanto também aproveita conhecimento não estruturado de documentos ingeridos.

Ktx integra-se com a maioria dos warehouses (BigQuery, Snowflake, Postgres, ClickHouse, MySQL, SQL Server, SQLite), ferramentas de modelagem (dbt, MetricFlow, LookML), ferramentas de BI (Looker, Metabase) e ferramentas de documentação como Notion.

Início Rápido

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

Após a configuração, ktx status mostra verificações de prontidão para LLM, embeddings, bancos de dados, fontes de contexto e integração com agentes.

Primeiros Comandos

ktx setup          # Criar, retomar ou atualizar um projeto ktx
ktx status         # Verificar prontidão do projeto
ktx ingest         # Construir contexto para cada conexão configurada
ktx sl "revenue"   # Pesquisar fontes semânticas
ktx wiki "refund policy"  # Pesquisar páginas wiki locais
ktx mcp start      # Iniciar o servidor MCP para clientes de agentes

Para usuários de agentes: execute npx skills add Kaelio/ktx --skill ktx no diretório do seu projeto para instalar e configurar o ktx via a skill.

Para Quem É

Use ktx se você quer que agentes como Claude Code ou Codex consultem seu warehouse com definições de métricas aprovadas, tem conhecimento de negócios espalhado entre dbt, Looker, Metabase e Notion, ou precisa que agentes reutilizem SQL canônico em vez de inventá-lo a cada prompt. Pule se você não tem um warehouse SQL ou precisa apenas de consultas pontuais.