apunkt/ktx
1
0
Fork 0
mirror of https://github.com/Kaelio/ktx.git synced 2026-06-28 08:49:38 +02:00
Code Issues Projects Releases Packages Wiki Activity

docs(docs-site): add AI resources for agents

Browse source
This commit is contained in:
Luca Martial 2026-05-11 17:20:11 -07:00
parent 81c7e60fef
commit 966627a68b
13 changed files with 461 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

8
docs-site/content/docs/getting-started/introduction.mdx
View file

@ -39,6 +39,9 @@ If you've ever watched an agent confidently generate a query that joins on the w
<Card title="Quickstart" href="/docs/getting-started/quickstart">
Set up KTX and build your first context in under 10 minutes.
</Card>
<Card title="AI Resources" href="/docs/ai-resources">
Machine-readable docs, prompt recipes, and agent setup paths for coding assistants.
</Card>
<Card title="Concepts" href="/docs/concepts/the-context-layer">
Understand what a context layer is, why agents need one, and how KTX compares to other semantic layers.
</Card>
@ -56,6 +59,7 @@ If you've ever watched an agent confidently generate a query that joins on the w
## Next steps
- **Get hands-on** — follow the [Quickstart](/docs/getting-started/quickstart) to set up KTX with your own database in under 10 minutes.
- **Help a coding agent use the docs** — start with [AI Resources](/docs/ai-resources) or fetch [`/llms.txt`](/llms.txt).
- **Understand the theory** — read [The Context Layer](/docs/concepts/the-context-layer) to learn why schema access alone breaks on real analytics and how KTX addresses it.
## Agent usage notes
@ -64,9 +68,11 @@ Use this page as the high-level routing document for KTX docs.
| Agent task | Read next |
|------------|-----------|
| Discover machine-readable docs | [AI Resources](/docs/ai-resources) |
| Learn how a coding assistant should approach KTX | [Agent Quickstart](/docs/ai-resources/agent-quickstart) |
| Set up a new KTX project | [Quickstart](/docs/getting-started/quickstart) |
| Explain what problem KTX solves | [The Context Layer](/docs/concepts/the-context-layer) |
| Scan a database and ingest metadata | [Building Context](/docs/guides/building-context) |
| Edit semantic sources or knowledge pages | [Writing Context](/docs/guides/writing-context) |
| Connect KTX to an agent client | [Serving Agents](/docs/guides/serving-agents) |
| Connect KTX product tools to an agent client | [Serving Agents](/docs/guides/serving-agents) |
| Look up exact command flags | [CLI Reference](/docs/cli-reference/ktx-setup) |

2
docs-site/content/docs/getting-started/quickstart.mdx
View file

@ -5,6 +5,8 @@ description: Set up KTX and build your first context in under 10 minutes.
This guide walks you through `ktx setup` — an interactive wizard that configures your LLM provider, connects your database, optionally ingests from your existing tools, builds context, and installs agent integration.
If you are a coding assistant trying to decide how to read KTX docs or operate an existing project, start with the [Agent Quickstart](/docs/ai-resources/agent-quickstart). This page is the human setup walkthrough. Agent client integration details live in [Serving Agents](/docs/guides/serving-agents) and [Agent Clients](/docs/integrations/agent-clients).
## Workflow summary
Use this sequence when an agent needs to set up KTX from a fresh checkout: