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

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

Reference for Knowledge Graph (KG) concepts. Applies to both Few-Shot and Ontology KG models unless noted. See [Knowledge AI Introduction](https://koreai.mintlify.site/ai-for-service/automation/knowledge-ai/knowledge-ai-introduction) and [Build a Knowledge Graph](https://koreai.mintlify.site/ai-for-service/automation/knowledge-ai/build-a-knowledge-graph).

> [!WARNING]
>
> The KG is limited to 20,000 nodes/terms and 50,000 FAQs.

***

## Terms / Nodes

Terms (nodes) are the structural building blocks of an ontology. They define domain concepts and are organized hierarchically.

### Node Hierarchy

| Level | Description |
| - | - |
| **Root Node** | The single top-level node. Named after the AI Agent by default (editable). Not used for path qualification in Ontology KGs. Max 100 FAQs at root (Ontology KG). |
| **First-Level Node** | Direct children of the root. Recommended for high-level categories (for example, departments, features). |
| **Leaf Node** | Any node at level 2 or deeper. |

> [!NOTE]
>
> The KG engine doesn't use parent-child relationships when evaluating FAQ matches. All nodes are considered equally, regardless of position.

### Node / Term Types

| Type | Behavior |
| - | - |
| **Default** | No special path qualification. (Ontology KG only.) |
| **Mandatory** | A path is shortlisted only if the user's utterance contains this term or its synonyms. |
| **Organizer** | Groups related child nodes. Qualifies FAQs even when the term is absent from the utterance. |

***

## Tags

Tags work like terms but aren't shown in the KG ontology view (avoids clutter). You can add synonyms and traits to tags, just like terms.

***

## Synonyms

Synonyms expand the set of words that can match a term, reducing the need for training with alternative questions.

### Synonym Types

| Type | Scope |
| - | - |
| **Path-Level Synonyms** (local) | Apply only in the specific path where the term appears. |
| **Knowledge Graph Synonyms** (global) | Apply wherever the term appears across the entire ontology. |
| **Bot Synonyms** | App-level synonyms reused inside the KG engine for path qualification and question matching. |

***

## Traits

A trait is a collection of user utterances that characterize the nature of a query. Traits are applied to terms across the ontology to filter irrelevant suggestions.

* If the user's utterance matches a trait, the assistant searches only the nodes associated with that trait.
* Nodes without the matching trait are ignored.

See [Traits](https://koreai.mintlify.site/ai-for-service/automation/natural-language/training/traits).

***

## Intents

Each FAQ node can contain two types of intents:

| Type | Description |
| - | - |
| **FAQ** | Question-answer pairs. Add alternate questions to cover different phrasings. Precede an alternate question with `\|\|` to define it as a pattern. Max 50,000 FAQs total. |
| **Task** | Links to a Dialog Task. Use for FAQs that require multi-turn or complex conversations. |

> [!NOTE]
>
> * For Few-Shot KGs, you can add all FAQs directly to the root node (no ontology required).
> * Default terms aren't available in Few-Shot KGs, except when migrating from an Ontology KG (existing Default terms remain until edited, then become Organizer terms).
> * Path-Level Synonyms are supported only for Mandatory Terms and Tags.

***


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