How it works · 5
VZB — how the National Knowledge Base is built
VZB (the PPPA National Knowledge Base) is a knowledge graph: state institutions, their functions, tasks and rights, statutes, laws and Cabinet regulations, and the links between them. Nobody edits the graph by hand. Every night it is rebuilt from VDE data by rules kept as code, and every link states where it came from.
What the National Knowledge Base is made of
Example: from a law to an institution
Why does the Central Statistical Bureau work the way it does? In the graph this can be traced in four steps, each a separate link with its own source:
- State Administration Structure Law contains article 16
- Article 16 establishes the statute of the Central Statistical Bureau — "Issued in accordance with …"
- the statute contains point 4.3 and the other points
- point 4.3 establishes a task that the Central Statistical Bureau performs
An AI agent finds the same chain with the okm_path tool and explains it with okm_explain. Open in the graph →
Evidence for every link
| Status | Meaning | May it be stated as fact? |
|---|---|---|
source | The link is in the source itself, e.g. a statute contains a point. | Yes, citing the source. |
derived | Obtained by a published mapping from source data, e.g. the kind of a point (function / task / right) or a law article read from a regulation's "Issued in accordance with …". | Yes, naming the mapping. |
proposed | Suggested by AI or a person; not checked. | No — only as a suggestion. |
confirmed | A suggestion checked and approved by the person responsible. | Yes, with the reviewer and date. |
rejected | A suggestion rejected; kept so it is not suggested again. | No. |
How the graph is built every night
- After the VDE load, VZB reads the mappings from the ProcessGit repository
VZB-as-Code(latest version) and records which version it used. - Each mapping is a file of SQL queries, run with read-only rights — a mapping cannot change data.
- New links get a recorded time. If a source no longer confirms a link, it is not deleted but marked as no longer confirmed. Confirmed and rejected links are kept as decided.
- When sources disagree, the record keeper wins (SSOT); the disagreement is recorded as a check result.
- After each build the whole graph is checked against the OKM specification: data schema and link rules (which object may be linked to which).
How it is used
People
Every object has a page vzb.pppa.lv/id/<VRI>; the knowledge graph with clusters and filters; search and overviews on the VZB start page.
AI agents
Tools okm_resolve, okm_neighbours, okm_path, okm_explain, okm_search in the VDZP MCP connection. Every answer comes with evidence; suggestions must not be presented as facts.
Current content
Loading…
| Objects | Count |
|---|
| Link | Status | Count |
|---|
| Mapping | Last build | Objects | Links | + / − links |
|---|
Status
VZB is a PPPA concept and an implementation of the country profile of OKM. It is not an official national knowledge base; the official source that every record points to always prevails.