docs: update context build guides for unified ingest

This commit is contained in:
Andrey Avtomonov 2026-05-13 19:33:00 +02:00
parent f28e12da1d
commit 1d1db07a0c
3 changed files with 18 additions and 14 deletions

View file

@ -9,11 +9,12 @@ All context sources are configured in `ktx.yaml` under `connections` with their
## Ingestion workflow
Agents should configure and ingest context sources in this order:
Agents must configure and ingest context sources in this order:
1. Add the context source connection in `ktx.yaml` or with `ktx setup`.
2. Store tokens as `env:NAME` or `file:/path/to/secret`.
3. Run `ktx ingest run --connection-id <connectionId> --adapter <adapter>` for one source or `ktx ingest run --connection-id <id> --adapter <adapter>`.
3. Run `ktx ingest <connectionId>` for one source or `ktx ingest --all` for
every configured source.
4. Check progress with `ktx ingest status --json`.
5. Review generated `semantic-layer/` YAML and `wiki/` Markdown files in git.
6. Validate changed semantic sources with `ktx sl validate`.