Ktx : Une couche de contexte exécutable pour corriger la précision des agents de données

Ktx est une couche de contexte exécutable open source conçue pour permettre aux agents d'IA comme Claude Code, Codex, Cursor et OpenCode d'interroger votre entrepôt de données avec précision. Après avoir conçu des agents de données de qualité production pour des dizaines d'entreprises, l'équipe de Kaelio a constaté que la précision est le problème numéro un : les agents génèrent du SQL valide, mais il est souvent incorrect en raison de colonnes obsolètes, de règles métier cachées, de fanouts de jointures et d'une logique d'attribution manquante.

Ktx divise le problème en deux parties :

• Contexte métier dans des pages wiki Markdown qui sont automatiquement ingérées, organisées, dédupliquées et signalées pour contradictions.
• Définitions interrogeables dans des fichiers YAML définissant les tables, la granularité des lignes, les jointures, les mesures, les dimensions, les filtres et les groupes de filtres.

Lorsqu'un agent a besoin d'une métrique, il demande à ktx une mesure, des dimensions et des filtres au lieu d'écrire toute la requête. Le planificateur de Ktx choisit le chemin de jointure, utilise les métadonnées de granularité et de relation, détecte les problèmes comme les fanouts de jointures et les jointures en abîme, et compile le SQL pour l'entrepôt tout en exploitant les connaissances non structurées issues des documents ingérés.

Ktx s'intègre avec la plupart des entrepôts (BigQuery, Snowflake, Postgres, ClickHouse, MySQL, SQL Server, SQLite), des outils de modélisation (dbt, MetricFlow, LookML), des outils BI (Looker, Metabase) et des outils de documentation comme Notion.

Démarrage rapide

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

Après l'installation, ktx status affiche les vérifications de préparation pour LLM, embeddings, bases de données, sources de contexte et intégration d'agent.

Premières commandes

ktx setup          # Créer, reprendre ou mettre à jour un projet ktx
ktx status         # Vérifier l'état de préparation du projet
ktx ingest         # Construire le contexte pour chaque connexion configurée
ktx sl "revenue"   # Rechercher dans les sources sémantiques
ktx wiki "refund policy"  # Rechercher dans les pages wiki locales
ktx mcp start      # Démarrer le serveur MCP pour les clients agents

Pour les utilisateurs d'agents : exécutez npx skills add Kaelio/ktx --skill ktx dans votre répertoire de projet pour installer et configurer ktx via la compétence.

À qui s'adresse-t-il ?

Utilisez ktx si vous voulez que des agents comme Claude Code ou Codex interrogent votre entrepôt avec des définitions de métriques approuvées, si vous avez des connaissances métier dispersées dans dbt, Looker, Metabase et Notion, ou si vous avez besoin que les agents réutilisent du SQL canonique plutôt que de l'inventer à chaque requête. Ignorez-le si vous n'avez pas d'entrepôt SQL ou si vous n'avez besoin que de requêtes ad-hoc ponctuelles.