Ktx: Eine ausführbare Kontextschicht zur Korrektur der Datenagenten-Genauigkeit

Ktx ist eine quelloffene, ausführbare Kontextebene, die KI-Agenten wie Claude Code, Codex, Cursor und OpenCode dabei unterstützt, Ihr Data Warehouse präzise abzufragen. Nachdem das Team von Kaelio für Dutzende von Unternehmen produktionsreife Datenagenten entwickelt hat, stellte sich heraus, dass die Genauigkeit das Hauptproblem ist: Agenten generieren gültiges SQL, aber oft aufgrund veralteter Spalten, versteckter Geschäftsregeln, Join-Fanout und fehlender Zuordnungslogik fehlerhaft.

Ktx teilt das Problem in zwei Teile auf:

• Geschäftskontext wird in Markdown-Wiki-Seiten abgelegt, die automatisch aufgenommen, organisiert, dedupliziert und auf Widersprüche geprüft werden.
• Abfragbare Definitionen werden in YAML-Dateien definiert, die Tabellen, Zeilengranularität, Joins, Measures, Dimensionen, Filter und Filtergruppen enthalten.

Wenn ein Agent eine Metrik benötigt, fragt er ktx nach einem Measure, Dimensionen und Filtern, anstatt die gesamte Abfrage selbst zu schreiben. Der Planer von ktx wählt den Join-Pfad, nutzt Granularitäts- und Beziehungsmetadaten, erkennt Probleme wie Join-Fanout und Chasm-Joins und kompiliert das Warehouse-SQL, während er gleichzeitig unstrukturiertes Wissen aus aufgenommenen Dokumenten nutzt.

Ktx integriert sich mit den meisten Data Warehouses (BigQuery, Snowflake, Postgres, ClickHouse, MySQL, SQL Server, SQLite), Modellierungstools (dbt, MetricFlow, LookML), BI-Tools (Looker, Metabase) und Dokumentationstools wie Notion.

Schnellstart

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

Nach der Einrichtung zeigt ktx status Bereitschaftsprüfungen für LLM, Embeddings, Datenbanken, Kontextquellen und Agentenintegration an.

Erste Befehle

ktx setup          # Erstellen, fortsetzen oder aktualisieren eines ktx-Projekts
ktx status         # Überprüfen der Projektbereitschaft
ktx ingest         # Kontext für jede konfigurierte Verbindung erstellen
ktx sl "revenue"   # Durchsuchen semantischer Quellen
ktx wiki "refund policy"  # Durchsuchen lokaler Wiki-Seiten
ktx mcp start      # Starten des MCP-Servers für Agenten-Clients

Für Agenten-Nutzer: Führen Sie npx skills add Kaelio/ktx --skill ktx in Ihrem Projektverzeichnis aus, um ktx über das Skill zu installieren und zu konfigurieren.

Für wen es geeignet ist

Verwenden Sie ktx, wenn Agenten wie Claude Code oder Codex Ihr Data Warehouse mit genehmigten Metrikdefinitionen abfragen sollen, wenn Geschäftswissen über dbt, Looker, Metabase und Notion verteilt ist, oder wenn Agenten kanonisches SQL wiederverwenden sollen, anstatt es bei jeder Eingabe neu zu erfinden. Überspringen Sie es, wenn Sie kein SQL-Warehouse haben oder nur einmalige Ad-hoc-Abfragen benötigen.