> ## 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.

# Knowledge Graph Analysis

<Badge icon="arrow-left" color="gray">[Back to NLP Topics](/ai-for-service/automation/natural-language/nlp-topics)</Badge>

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.
</Note>

***

## 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.          |

<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.
</Note>

***