Knowledge and citations

Answers should come with sources. Azhi’s knowledge datasets give agents and retrieve nodes numbered citations to immutable excerpts, with an as-of time per source.

Workflow

npx azhi dataset create quality-guidelines
npx azhi dataset add quality-guidelines examples/quality-report/knowledge     # .md and .txt
npx azhi dataset publish quality-guidelines --tag approved
npx azhi dataset search quality-guidelines "flaky tests"
npx azhi dataset revoke quality-guidelines <document>                          # stop it being retrievable

Concept	Meaning
Publish	Chunks, embeds and publishes an immutable index revision
Tag	A workflow pins `quality-guidelines@approved`, not “whatever is latest”
Revoke	Stops a document being retrievable from every revision
Retrieval	Hybrid: full text (`tsvector`) plus vectors (`pgvector`)

An agent node takes datasets: [quality-guidelines@approved]. A retrieve node uses top_k to bound context.