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:Documentation Index
Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
- 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.
| 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 is not 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.