Skip to main content

Creating and Managing Knowledge Stores

A Knowledge Store is a container of information that an assistant can reference when answering questions. Think of Knowledge Stores as a focused collection of information built for a specific use case.

When a user asks a question, the assistant does not search all available data. Instead, it looks only at the Knowledge Stores it has been configured to use. When creating a Knowledge Store, you define what data it will contain and who can use it.

Understanding the Knowledge Store Interface

Navigate to Management > AI Assistants >Knowledge Stores, and you will see a table of your existing Knowledge Stores. The table has three tabs, System, containing Knowledge Stores that the Data Studio has automatically created to support built-in features, SQL, containing Knowledge Stores designed for structured data from tables, and Document, containing Knowledge Stores designed for unstructured data. The details contained in each of the tabs of the table are as follows:

Name

The name of the Knowledge Store.

Status

Indicates whether the Knowledge Store is active and available for assistants to use.

Search Enabled

Indicates whether the Knowledge Store is currently available for search. If disabled, assistants will not use this Knowledge Store when responding to questions.

Description

The description provided at creation time, used to help determine when this Knowledge Store is relevant.

You can expand a Knowledge Store by clicking the + icon to view the following details about the Narratives associated with that Knowledge Store:

Total Items

The total number of items currently stored in the Knowledge Store.

Pending Items

The number of items that are waiting to be processed and added to the Knowledge Store.

Failed Items

The number of items that failed during processing. Click this field to show the error details, narrative template and SQL statement.

Processed /s

Displays the current processing rate (items per second), which helps you monitor ingestion performance.

Items up-to-date

Indicates what percentage of items in the Knowledge Store have been processed and are ready for search.

Time Remaining

Provides an estimate of how long it will take to finish processing any remaining items.

Filtering the Display

To filter the display, click the + icon to use the dropdown menus to filter for certain fields or look for keywords using the type-in boxes above the table.

Each individual field can also be filtered, either in alphabetic or reverse alphabetic order, by clicking the sort generated description: icon sort.svgicon.

Creating a Knowledge Store

When creating a Knowledge Store, you are defining a new collection of information that assistants can reference.

  1. Click the Management icon in the application menu.

  2. Under AI Assistants, click Knowledge Stores.

  3. Navigate to the tab for the data type you want to make a new Knowledge Store for.

  4. Click + New SQL Store or + New Document Store.

  5. Provide the following information on the Create Knowledge Store screen. Complete the following information:

    Knowledge Store Name

    Required— The unique name used to identify this Knowledge Store. It should be descriptive and concise.

    Knowledge Store Type

    Required—The type of Knowledge Store. SQL Based (Collection) or Document Based (Document Collection).

    Enabled

    Optional— Selecting this checkbox indicates that this Knowledge Store is active and available for users.

    User Roles

    Optional— Select one or more roles allowed to interact with this Knowledge Store.

    Description

    Optional—Describe the contents and topics of the Knowledge Store. Clear descriptions help the Assistant identify when the Knowledge Store is relevant and what information to use. A clearer and more detailed description will help Assistants use this Knowledge Store effectively.

    Embedding Model

    Required—The embedding model used for processing and storing data in this Knowledge Store. Choose an embedding model based on your retrieval needs:

    • text-embedding-3-small — Best for general vector search at scale. Faster and lower cost, with slightly lower precision.

    • text-embedding-3-large — Use for complex or high-stakes retrieval where meaning is subtle or requires inference. Higher accuracy and greater resource requirements.

    • text-embedding-ada-002 — Legacy option. Use only for backward compatibility with existing Ada embeddings.

  6. Once all the fields are completed, click Submit. The new Knowledge Store will appear on your Knowledge Store table.

The next step in this process is to Add Data to Your Knowledge Store.

Editing a Knowledge Store

  1. Click the Management icon in the application menu.

  2. Under AI Assistants, click Knowledge Stores.

  3. Click Edit Store.

  4. Modify the fields you would like to change.

  5. Click Submit.

Changes take effect for future data processing. Existing indexed data may need to be reprocessed depending on the fields modified.

Deleting a Knowledge Store

A Knowledge Store with the type Document Collection or Collection that has no Narratives associated with it can be deleted. System Knowledge Stores cannot be deleted. To do so:

  1. Click the Management icon in the application menu.

  2. Under AI Assistants, click Knowledge Stores.

  3. Click the Edit menu.

  4. From the menu, click Delete Store. A confirmation box appears.

  5. Click Delete.

Deleted Knowledge Stores cannot be recovered.

Disabling or Enabling a Knowledge Store

  1. Click the Management icon in the application menu.

  2. Under AI Assistants, click Knowledge Stores.

  3. Click the Edit menu.

  4. From the menu, click Disable to disable the Knowledge Store or Enable to re-enable it.

FeedbackOpens in a new tab