Skip to main content
Feedback

Managing Knowledge Base lifecycle

note

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

After a Knowledge Base is published, you can disable or delete it as your needs change. Each action has a different effect on data retention and reversibility.

Knowledge Base states

StateDescription
DraftCreated but not yet published. No retrieval is possible. Ingestion can run to pre-load data.
EnabledPublished and active. Ingestion and retrieval are both available.
DisabledPaused. Ingestion and retrieval are both suspended. Indexed data is retained.

Archiving is not currently supported for Knowledge Bases; to permanently remove a Knowledge Base, delete it.

note

Disable and Enable are available only to Administrators and Developers. Viewers do not see these actions.

Disabling a Knowledge Base

Disabling suspends ingestion and retrieval without deleting any indexed data. Use this when you need to pause a Knowledge Base temporarily. Disable is available only for a published Knowledge Base in Enabled state; it does not show for a Draft Knowledge Base.

  1. Open Knowledge Hub, select the repository, then select the Knowledge Base.
  2. Select the Actions menu (⋮).
  3. Select Disable.
  4. In the confirmation dialog, review the message: "Disabling stops ingestion and blocks retrieval. Agents can't query this Knowledge Base. Your data stays intact." Select Disable to confirm.

On success, a confirmation message reads "Knowledge Base successfully disabled" and the General tab's State field updates to Disabled. If the action fails, the Knowledge Base keeps its prior state and an error message shows.

While Disabled, the Knowledge Base configuration screens stay editable, the same as in Draft state.

Enabling a Knowledge Base

  1. Open Knowledge Hub, select the repository, then select the Knowledge Base.
  2. Select the Actions menu (⋮).
  3. Select Enable.
  4. In the confirmation dialog, review the message: "Enabling resumes ingestion and retrieval. Agents can query this Knowledge Base again." Select Enable to confirm.

On success, a confirmation message reads "Knowledge Base successfully enabled" and the General tab's State field updates to Enabled. Scheduled ingestion resumes on the next scheduled interval.

note

Enable requires at least one active Source. Add and enable a Source first, then try Enable again.

Deleting a Knowledge Base

Deleting permanently removes the Knowledge Base record and all indexed data. This action cannot be undone.

warning

Deleting a Knowledge Base removes all vector data permanently. Confirm that no AI agents or applications are actively querying this Knowledge Base before deleting.

If the Knowledge Base is attached to an Agentstudio agent, detach it first. Deleting a Knowledge Base that is still attached to a production agent causes that agent to error at runtime. Refer to Connecting Knowledge Bases for how to detach a Knowledge Base in Agent Designer.

  1. Open Knowledge Hub, select the repository, then select the Knowledge Base.
  2. Select the trash can icon in the top-right corner.
  3. Confirm the deletion in the dialog that appears.

Data retention during disable

When a Knowledge Base is disabled:

  • All previously indexed chunks remain in the vector store.
  • No new ingestion runs execute.
  • Retrieval requests return an error indicating the Knowledge Base is unavailable.
  • When you re-enable the KB, retrieval resumes immediately against the retained data.

Effect on attached Sources

Knowledge Base actionEffect on attached Sources
DisableSources remain but no ingestion runs execute.
EnableSources resume on their scheduled interval.
DeleteAll Sources and their configuration are permanently deleted.
On this Page