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

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

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

<Warning>
  The KG is limited to 20,000 nodes/terms and 50,000 FAQs.
</Warning>

***

## 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 (e.g., departments, features).                                                               |
| **Leaf Node**        | Any node at level 2 or deeper.                                                                                                                                  |

<Note>
  The KG engine does not use parent-child relationships when evaluating FAQ matches. All nodes are considered equally, regardless of position.
</Note>

### 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 are not 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](/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 are not 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.
</Note>

***