Skip to main content
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:
CategoryDescriptionDisplay limit
ErrorIncorrect graph definitions requiring immediate fixes.All
WarningIssues that, when fixed, improve intent detection.50
SuggestionImprovements 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 TypeCategoryDetailsAction
Patterns with invalid syntaxErrorCurrent path, pattern, error, questionFix incorrect patterns for better FAQ detection.
Questions added to incorrect pathsErrorQuestion, pathModify the path to include the terms in the question.
Long chain of terms with questions only at the last termSuggestionQuestion, pathReduce path by removing unimportant terms or merging relevant ones.
Identical terms with a common ancestorSuggestionCommon parent, child paths (largest repeated subtrees)Move child terms above parent to avoid duplication.
Paths without any questionsSuggestionPathRemove the path if no questions will be added.
Redundant alternate questionsSuggestionQuestion, alternate questions, pathRephrase alternates for wider coverage.
Large number of questions at the root termSuggestionQuestion, pathMove questions to appropriate paths.
Unusually long pathsWarningPathRemove unnecessary terms or merge relevant ones.
Questions at root that can be moved to better pathsWarningQuestion, current path, suggested pathMove the question to the suggested path.
Questions with common words not used as termsWarningQuestions, path, suggested extensionExtend the current path using the suggested extension.
Questions that match multiple pathsWarningQuestion, current path, other pathsReview paths to resolve potential ambiguity.
Identical sibling nodesWarningPath, identical termMerge the identical terms.

​
Report Fields — Few-Shot Knowledge Graph

For Few-Shot KGs, path and keyword analysis is not applicable. Only the following are reported:
Issue TypeCategoryDetailsAction
Patterns with invalid syntaxErrorCurrent path, pattern, error, questionFix incorrect patterns for better FAQ detection.
Paths without any questionsSuggestionPathRemove unused paths.
Redundant alternate questionsSuggestionQuestion, alternate questions, pathRephrase 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.