Asset states reference
Knowledge Hub is an Early Access release. Refer to the Early Access disclaimer for details.
This topic is a single reference for all state values across Repositories, Knowledge Bases, and Sources. Use it to understand what each state means and which transitions are allowed.
Repository states
| State | Ingestion | Retrieval | Knowledge Bases affected | Transition to |
|---|---|---|---|---|
| Enabled | Runs on schedule | Served | Active | Disabled |
| Disabled | Paused | Not served | All Knowledge Bases paused | Enabled |
Deleting a repository permanently removes it and all Knowledge Bases and Sources within it. This action cannot be undone.
Archiving is not currently supported for repositories; Delete is the only way to permanently remove one.
Knowledge Base states
| State | Ingestion | Retrieval | Transition to |
|---|---|---|---|
| Draft | Can run (Sources can be added and enabled) | Not served | Enabled (using Publish) |
| Enabled | Runs on schedule | Served | None currently. Use Delete to remove the Knowledge Base. |
You currently cannot disable or archive a Knowledge Base. However, when available, disabling a Knowledge Base will not change the state of its Sources but will halt ingestion runs.
A Knowledge Base in Draft state cannot serve retrieval queries even if ingestion has run. You must publish it to make it available to agents. Refer to Publishing Knowledge Base.
Source states
| State | Ingestion | Data retained | Transition to |
|---|---|---|---|
| Draft | Not started. Enabling required. | No data yet | Enabled (using Enable) |
| Enabled | Runs on configured schedule | Yes | Disabled |
| Disabled | Paused | Yes | Enabled |
Archiving is not currently supported for Sources; Remove is the only way to permanently delete one.
State dependency rules
The following rules govern how parent state affects child state:
- A Knowledge Base cannot serve retrieval if the parent Repository is Disabled.
- Deleting a Repository permanently removes all Knowledge Bases and Sources within it.
- Deleting a Knowledge Base permanently removes all Sources within it.
- Disabling a Repository does not permanently affect Knowledge Base or Source states. Re-enabling the Repository restores the previous state.
Allowed actions by state
Repository
| Action | Available in state |
|---|---|
| Create Knowledge Base | Enabled |
| Disable | Enabled |
| Enable | Disabled |
| Delete | Enabled, Disabled |
Knowledge Base
| Action | Available in state |
|---|---|
| Add Source | Draft, Enabled |
| Publish | Draft (requires at least one Enabled Source) |
| Delete | Draft, Enabled |
Source
| Action | Available in state |
|---|---|
| Enable | Draft, Disabled |
| Run now | Enabled |
| Edit | Draft, Enabled |
| Disable | Enabled |
| Remove | Any |
