Skip to main content
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

LevelDescription
Root NodeThe 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 NodeDirect children of the root. Recommended for high-level categories (e.g., departments, features).
Leaf NodeAny node at level 2 or deeper.
The KG engine does not use parent-child relationships when evaluating FAQ matches. All nodes are considered equally, regardless of position.

Node / Term Types

TypeBehavior
DefaultNo special path qualification. (Ontology KG only.)
MandatoryA path is shortlisted only if the user’s utterance contains this term or its synonyms.
OrganizerGroups 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

TypeScope
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 SynonymsApp-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:
TypeDescription
FAQQuestion-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.
TaskLinks 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 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.