> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Graph Analysis

[Back to NLP Topics](https://koreai.mintlify.site/ai-for-service/automation/natural-language/nlp-topics.md)

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 |

> [!NOTE]
>
> 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. |

> [!NOTE]
>
> 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.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.