Knowledge Graph Terminology

Back to NLP Topics

Reference for Knowledge Graph (KG) concepts. Applies to both Few-Shot and Ontology KG models unless noted. See Knowledge AI Introduction and Build a Knowledge Graph.

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.

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.

---

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.

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

---