Docs
Contents

Knowledge Base Settings

Knowledge base settings let you inspect basic information, adjust document processing and retrieval defaults, manage lexicon bindings, and perform operations such as rebuilding and deletion. What you can edit depends on account permissions, knowledge base state, and version-management configuration.

Knowledge base settings and document processing: workflow diagram, not a runtime screenshot

This is a workflow diagram, not a runtime screenshot; actual options and results depend on your environment.

View the full-size diagram

View and edit settings

  1. In the target project, open Knowledge base, select the knowledge base, and open Settings. The page shows its name, description, embedding model and dimensions, parser configuration, and index information.

  2. With write access, select Edit and adjust the name, description, shared indexing model, parsing and chunking, retrieval defaults, or ingestion tracing as needed. Before saving, confirm that selected models and providers are available to the project.

  3. With version management enabled, changes to document processing or the shared indexing model may require a writable draft version. If the page indicates that documents require rebuilding, review the processing cost first, follow the prompt, and check job status.

The embedding model and dimensions are displayed as fixed values on the settings page. Do not assume that changing other settings automatically changes the existing vector space or immediately applies new settings to every document.

Document parsing and chunking

The settings form distinguishes the document parser from the chunking strategy:

After changing document processing settings, follow the rebuild guidance and inspect job status. Rebuilding, ingestion, and retrieval verification are separate steps: wait for the relevant jobs to finish, then inspect document status and search results.

Retrieval, tracing, and lexicons

The form exposes retrieval defaults including similarityThreshold, vectorWeight, rateLimit, and rateLimitPeriod. See Search and question answering for request parameters and override behavior; example model names and values are not defaults for every environment.

The ingestion tracing switch is tracingEnabled; complete traces also depend on environment configuration. Lexicon bindings are managed separately on the settings page; see Lexicon management for enablement and binding behavior.

Rebuild and delete

Troubleshooting

Why do existing documents look unchanged after saving? Configuration changes and document reprocessing are separate steps. Check the rebuild prompt and the status of documents and ingestion jobs.

Why is image understanding or retrieval unavailable? Check whether the project model and provider are available, whether the feature is enabled, and whether the corresponding job failed. A successful submission is not proof of completed processing when a model is unavailable.