Skip to main content
Feedback

Publishing a Knowledge Base

note

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

Publishing transitions a Knowledge Base from Draft to Enabled state, making it available for AI agents to query. You must meet specific preconditions before publishing.

Before you begin

The Knowledge Base must meet all of the following preconditions:

  • The Knowledge Base is in Draft state.
  • At least one Source is attached and in Enabled state.
  • At least one successful ingestion run has completed for an attached Source.

If a precondition is missing, the General tab displays a reminder, for example: "At least one enabled Source is required before publishing this Knowledge Base." Publishing returns a validation error until you resolve it.

Procedure

  1. Open Knowledge Hub, select the repository, then select the Knowledge Base you want to publish.

  2. On the Knowledge Base detail page, select Publish in the top-right corner.

  3. Review the confirmation dialog.

    The dialog shows the number of enabled Sources and the total indexed chunks available at publish time.

  4. Select Publish to confirm.

The Knowledge Base state changes to Enabled. AI agents can now query it using the retrieval API.

What publishing makes available

After you publish a Knowledge Base:

  • AI agents can submit retrieval requests against it using its Knowledge Base ID.
  • The Knowledge Base is available for retrieval queries.
  • The Knowledge Base appears in the AgentStudio Knowledge Base selector.

Validation errors at publish time

ErrorResolution
No enabled SourcesEnable at least one Source. Refer to Managing source lifecycle.
No completed ingestion runsWait for a successful ingestion run or trigger one manually. Refer to Viewing ingestion activity.
Knowledge Base is not in Draft stateOnly Knowledge Bases in Draft state can be published. If the KB is already Enabled, no action is needed.
On this Page