Creating a Knowledge Base

note

Knowledge Hub is an Early Access release. Refer to the Early Access disclaimer for details.

A Knowledge Base (KB) is a searchable index of chunked and embedded content drawn from one or more Sources. When you create a KB, you provide a title and description; Knowledge Hub creates it in Draft state and assigns the embedding model automatically. You configure Sources, schema, and retrieval settings afterward from the Knowledge Base detail page. The KB becomes available for retrieval only after you publish it.

Before you begin

• You must have the Administrator or Developer role in Knowledge Hub.
• At least one Enabled repository must exist. Refer to Creating a repository.
• If you have not yet generated a platform token or set up your Data Integration connections, refer to Getting started with KH.

Procedure

1. Open Knowledge Hub and select the repository you want the Knowledge Base to belong to.

2. Select + Knowledge Base.

3. In the Create Knowledge Base dialog, enter a Knowledge Base Title (maximum 150 characters).

4. Enter a Description (maximum 1000 characters).

   The description is required. AI agents use it to identify and select the correct Knowledge Base for a task, so describe its content and intended use clearly.

5. Select Create Knowledge Base.

Knowledge Hub creates the Knowledge Base in Draft state and assigns the embedding model automatically. Refer to Configuring embedding settings for details. From the Knowledge Base detail page, use the Sources tab to connect data, the Schema tab to manage attributes, and the Retrieval tab to configure how agents search it.

Managing the Knowledge Base schema

The Schema tab holds the canonical schema for the Knowledge Base: the full set of attributes available across all Sources connected to it. When a Source completes its first ingestion run, Knowledge Hub adds that Source's mapped fields to the canonical schema automatically. Refer to Editing Source configuration for how Source-level field mapping works.

For each attribute, the tab shows:

Column	Description
Attribute Name	The canonical name of the attribute.
Description	An optional description of the attribute.
Data Type	The attribute's data type, for example, String.
Sources	The number of Sources that map to this attribute.

Adding an attribute manually

1. On the Schema tab, select + Attribute.
2. In the Add Knowledge Base Schema Attribute dialog, enter a Target Attribute Name.
3. Enter a Description (maximum 1000 characters).
4. Select a Data Type.
5. Select Add.
6. Select Refresh Table to update the table with the latest attributes from connected Sources.
7. Select Save and Publish to save your schema changes and publish the Knowledge Base in one step, or Cancel to discard changes.