Settings

AI: Knowledge baseProfessional Edition+

Open the Settings page

After opening the knowledge base detail page, click Settings in the left sidebar. This page modifies basic information, file storage, vector store, and default segmentation settings of the current knowledge base.

Basic information

Local knowledge base settings include:

SettingDescription
KeyUnique identifier of the knowledge base. It cannot be changed after creation
NameKnowledge base name
File storageWhere documents and segment files are stored. It cannot be changed after creation
Vector storeVector store used by the current knowledge base
DescriptionKnowledge base description
EnabledWhether the current knowledge base is enabled
Vector store changes

After you modify Vector store, NocoBase asks for confirmation when saving. After the vector store changes, existing documents must be vectorized again before vector data can be written to the new vector store. Choose Save and vectorize to save the settings and vectorize immediately, or choose Save only to save the settings and later run Vectorization manually on the Documents page.

Default segmentation parameters

The Settings page includes three segmentation parameters:

SettingDefaultDescription
Split documentEnabledWhether uploaded documents are automatically split into multiple segments
Chunk size6000Maximum character count of each segment
Chunk overlap1200Overlapping character count between adjacent segments

Chunk overlap cannot be greater than or equal to Chunk size. If the value is invalid, the backend normalizes it to keep overlap smaller than a single segment.

Relation to document-level segment settings

These settings are knowledge-base-level defaults. They mainly affect documents uploaded or regenerated later.

After a document enters the knowledge base, it keeps its own segmentation parameters. On the Documents page, click Segments for a document, then open Segment settings to set Split document, Chunk size, and Chunk overlap for that document and run Resegment.

The relation between the two places is:

  • Segmentation parameters in Settings define the default strategy for the knowledge base and are suitable for controlling new documents consistently
  • Segmentation parameters in the Segments dialog only apply to the current document and are suitable for handling a document that is too long, too short, or structurally special
  • Existing generated segments are not automatically rebuilt after knowledge-base-level defaults change
  • To apply new parameters to an existing document, open its Segment settings and run Resegment
Note

Resegment discards manually edited segment content and related questions in that document. Changing knowledge-base-level defaults does not immediately overwrite existing segments; only document-level Resegment rebuilds segments.

When to adjust parameters

Default parameters cover most plain text, Markdown, Word, and PDF documents. Adjust them only in these cases:

  • Segments are too long and matched results include too much unrelated content: reduce Chunk size
  • Segments are too short and context is incomplete: increase Chunk size
  • Sentence breaks are obvious between adjacent segments: increase Chunk overlap
  • You want the whole document to be one retrieval unit: turn off Split document

After saving settings, newly uploaded documents use the new default parameters.