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:
The name of the Knowledge Store.
Indicates whether the Knowledge Store is active and available for assistants to use.
Indicates whether the Knowledge Store is currently available for search. If disabled, assistants will not use this Knowledge Store when responding to questions.
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:
The total number of items currently stored in the Knowledge Store.
The number of items that are waiting to be processed and added to the Knowledge Store.
The number of items that failed during processing. Click this field to show the error details, narrative template and SQL statement.
Displays the current processing rate (items per second), which helps you monitor ingestion performance.
Indicates what percentage of items in the Knowledge Store have been processed and are ready for search.
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 icon.
Creating a Knowledge Store
When creating a Knowledge Store, you are defining a new collection of information that assistants can reference.
-
Click the Management icon in the application menu.
-
Under AI Assistants, click Knowledge Stores.
-
Navigate to the tab for the data type you want to make a new Knowledge Store for.
-
Click + New SQL Store or + New Document Store.
-
Provide the following information on the Create Knowledge Store screen. Complete the following information:
Knowledge Store NameRequired— The unique name used to identify this Knowledge Store. It should be descriptive and concise.
Knowledge Store TypeRequired—The type of Knowledge Store. SQL Based (Collection) or Document Based (Document Collection).
EnabledOptional— Selecting this checkbox indicates that this Knowledge Store is active and available for users.
User RolesOptional— Select one or more roles allowed to interact with this Knowledge Store.
DescriptionOptional—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 ModelRequired—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.
-
-
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
-
Click the Management icon in the application menu.
-
Under AI Assistants, click Knowledge Stores.
-
Click Edit Store.
-
Modify the fields you would like to change.
-
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:
-
Click the Management icon in the application menu.
-
Under AI Assistants, click Knowledge Stores.
-
Click the Edit menu.
-
From the menu, click Delete Store. A confirmation box appears.
-
Click Delete.
Deleted Knowledge Stores cannot be recovered.
Disabling or Enabling a Knowledge Store
-
Click the Management icon in the application menu.
-
Under AI Assistants, click Knowledge Stores.
-
Click the Edit menu.
-
From the menu, click Disable to disable the Knowledge Store or Enable to re-enable it.