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

State	Description
Draft	Created but not yet published. No retrieval is possible. Ingestion can run to pre-load data.
Enabled	Published and active. Ingestion and retrieval are both available.

note

Disabled is not yet available for Knowledge Bases in Early Access. It is planned for a future update. The disabling behavior described below reflects the planned design. Archiving is not currently supported for Knowledge Bases; to permanently remove a Knowledge Base, delete it.

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.

Open Knowledge Hub, select the repository, then select the Knowledge Base.
Select the Actions menu (⋮).
Select Disable.
Confirm the action in the dialog.

The Knowledge Base state changes to Disabled. Scheduled ingestion runs do not execute while the KB is disabled.

To re-enable the Knowledge Base, select Actions > Enable. Scheduled ingestion resumes on the next scheduled interval.

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.

Open Knowledge Hub, select the repository, then select the Knowledge Base.
Select the trash can icon in the top-right corner.
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 action	Effect on attached Sources
Disable	Sources remain but no ingestion runs execute.
Enable	Sources resume on their scheduled interval.
Delete	All Sources and their configuration are permanently deleted.