Knowledge Graph Analysis

Back to NLP Topics

The KG Diagnosis tool identifies inefficiencies in your Knowledge Graph and suggests corrective actions. Use it to catch errors before they affect user experience.

To run an inspection:

• Go to your KG and click Inspect (in-development version only; requires at least one FAQ).
• After inspection, click Re-run to refresh or Export to download the report as JSON.

Report categories:

Category	Description	Display limit
Error	Incorrect graph definitions requiring immediate fixes.	All
Warning	Issues that, when fixed, improve intent detection.	50
Suggestion	Improvements for better KG organization.	10

Only the first 50 warnings and 10 suggestions are shown. Fix them and re-run to see the next set.

---

Report Fields — Ontology Knowledge Graph

Issue Type	Category	Details	Action
Patterns with invalid syntax	Error	Current path, pattern, error, question	Fix incorrect patterns for better FAQ detection.
Questions added to incorrect paths	Error	Question, path	Modify the path to include the terms in the question.
Long chain of terms with questions only at the last term	Suggestion	Question, path	Reduce path by removing unimportant terms or merging relevant ones.
Identical terms with a common ancestor	Suggestion	Common parent, child paths (largest repeated subtrees)	Move child terms above parent to avoid duplication.
Paths without any questions	Suggestion	Path	Remove the path if no questions will be added.
Redundant alternate questions	Suggestion	Question, alternate questions, path	Rephrase alternates for wider coverage.
Large number of questions at the root term	Suggestion	Question, path	Move questions to appropriate paths.
Unusually long paths	Warning	Path	Remove unnecessary terms or merge relevant ones.
Questions at root that can be moved to better paths	Warning	Question, current path, suggested path	Move the question to the suggested path.
Questions with common words not used as terms	Warning	Questions, path, suggested extension	Extend the current path using the suggested extension.
Questions that match multiple paths	Warning	Question, current path, other paths	Review paths to resolve potential ambiguity.
Identical sibling nodes	Warning	Path, identical term	Merge the identical terms.

---

Report Fields — Few-Shot Knowledge Graph

For Few-Shot KGs, path and keyword analysis isn’t applicable. Only the following are reported:

Issue Type	Category	Details	Action
Patterns with invalid syntax	Error	Current path, pattern, error, question	Fix incorrect patterns for better FAQ detection.
Paths without any questions	Suggestion	Path	Remove unused paths.
Redundant alternate questions	Suggestion	Question, alternate questions, path	Rephrase alternates for wider coverage.

Every inspection run updates: total checks count, error/warning/suggestion counts, and the full list of issues — reflecting any FAQs modified or added since the last run.

---