Building and managing Knowledge Bases — document upload, RAG pipeline, dynamic filters, AI metadata extraction
When you ask the AI a question and it replies “I don’t know” or gives an off-topic answer, that’s where the Knowledge Base comes in. By converting your internal documents into a form the AI can reference directly, the Knowledge Base enables accurate, document-grounded answers.
Example
“What is our company’s annual leave policy?”
State
Behavior
Result
No Knowledge Base
Answers from general AI knowledge
Inaccurate or “I don’t know”
Knowledge Base connected
Searches hr-policy.pdf for related content, then answers
Accurate policy + citation
Each Knowledge Base can use a different Document Processing Profile with its own extraction method and chunking strategy. See Document Processing Profile Selection below for details.
View Knowledge Bases in Workspace > Knowledge Base
Collections and Libraries
The Knowledge Base list mixes two kinds of card, told apart by the badge at the card’s top left (Library in blue, Collection in green). Create each with + New Knowledge · New Library at the top right of the list.
Collection
Library
Structure
A flat bundle of documents, no folders
A container with a folder tree
Shown on the card
File count · last updated
Folder count · file count
Best for
Gathering documents on one topic in one place
Moving an already-foldered pile of documents structure and all
Working with a Library
Open a library and you get the folder tree on the left, and the selected folder’s file list on the right.
Control
Where
What it does
Search folders and files
Search box above the tree
Searches every folder of the library at once
Import folder · structure + files
Below the tree
Pulls a folder from your PC in with its subfolder structure intact
+ New collection
Below the tree
Creates a new folder inside the library
Process all · N pending
Below the tree (only when files are unprocessed)
Embeds every unprocessed file in the library in one go
Each folder behaves like an independent Knowledge Base. A new folder inherits its parent’s filter schema, extraction mode, extraction model, search settings, and access control at creation, and you can change each of them per folder afterwards.Tool description is the one exception — it is not inherited. “When to search this folder” has to differ per folder, so it starts empty.
Inside a library folder, the AI button next to the tool description fills the whole subtree, not just that folder. Leaf folders are drafted from a sample of their filenames and parent folders from a summary of their children, bottom-up — so one click at the root folder fills the entire library. Folders that already have a description are skipped, and a “Generated descriptions for N folders” toast confirms the result.
Agents can connect an entire library. The knowledge picker on the agent edit screen has Library / Collection / Document filters so you can narrow by type.
Deleting a library or a folder deletes the whole subtree, files and vectors included. It is not a “detach from the group” action — it removes the structure itself, and it cannot be undone. A confirmation dialog appears first.
Naming rules differ too. A collection name must be unique across the workspace, but folder names inside a library only need to be unique among siblings — so every department’s library can have its own “Contracts” folder.
If the folder names themselves are your classification axis (e.g. project-number/doc-type/file), pair this with a filter’s Folder mapping. Upload a folder and the folder names fill the metadata values directly, with no LLM extraction needed. See the Dynamic Filters Deep-Dive for details.
RAG Pipeline
Uploaded documents go through this pipeline before becoming searchable.
Stage
Description
Apply Profile
Applies the extraction/chunking strategy from the KB’s document processing profile
Extract Text
Extracts text from documents (default, OCR, LLM Vision, etc., depending on profile)
Chunking
Splits long documents into search-friendly sizes (fixed-size or semantic)
Preserve Tables
Keeps tables intact in adjacent chunks instead of splitting (per profile)
Preserve Context
Adds an LLM-generated summary of the document context to each chunk (per profile)
Embedding
Converts text to high-dimensional vectors
Similarity Search
Finds chunks most similar to the question
LLM Response Generation
Generates an answer using the retrieved documents as context
Creating a Knowledge Base
1
Enter basic information
In Workspace > Knowledge Base, click + New Knowledge at the top-right to open the create form.
Enter a name and description, then set the permission.
Enter name and description, and set access permissions
Field
Description
Example
Name
KB name (required)
“HR Policy 2024”
Description
Purpose and content (required)
“HR team policies and guidelines”
Permission
Public / Private. If private, pick targets in the Groups card below
Private + “Sales”
2
Upload documents
Add documents to the new Knowledge Base. Click the Add Content (+) button to choose an upload method.
Use Add Content (+) to choose file upload, text input, or cloud sources
Upload methods:
Method
Description
Drag and Drop
Drag files onto the upload area
Upload Files
Select “Upload Files” from the “Add Content” menu
Upload Directory
Select “Upload Directory” — bulk-upload all files in a folder
Cloud Storage
Google Drive, OneDrive, SharePoint (visible when admin has configured)
Add Text
Write text directly to add as content
3
Wait for processing
Uploaded documents go through text extraction → chunking → embedding → indexing automatically.
A real-time notification appears when processing completes.
Files that take more than 30 minutes to process are auto-failed. Delete and re-upload the file in that case.
Bulk uploads:
5+ files or directory uploads switch to batch mode
A progress bar shows steps (upload → processing) at the top, with failures shown in red
3 files are processed in parallel
Progress state persists across page refreshes
4
Verify and validate
Click a document to view extracted text and connect it to an agent to validate retrieval quality. Toggle Summary in the file list to see the AI-generated document summary.
Supported File Formats
The default extraction engine recognizes text in the following formats. Switching the extraction engine widens this coverage (see Content Extraction Engine below).
Category
Supported Formats
Documents
PDF, DOCX, RST, EPUB, MSG (Outlook mail)
Spreadsheets
XLSX, XLS, CSV
Presentations
PPTX, PPT
Web / Markup
HTML, HTM, XML, MD
Text / Source code
TXT, PY, JS, TS, JSON, SQL, JAVA, GO, C, C++, CS, RB, RS, PHP, SH, and ~50 more
Extensions not listed can still be uploaded — they are read as plain text. However, binary files such as ZIP or executables may be ingested as garbled content, so we recommend uploading the formats above. An admin can configure an allowed-extension whitelist to restrict uploads to specific formats only.
Both values are unlimited by default. Leaving an admin field empty means no limit; entering a number rejects any file exceeding that threshold at upload time.
Dynamic Filters
Dynamic filters let you classify documents in a KB by metadata and automatically narrow the search scope.
For internal mechanics of dynamic filters — Manual vs. AI comparison, 5-step search flow, and more — see the Dynamic Filters Deep-Dive.
Defining the Filter Schema
Click “Add Filter” in Knowledge Base settings to define filter fields.
Define filter fields to classify documents by metadata
Setting
Description
Example
Field Name
Filter field name
”Department”, “Year”
Type
Data type
Single Select, Multi Select, Glossary, Date, Number
Mark as required
Warns files that leave this field empty when it’s set as required
Required ON/OFF toggle
Folder mapping
On folder upload, stores the folder name at this depth as the value
None / Folder level 1–3
Filter Options
List of allowed values (Single Select / Multi Select types)
“Finance, HR, Engineering”
Agent Description
Description so the AI understands the filter
”Filter by the document’s department”
Filter Types
Type
Description
Single Select
Single selection from predefined options
Multi Select
Multiple selections from predefined options
Glossary
Define a filter by selecting a glossary
Date
Date range filter
Number
Integer filter
Per-File Metadata Settings
After defining the filter schema, set metadata values per file. A filled fields / total filters badge at the far right of each file row shows the state at a glance.
Per-file metadata state is shown as a fill badge
Badge color
Meaning
Green
All filter fields have values
Blue
Required fields are filled; some optional fields are empty
Orange
A required field is empty
Gray
Nothing filled and no filter marked required
While AI extraction runs, an “Extracting” badge replaces the count; with no filters defined, the badge doesn’t appear at all. Color is decided by whether required fields are satisfied, not by how many are filled.
When metadata changes, the vector index is updated automatically. Existing vectors are kept — no re-embedding required.
AI Auto-Extraction
When you set an extraction prompt on the filter schema, the LLM analyzes document content and filename at upload time and auto-extracts metadata.
1
Set extraction mode
Click the Manual / AI toggle in the filter schema and switch to AI mode.
2
Write the extraction prompt
Write an extraction prompt for each filter.
Example: “Extract the country name from the filename”
3
Pick an AI model
Select the LLM model for extraction.
4
Run extraction
Runs automatically on upload, or run single/all extraction manually.
Method
Description
Auto-extraction
Runs automatically right after upload (AI mode + an extraction hint present)
AI Extract
Re-extract just that file from the Metadata panel that opens when you click it
Extract (N)
Bulk-extract the checked files from the toolbar above the file list
You can use “filename” as a condition in the extraction prompt.
Example: “If the filename starts with [XX] (country code), extract that country code”
Filter Use During Search
When a connected KB has dynamic filters, the AI auto-infers filter conditions from the user’s question to narrow search scope.
Q: Show me the Finance team's 2024 policies→ Filters auto-applied: department=Finance, year=2024→ Searches only matching documents
Tool Description
Tool Description, at the top of the Knowledge Base detail screen, is the AI-only description that tells the agent when and in what situations to search this Knowledge Base. The screen itself reads “Describe when the agent should search this knowledge base.”
Example of a good tool description
Use when there are questions about company HR policies and internal guidelines.Reference for HR-related questions like leave, benefits, and travel policies.
If the tool description is empty, the KB’s general description is used instead. We recommend writing a specific one so the AI can pick the right Knowledge Base among many.AI auto-generation: Click the AI button next to the tool description — it drafts the text from the KB name, description, file list, and filter info. The dropdown beside it picks the model used for generation.
Connect a Knowledge Base with an empty tool description to an agent and a “Tool description is missing” warning appears above the knowledge list, naming the items involved. It still saves, but the agent has a harder time deciding when to use that Knowledge Base.
The filter edit form has its own field also called Agent Description. That one describes a single filter; the tool description here describes the whole Knowledge Base. The Dynamic Filters Deep-Dive lays out the difference.
Knowledge Base Management
Document Management
Action
Method
Add document
Add Content (+) button or drag-and-drop
Delete document
Select a document and click delete
View content
Click a document to preview the extracted text
Search
Search by filename (server-side, fast even on large KBs)
Sort
Newest (default) / Oldest / By name
Review changes
Activity History button at the top
The file list uses infinite scroll to load 50 entries at a time.File state badges:
Badge
Meaning
Failed (red)
Processing failed — click Retry next to it
Processing (orange)
Processing in progress
Summary (toggle)
Processed + summary available — click to view inline summary
N/M (fill badge)
Metadata fill state, shown only when filters exist
Re-uploading a file with the same name shows a duplicate confirmation dialog.
Option
Behavior
Overwrite
Delete the existing file and replace
Skip
Skip the duplicate, keep the existing file
Cancel
Cancel upload
Reindexing
To rebuild the vector index for the entire KB, run reindex from Admin Panel > Settings > Documents. This is admin-only and processes all KBs at once.When you edit and save an individual file’s content, only that file is automatically re-processed.
Using in Chat
@ Command
Agent Connection
Reference directly during chat with @kb-name.
@hr-policy What is the leave application process?
When a Knowledge Base is connected in agent settings, it’s referenced automatically. Users just chat — no command needed.
Click citation numbers in the AI response to view the source content.
Document Processing Profile Selection
New feature — Apply different document processing strategies (extraction engine, chunking method, table preservation) per Knowledge Base.
Choose one of the profiles defined by the admin in Admin Panel > Settings > Documents. If you don’t pick one, the default profile applies.
Only admins can create profiles. If a needed profile is missing, ask your admin. See Admin Panel > Settings > Documents for profile setup.
Advanced Settings
Adjust document processing and search parameters in admin settings.
These settings are global defaults for KBs without a Document Processing Profile. KBs with a profile use the profile settings instead.
Content Extraction Engine
Choose the engine for extracting text from documents in admin settings.
Engine
Strengths
Best For
Default (PyPDF/Langchain)
No setup needed
Plain-text PDF, DOCX
Tika
Server required, supports many formats
Mixed file formats
Docling
Server required
Complex layout documents
Azure Document Intelligence
Azure subscription required, high-precision OCR
Scanned documents, table-heavy PDFs
Mistral OCR
Mistral API required
PDF OCR
Google Cloud Document AI
GCP subscription required
Documents with embedded images
LLM Vision
Vision LLM-based, high precision
Complex layouts, charts
Image files (PNG, JPG, etc.) are not text-indexed by default — they are stored but their contents are not searchable. To search text inside images, set the knowledge base’s document processing profile to Google Cloud Document AI or LLM Vision. (Azure Document Intelligence and Mistral OCR handle PDF and Office documents but do not support standalone image files.)
Document Processing Profile Options
Setting
Description
Default
Name
Enter the document processing profile name
-
Default Engine
Engine used for files whose extension has no engine mapping
built-in engine
Extension → Engine Mapping
Use the selected engine for specific registered extensions
-
Text Splitter
Choose how to split text (default, token, semantic)
Default (character)
Preserve Tables
Keep tables attached to the preceding text chunk instead of splitting them during chunking
Enabled
Contextual Chunking
Add a per-chunk context summary to improve search accuracy
See the note below
Contextual chunking only takes effect when a Context Model is also selected. On a new profile the switch appears on, but the model is empty so nothing is applied. Pick a model and save to use it. It also does not apply to files attached ad hoc in chat — only to documents loaded into a knowledge base.
Text Splitter options:
Setting
Description
Default
Applies To
Chunk Size
Document split unit (characters)
1,000
Default (character), Token
Chunk Overlap
Overlapping characters between chunks
100
Default (character), Token, Semantic
Min Tokens per Chunk
Minimum characters to form a chunk
-
Default (character), Token, Semantic
Max Tokens per Chunk
Maximum characters to form a chunk
-
Default (character), Token, Semantic
Threshold Type
Type of similarity criterion for splitting chunks
Percentile (recommended)
Semantic
Threshold
Split-decision threshold per threshold type
-
Semantic
Embedding Engine
Engine
Strengths
Default (SentenceTransformers)
No external transmission, strong security
Ollama
Local server, custom models
OpenAI
High quality, API costs
Azure OpenAI
Optimized for enterprise
Gemini
Google embedding model, GCP integration
Vertex AI
GCP managed embedding service
Search Settings
Search settings have two layers — global (admin) and per-KB.
Setting
Default
Description
Top K
Global setting
Chunks to retrieve via vector search
Reranker Top K
Global setting
Final chunks after reranking
Reranker Threshold
Global setting
Minimum reranker score (lower = more pass through)
Override search settings per Knowledge Base. Click the Search Settings icon on the KB edit screen.
All three fall back to the global setting when left empty — the greyed-out number in each field is the global value currently in effect.
Review or change it under Admin › Settings › Search Engine.
Per-KB Document Summary Settings
Control document summary generation per KB. Configure under the “File Summary” section in the search settings modal.
Setting
Description
Default
Enable File Summary
Auto-generate AI summary on file processing completion
On
Summary Model
LLM model for summarization
Uses Task Model
For files with summaries, click the “Summary” toggle in the list to view inline.
Question Generation (Multi-Vector Search)
When question generation is enabled, the LLM pre-generates “questions a user might ask to find this content” for each chunk and stores them as separate vectors.
State
Search Method
Effect
Disabled
Content vectors only
Standard search
Enabled
Weighted sum of content + question vectors
Improved accuracy with user-question-style phrasing
Enabling question generation adds LLM calls during document processing. Processing time and cost may increase.
Configure question generation per KB independently of the global setting. Use the “Question Generation” section in the search settings modal to enable/disable and select the LLM model.
Best Practices
Document Preparation
Clean format: Distinguish titles and subheadings clearly with consistent styling
Keep current: Update documents regularly and remove old ones
Right size: Split large documents by topic and group related content together
Knowledge Base Composition
Separate by topic: Create separate KBs for “HR Policy”, “IT Guide”, “Product Manual”, etc.
Granular access: Manage sensitive info separately and restrict access by department
Write tool descriptions: A specific tool description helps agents auto-pick the right KB
Use Cases
New Employee Onboarding
Build Knowledge Bases of HR policy, work manuals, and IT guides so new hires can adapt quickly by asking the AI.
Build Knowledge Bases of product manuals, FAQs, and technical docs to provide accurate answers to customer inquiries.
Dynamic filters: filter by product name, version
Agent: customer-support system prompt + Knowledge Base connection
Use citation display to ensure trust
Per-Department Policy Management
Classify per-department documents with dynamic filters and search the right policies by department.
Dynamic filters: department, year, document type
AI auto-extraction for metadata
Access control to protect sensitive documents
FAQ
Are there KB capacity limits?
By default, there’s no limit on file count or capacity. Admins can set limits via environment variables.
What happens if I re-upload the same file?
When a file with the same name is detected, a duplicate confirmation dialog appears with Overwrite, Skip, or Cancel options.
Is text inside PDF images recognized?
The default extraction engine extracts text from images embedded in PDFs to a limited degree, but for scanned documents or image-heavy PDFs, Azure Document Intelligence, Google Cloud Document AI, or LLM Vision engines are much more accurate. To upload a standalone image file (PNG/JPG) and search its text, a Google Cloud Document AI or LLM Vision profile is required. Check the extraction engine setting with your admin.
Does changing dynamic filter metadata require re-embedding?
No. Metadata changes only update the vector index’s filter fields; existing vectors stay intact. Processed quickly without re-embedding.
What happens to search settings when multiple KBs are connected to one agent?
When multiple KBs are connected, search settings merge as follows:
Top K, Reranker Top K: Use the largest value across KBs
Reranker Threshold: Use the lowest value across KBs (more results pass)
Does changing the Document Processing Profile affect existing documents?
Existing documents’ vectors are not auto-reprocessed when the profile changes. To apply the new profile to existing documents, delete and re-upload them, or run a full reindex from admin settings.
What's the cost of LLM Vision or Context Preservation?
For a 10-page PDF + 20 chunks: LLM Vision (11 calls) + Context Preservation (20 calls) ≈ 31 LLM calls. Bulk uploading large documents can cost a lot, so use selectively for important docs.
Related Pages
Dynamic Filters Deep-Dive
Filter internals, Manual vs AI, the 5-step search flow
Knowledge Graph
Connect Knowledge Bases + glossaries + DBs into one graph
Agents
Connect a Knowledge Base to an agent
Glossary
Improve AI understanding by defining domain terms
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Cloosphere Guide","colors":{"primary":"#5f22d0","light":"#7c3aed","dark":"#4c1d95"},"logo":{"light":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","dark":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439","href":"/ko/index"},"favicon":"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/favicon.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=0e41ff0755aa623d52e26f279f285f71","appearance":{"default":"system","strict":false},"interaction":{"drilldown":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"ko","default":true,"href":"ko"},{"language":"en","href":"en"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cloocus","hasAudioNarration":false,"actualSubdomain":"cloocus","customDomains":["docs.cloosphere.ai"],"gitSource":{"type":"github","owner":"ais-cloocus","repo":"cloosphere-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6a954066df6b735599399868","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Admin","count":30},{"language":"ko","tag":"관리자","count":30},{"language":"en","tag":"Settings","count":24},{"language":"ko","tag":"설정","count":24},{"language":"en","tag":"Monitoring","count":21},{"language":"ko","tag":"모니터링","count":21},{"language":"en","tag":"Workspace","count":16},{"language":"ko","tag":"워크스페이스","count":16},{"language":"en","tag":"Chat","count":11},{"language":"ko","tag":"채팅","count":11},{"language":"en","tag":"Getting Started","count":10},{"language":"ko","tag":"시작하기","count":10},{"language":"en","tag":"Collaboration","count":8},{"language":"ko","tag":"협업","count":8},{"language":"en","tag":"Data \u0026 Operations","count":6},{"language":"ko","tag":"운영 · 지원","count":6},{"language":"ko","tag":"데이터 및 운영 보안","count":6},{"language":"en","tag":"AI Features \u0026 Safety","count":5},{"language":"en","tag":"UI \u0026 Channels","count":5},{"language":"ko","tag":"AI 기능 및 안전","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* latin-ext */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu6-K6h9Q.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'DM Sans';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/dmsans/v17/rP2Yp2ywxg089UriI5-g4vlH9VoD8Cmcqbu0-K4.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb54C-s0.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPb94C-s0.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Space Grotesk';\n font-style: normal;\n font-weight: 700;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/spacegrotesk/v22/V8mDoQDjQSkFtoMM3T6r8E7mPbF4Cw.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--brand-primary: #5f22d0;--brand-light: #7c3aed;--brand-dark: #4c1d95;--brand-subtle: #ede9fe;--brand-glow: rgba(95, 34, 208, 0.15);--page-text: #0f172a;--page-muted: #6b7280}body{font-family:\"DM Sans\", sans-serif;color:var(--page-text);font-size:17px}.prose h1,.prose h2,.prose h3,.prose h4{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;letter-spacing:-0.015em}.prose h1{font-size:44px}.prose h2{font-size:28px;margin-top:36px;margin-bottom:10px}.prose h3{font-size:22px;margin-top:28px;margin-bottom:8px}.prose p,.prose li{color:var(--page-text);line-height:1.75;font-size:1rem}.prose hr{border:0;height:1px;background:linear-gradient(90deg, rgba(148, 163, 184, 0.4), rgba(148, 163, 184, 0.05));margin:28px 0}.dark body{color:#e2e8f0}.dark .prose p,.dark .prose li{color:#e2e8f0}.dark .prose hr{background:linear-gradient(90deg, rgba(148, 163, 184, 0.3), rgba(148, 163, 184, 0.05))}[class*=\"Card\"] svg,.card svg,a[href] svg{color:var(--brand-primary)!important}.card [data-component-part=\"card-icon\"]{margin-bottom:8px}.card [data-component-part=\"card-title\"]{margin-top:12px!important}[class*=\"Card\"],.card{border-radius:16px!important;border-color:rgba(148, 163, 184, 0.25)!important;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover,.card:hover{transform:translateY(-2px);border-color:var(--brand-light)!important;box-shadow:0 4px 20px var(--brand-glow)!important}a:not([class*=\"Card\"]):hover{color:var(--brand-primary)!important}.stable-scrollbar-gutter.overflow-auto{width:220px!important;min-width:220px!important}.stable-scrollbar-gutter.overflow-auto+div,.stable-scrollbar-gutter.overflow-auto~main{flex:1!important}.flex.flex-row-reverse.gap-12{gap:32px!important}.xl\\:flex.self-start.sticky{max-width:15rem!important}.xl\\:flex.box-border.max-h-full.pl-10{width:14rem!important;padding-left:24px!important}.text-sm.leading-6.w-\\[16\\.5rem\\]{width:100%!important;font-size:13px!important;line-height:1.6!important}#table-of-contents-content a{padding:5px 0!important;display:block}#table-of-contents-content,#table-of-contents-content ul{list-style:none!important;padding-left:0!important;margin-left:0!important}#table-of-contents-content li::marker{content:\"\"!important}#table-of-contents-content>li{border-left:2px solid rgba(148, 163, 184, 0.1);padding-left:12px;transition:border-color 0.15s ease}.dark #table-of-contents-content>li{border-left-color:rgba(148, 163, 184, 0.08)}#table-of-contents-content a{color:var(--page-muted)!important;font-weight:400!important;transition:color 0.15s ease}.dark #table-of-contents-content a{color:#94a3b8!important}#table-of-contents-content>li>a{color:var(--page-text)!important;font-weight:500!important}.dark #table-of-contents-content>li>a{color:#e2e8f0!important}#table-of-contents-content>li>ul{padding-left:12px!important}#table-of-contents-content a:hover{color:var(--brand-dark)!important}.dark #table-of-contents-content a:hover{color:#e2e8f0!important}#table-of-contents-content a.text-primary,#table-of-contents-content a.font-semibold,#table-of-contents-content>li.is-active-item>a{color:var(--brand-primary)!important;font-weight:600!important}.dark #table-of-contents-content a.text-primary,.dark #table-of-contents-content a.font-semibold,.dark #table-of-contents-content a[class*=\"dark:text-primary\"],.dark #table-of-contents-content>li.is-active-item>a{color:var(--brand-light)!important;font-weight:600!important}#table-of-contents-content>li.is-active-item{border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li.is-active-item{border-left-color:var(--brand-light)!important}#table-of-contents-content>li:has(>a.border-primary),#table-of-contents-content>li:has(>a.text-primary){border-left-color:var(--brand-primary)!important}.dark #table-of-contents-content>li:has(>a.border-primary),.dark #table-of-contents-content>li:has(>a.text-primary),.dark #table-of-contents-content>li:has(>a[class*=\"dark:text-primary\"]),.dark #table-of-contents-content>li:has(>a[class*=\"dark:border-primary\"]){border-left-color:var(--brand-light)!important}.landing-hero{text-align:center;padding:72px 32px 24px;max-width:860px;margin:0 auto}.landing-hero h1{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:52px;font-weight:700;letter-spacing:-0.03em;margin:0 0 20px;background:linear-gradient(135deg, var(--brand-dark), var(--brand-primary), var(--brand-light));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}.dark .landing-hero h1{background:linear-gradient(135deg, var(--brand-light), #a78bfa, #c4b5fd);-webkit-background-clip:text;background-clip:text}.landing-hero p{font-size:19px;line-height:1.7;color:var(--page-muted);margin:0}.dark .landing-hero p{color:#94a3b8}.landing-section{max-width:1280px;margin:0 auto;padding:0 40px 56px}.landing-section h2{font-family:\"Space Grotesk\", \"DM Sans\", sans-serif;font-size:26px;font-weight:600;letter-spacing:-0.015em;margin:0 0 6px;color:var(--page-text)}.dark .landing-section h2{color:#e2e8f0}.landing-section>p{color:var(--page-muted);font-size:16px;margin:0 0 24px}.dark .landing-section>p{color:#94a3b8}.landing-cta{max-width:1280px;margin:0 auto;padding:0 40px 48px}.landing-divider{max-width:1280px;margin:0 auto 48px;padding:0 40px}.landing-divider hr{border:0;height:1px;background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.3), transparent);margin:0}.dark .landing-divider hr{background:linear-gradient(90deg, transparent, rgba(148, 163, 184, 0.15), transparent)}.landing-section [role=\"tablist\"]{margin-bottom:12px}.landing-section [role=\"tabpanel\"]>p:first-child{color:var(--page-muted);font-size:15px;margin-bottom:20px}.dark .landing-section [role=\"tabpanel\"]>p:first-child{color:#94a3b8}.group:has(>.mermaid){background:linear-gradient(135deg, #faf8ff 0%, #f3f0ff 100%);border:1px solid rgba(95, 34, 208, 0.08);border-radius:12px;padding:28px 24px;margin:24px 0}.dark .group:has(>.mermaid){background:linear-gradient(135deg, rgba(95, 34, 208, 0.06) 0%, rgba(95, 34, 208, 0.03) 100%);border-color:rgba(124, 58, 237, 0.12)}.mermaid svg .node rect,.mermaid svg .node circle,.mermaid svg .node ellipse,.mermaid svg .node polygon,.mermaid svg .node path{fill:#ede9fe!important;stroke:#7c3aed!important;stroke-width:1.5px!important;rx:8px}.dark .mermaid svg .node rect,.dark .mermaid svg .node circle,.dark .mermaid svg .node ellipse,.dark .mermaid svg .node polygon,.dark .mermaid svg .node path{fill:rgba(124, 58, 237, 0.15)!important;stroke:#a78bfa!important}.mermaid svg .node.rhombus rect,.mermaid svg .node polygon[points]{fill:#ddd6fe!important;stroke:#6d28d9!important}.dark .mermaid svg .node.rhombus rect,.dark .mermaid svg .node polygon[points]{fill:rgba(109, 40, 217, 0.2)!important;stroke:#a78bfa!important}.mermaid svg .cluster rect{fill:rgba(237, 233, 254, 0.4)!important;stroke:rgba(124, 58, 237, 0.25)!important;stroke-width:1.5px!important;rx:10px!important}.dark .mermaid svg .cluster rect{fill:rgba(124, 58, 237, 0.08)!important;stroke:rgba(167, 139, 250, 0.2)!important}.mermaid svg .cluster-label .nodeLabel,.mermaid svg .cluster span{fill:var(--brand-dark)!important;color:var(--brand-dark)!important;font-weight:600!important}.dark .mermaid svg .cluster-label .nodeLabel,.dark .mermaid svg .cluster span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg .edgePath path.path{stroke:#8b5cf6!important;stroke-width:1.5px!important}.dark .mermaid svg .edgePath path.path{stroke:#a78bfa!important}.mermaid svg .marker{fill:#8b5cf6!important;stroke:#8b5cf6!important}.dark .mermaid svg .marker{fill:#a78bfa!important;stroke:#a78bfa!important}.mermaid svg .label,.mermaid svg .nodeLabel,.mermaid svg .label text,.mermaid svg span{fill:#1e1b4b!important;color:#1e1b4b!important;font-family:\"DM Sans\", sans-serif!important}.dark .mermaid svg .label,.dark .mermaid svg .nodeLabel,.dark .mermaid svg .label text,.dark .mermaid svg span{fill:#e2e8f0!important;color:#e2e8f0!important}.mermaid svg .edgeLabel{background-color:#faf8ff!important}.dark .mermaid svg .edgeLabel{background-color:transparent!important}.mermaid svg .edgeLabel span{fill:#6d28d9!important;color:#6d28d9!important;font-size:13px!important}.dark .mermaid svg .edgeLabel span{fill:#c4b5fd!important;color:#c4b5fd!important}.mermaid svg{background:transparent!important}#localization-select-trigger>div:first-child{display:none!important}[data-relocated-lang]{gap:0!important}::selection{background:var(--brand-subtle);color:var(--brand-dark)}.dark ::selection{background:var(--brand-dark);color:#ffffff}*:focus-visible{outline-color:var(--brand-primary)!important}::-webkit-scrollbar-thumb{background:var(--brand-light);border-radius:4px}::-webkit-scrollbar-thumb:hover{background:var(--brand-primary)}.cloo-badge{display:inline-block;font-family:\"DM Sans\", sans-serif;font-size:12px;font-weight:600;line-height:1.5;padding:0 8px;border-radius:6px;letter-spacing:-0.01em;vertical-align:middle;white-space:nowrap;margin-right:2px}.cloo-badge--required{background:#fef2f2;color:#b91c1c}.cloo-badge--multiworker{background:#fff7ed;color:#c2410c}.cloo-badge--recommended{background:#eff6ff;color:#1d4ed8}.cloo-badge--optional{background:#f1f5f9;color:#475569}.dark .cloo-badge--required{background:rgba(185, 28, 28, 0.2);color:#fca5a5}.dark .cloo-badge--multiworker{background:rgba(194, 65, 12, 0.2);color:#fdba74}.dark .cloo-badge--recommended{background:rgba(29, 78, 216, 0.22);color:#93c5fd}.dark .cloo-badge--optional{background:rgba(71, 85, 105, 0.28);color:#cbd5e1}"}]}
{"page":{"pagePath":"en/workspace/knowledge","slug":"/en/workspace/knowledge","pageMetadata":{"title":"Knowledge Base","description":"Building and managing Knowledge Bases — document upload, RAG pipeline, dynamic filters, AI metadata extraction","href":"/en/workspace/knowledge"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Building and managing Knowledge Bases — document upload, RAG pipeline, dynamic filters, AI metadata extraction\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,blockquote:`blockquote`,code:`code`,hr:`hr`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Accordion,AccordionGroup,Card,CodeBlock,Columns,Frame,Heading,Info,Mermaid,Note,OptimizedImage,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!AccordionGroup)_missingMdxReference(`AccordionGroup`,true);if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Columns)_missingMdxReference(`Columns`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Mermaid)_missingMdxReference(`Mermaid`,true);if(!Note)_missingMdxReference(`Note`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`When you ask the AI a question and it replies “I don’t know” or gives an off-topic answer, that’s where the Knowledge Base comes in. By converting your internal documents into a form the AI can reference directly, the Knowledge Base enables `,_jsx(_components.strong,{children:`accurate, document-grounded answers`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`example`,children:`Example`}),`\n`,_jsxs(_components.blockquote,{children:[`\n`,_jsx(_components.p,{children:`“What is our company’s annual leave policy?”`}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`State`}),_jsx(_components.th,{children:`Behavior`}),_jsx(_components.th,{children:`Result`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`No Knowledge Base`}),_jsx(_components.td,{children:`Answers from general AI knowledge`}),_jsx(_components.td,{children:`Inaccurate or “I don’t know”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Knowledge Base connected`}),_jsxs(_components.td,{children:[`Searches `,_jsx(_components.code,{children:`hr-policy.pdf`}),` for related content, then answers`]}),_jsx(_components.td,{children:`Accurate policy + citation`})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Each Knowledge Base can use a different `,_jsx(_components.strong,{children:`Document Processing Profile`}),` with its own extraction method and chunking strategy. See `,_jsx(_components.a,{href:`#document-processing-profile-selection`,children:`Document Processing Profile Selection`}),` below for details.`]})}),`\n`,_jsx(Frame,{caption:`View Knowledge Bases in Workspace > Knowledge Base`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-list.png?fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=6dcbdcf2223545fe99018af85b4f9fb6`,alt:`Knowledge Base list`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/en/workspace/knowledge-list.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-list.png?w=280\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=6a309e4cfe95561344a517cbe87aeb60 280w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-list.png?w=560\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=2699ff5ded06234d9401ec1a1490b1a7 560w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-list.png?w=840\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=9e8102b935ca7b2006fc7896864e2f5a 840w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-list.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=d126f06b5469d250d4da250e58906c2d 1100w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-list.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=90e3ab5d8286778a645331bc66cf1572 1650w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-list.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=99cb414166d7be0a7d31d2407d76593c 2500w`})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`collections-and-libraries`,children:`Collections and Libraries`}),`\n`,_jsxs(_components.p,{children:[`The Knowledge Base list mixes two kinds of card, told apart by the badge at the card’s top left (`,_jsx(_components.strong,{children:`Library`}),` in blue, `,_jsx(_components.strong,{children:`Collection`}),` in green). Create each with `,_jsx(_components.strong,{children:`+ New Knowledge`}),` · `,_jsx(_components.strong,{children:`New Library`}),` at the top right of the list.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`Collection`})}),_jsx(_components.th,{children:_jsx(_components.strong,{children:`Library`})})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Structure`})}),_jsx(_components.td,{children:`A flat bundle of documents, no folders`}),_jsx(_components.td,{children:`A container with a folder tree`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Shown on the card`})}),_jsx(_components.td,{children:`File count · last updated`}),_jsx(_components.td,{children:`Folder count · file count`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Best for`})}),_jsx(_components.td,{children:`Gathering documents on one topic in one place`}),_jsx(_components.td,{children:`Moving an already-foldered pile of documents structure and all`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`working-with-a-library`,children:`Working with a Library`}),`\n`,_jsx(_components.p,{children:`Open a library and you get the folder tree on the left, and the selected folder’s file list on the right.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Control`}),_jsx(_components.th,{children:`Where`}),_jsx(_components.th,{children:`What it does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Search folders and files`})}),_jsx(_components.td,{children:`Search box above the tree`}),_jsxs(_components.td,{children:[`Searches `,_jsx(_components.strong,{children:`every folder`}),` of the library at once`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Import folder · structure + files`})}),_jsx(_components.td,{children:`Below the tree`}),_jsx(_components.td,{children:`Pulls a folder from your PC in with its subfolder structure intact`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`+ New collection`})}),_jsx(_components.td,{children:`Below the tree`}),_jsx(_components.td,{children:`Creates a new folder inside the library`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Process all · N pending`})}),_jsx(_components.td,{children:`Below the tree (only when files are unprocessed)`}),_jsx(_components.td,{children:`Embeds every unprocessed file in the library in one go`})]})]})]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Each folder behaves like an independent Knowledge Base.`}),` A new folder inherits its parent’s `,_jsx(_components.strong,{children:`filter schema, extraction mode, extraction model, search settings, and access control`}),` at creation, and you can change each of them per folder afterwards.`]}),_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Tool description is the one exception — it is not inherited.`}),` “When to search this folder” has to differ per folder, so it starts empty.`]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Inside a library folder, the `,_jsx(_components.strong,{children:`AI`}),` button next to the tool description fills `,_jsx(_components.strong,{children:`the whole subtree`}),`, not just that folder. Leaf folders are drafted from a sample of their filenames and parent folders from a summary of their children, bottom-up — so `,_jsx(_components.strong,{children:`one click at the root folder fills the entire library`}),`. Folders that already have a description are skipped, and a “Generated descriptions for N folders” toast confirms the result.`]})}),`\n`,_jsxs(_components.p,{children:[`Agents can connect `,_jsx(_components.strong,{children:`an entire library`}),`. The knowledge picker on the agent edit screen has `,_jsx(_components.strong,{children:`Library / Collection / Document`}),` filters so you can narrow by type.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Deleting a library or a folder deletes the whole subtree, files and vectors included.`}),` It is not a “detach from the group” action — it removes the structure itself, and it cannot be undone. A confirmation dialog appears first.`]})}),`\n`,_jsxs(_components.p,{children:[`Naming rules differ too. A collection name must be unique across the workspace, but folder names inside a library only need to be unique `,_jsx(_components.strong,{children:`among siblings`}),` — so every department’s library can have its own “Contracts” folder.`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`If the folder names themselves are your classification axis (e.g. `,_jsx(_components.code,{children:`project-number/doc-type/file`}),`), pair this with a filter’s `,_jsx(_components.strong,{children:`Folder mapping`}),`. Upload a folder and the folder names fill the metadata values directly, with no LLM extraction needed. See the `,_jsx(_components.a,{href:`/en/workspace/knowledge-filters#filling-metadata-by-folder-upload`,children:`Dynamic Filters Deep-Dive`}),` for details.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`rag-pipeline`,children:`RAG Pipeline`}),`\n`,_jsx(_components.p,{children:`Uploaded documents go through this pipeline before becoming searchable.`}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n subgraph Document_Processing\n P[Apply Profile] --> B[Extract Text]\n A[File Upload] --> P\n B --> C[Chunking]\n C --> T{Preserve Tables?}\n T -->|Yes| T2[Separate tables, preserve in adjacent chunks]\n T -->|No| C2[Standard chunking]\n T2 --> CTX{Preserve Context?}\n C2 --> CTX\n CTX -->|Yes| CTX2[Add LLM context summary]\n CTX -->|No| D[Embedding]\n CTX2 --> D\n D --> E[(Vector DB)]\n end\n\n subgraph Search_and_Response\n F[User question] --> G[Query embedding]\n G --> H[Similarity search]\n E --> H\n H --> I[Relevant docs]\n I --> J[LLM response generation]\n J --> K[Answer with citations]\n end`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Stage`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Apply Profile`})}),_jsx(_components.td,{children:`Applies the extraction/chunking strategy from the KB’s document processing profile`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Extract Text`})}),_jsx(_components.td,{children:`Extracts text from documents (default, OCR, LLM Vision, etc., depending on profile)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Chunking`})}),_jsx(_components.td,{children:`Splits long documents into search-friendly sizes (fixed-size or semantic)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Preserve Tables`})}),_jsx(_components.td,{children:`Keeps tables intact in adjacent chunks instead of splitting (per profile)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Preserve Context`})}),_jsx(_components.td,{children:`Adds an LLM-generated summary of the document context to each chunk (per profile)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Embedding`})}),_jsx(_components.td,{children:`Converts text to high-dimensional vectors`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Similarity Search`})}),_jsx(_components.td,{children:`Finds chunks most similar to the question`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`LLM Response Generation`})}),_jsx(_components.td,{children:`Generates an answer using the retrieved documents as context`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`creating-a-knowledge-base`,children:`Creating a Knowledge Base`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Enter basic information`,children:[_jsxs(_components.p,{children:[`In `,_jsx(_components.strong,{children:`Workspace > Knowledge Base`}),`, click `,_jsx(_components.strong,{children:`+ New Knowledge`}),` at the top-right to open the create form.\nEnter a name and description, then set the permission.`]}),_jsx(Frame,{caption:`Enter name and description, and set access permissions`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/knowledge-create.png?fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=22c59d170e72682866f5a27506cbef5f`,alt:`Knowledge Base creation form`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/en/workspace/knowledge-create.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/knowledge-create.png?w=280\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=43087d97e30af96971c674194e831503 280w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/knowledge-create.png?w=560\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=fc293c7ee2cc889b109e0fdeb2704ca3 560w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/knowledge-create.png?w=840\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=ada711a4ac842f2dc65ee56ffd4685ab 840w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/knowledge-create.png?w=1100\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=f5608a89113cedcdc0f8ada1f9f5bf45 1100w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/knowledge-create.png?w=1650\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=73103a1f8973ac5b6e43e6366321daad 1650w, https://mintcdn.com/cloocus/f2mhWgQLHON5Ah4d/images/en/workspace/knowledge-create.png?w=2500\u0026fit=max\u0026auto=format\u0026n=f2mhWgQLHON5Ah4d\u0026q=85\u0026s=57c7588d64fc0d833b4576aeac4844eb 2500w`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Name`})}),_jsx(_components.td,{children:`KB name (required)`}),_jsx(_components.td,{children:`“HR Policy 2024”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Description`})}),_jsx(_components.td,{children:`Purpose and content (required)`}),_jsx(_components.td,{children:`“HR team policies and guidelines”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Permission`})}),_jsxs(_components.td,{children:[`Public / Private. If private, pick targets in the `,_jsx(_components.strong,{children:`Groups`}),` card below`]}),_jsx(_components.td,{children:`Private + “Sales”`})]})]})]})]}),_jsxs(Step,{title:`Upload documents`,children:[_jsxs(_components.p,{children:[`Add documents to the new Knowledge Base. Click the `,_jsx(_components.strong,{children:`Add Content (+)`}),` button to choose an upload method.`]}),_jsx(Frame,{caption:`Use Add Content (+) to choose file upload, text input, or cloud sources`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-detail.png?fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=41bb6354898338416b7219e54b9ce0c3`,alt:`Knowledge Base detail`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/en/workspace/knowledge-detail.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-detail.png?w=280\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=df4b1fe4ecc1c0aba544d260e3cd23af 280w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-detail.png?w=560\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=90daf099343f75d9e23b2caa7df56a03 560w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-detail.png?w=840\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=dcf51dd94740e5fff2238db3092ab964 840w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-detail.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=9e5c30986503bbbcbed3f7e3bbff0e9b 1100w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-detail.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=032438f07223947f5ce72d5c46ee7cab 1650w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-detail.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=493d3cd798b488f2b51d618d5407bfe2 2500w`})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Upload methods:`})}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Drag and Drop`})}),_jsx(_components.td,{children:`Drag files onto the upload area`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Upload Files`})}),_jsx(_components.td,{children:`Select “Upload Files” from the “Add Content” menu`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Upload Directory`})}),_jsx(_components.td,{children:`Select “Upload Directory” — bulk-upload all files in a folder`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Cloud Storage`})}),_jsx(_components.td,{children:`Google Drive, OneDrive, SharePoint (visible when admin has configured)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Add Text`})}),_jsx(_components.td,{children:`Write text directly to add as content`})]})]})]})]}),_jsxs(Step,{title:`Wait for processing`,children:[_jsx(_components.p,{children:`Uploaded documents go through text extraction → chunking → embedding → indexing automatically.\nA real-time notification appears when processing completes.`}),_jsx(Note,{children:_jsx(_components.p,{children:`Files that take more than 30 minutes to process are auto-failed. Delete and re-upload the file in that case.`})}),_jsx(_components.p,{children:_jsx(_components.strong,{children:`Bulk uploads:`})}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`5+ files or directory uploads switch to `,_jsx(_components.strong,{children:`batch mode`})]}),`\n`,_jsx(_components.li,{children:`A progress bar shows steps (upload → processing) at the top, with failures shown in red`}),`\n`,_jsx(_components.li,{children:`3 files are processed in parallel`}),`\n`,_jsx(_components.li,{children:`Progress state persists across page refreshes`}),`\n`]})]}),_jsx(Step,{title:`Verify and validate`,children:_jsxs(_components.p,{children:[`Click a document to view extracted text and connect it to an agent to validate retrieval quality. Toggle `,_jsx(_components.strong,{children:`Summary`}),` in the file list to see the AI-generated document summary.`]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`supported-file-formats`,children:`Supported File Formats`}),`\n`,_jsxs(_components.p,{children:[`The default extraction engine recognizes text in the following formats. Switching the extraction engine widens this coverage (see `,_jsx(_components.a,{href:`#content-extraction-engine`,children:`Content Extraction Engine`}),` below).`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Category`}),_jsx(_components.th,{children:`Supported Formats`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Documents`})}),_jsx(_components.td,{children:`PDF, DOCX, RST, EPUB, MSG (Outlook mail)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Spreadsheets`})}),_jsx(_components.td,{children:`XLSX, XLS, CSV`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Presentations`})}),_jsx(_components.td,{children:`PPTX, PPT`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Web / Markup`})}),_jsx(_components.td,{children:`HTML, HTM, XML, MD`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Text / Source code`})}),_jsx(_components.td,{children:`TXT, PY, JS, TS, JSON, SQL, JAVA, GO, C, C++, CS, RB, RS, PHP, SH, and ~50 more`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Extensions not listed can still be uploaded — they are read as plain text. However, binary files such as ZIP or executables may be ingested as garbled content, so we recommend uploading the formats above. An admin can configure an `,_jsx(_components.strong,{children:`allowed-extension whitelist`}),` to restrict uploads to specific formats only.`]})}),`\n`,_jsx(Heading,{level:`4`,id:`max-size-/-count`,children:`Max Size / Count`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Item`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`}),_jsx(_components.th,{children:`Where to change`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Max file size`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`No limit`}),_jsx(_components.td,{children:`Admin Panel > Settings > Documents > Files (unit: MB)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Max file count`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`No limit`}),_jsx(_components.td,{children:`Admin Panel > Settings > Documents > Files`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`Both values are `,_jsx(_components.strong,{children:`unlimited`}),` by default. Leaving an admin field empty means no limit; entering a number rejects any file exceeding that threshold at upload time.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`dynamic-filters`,children:`Dynamic Filters`}),`\n`,_jsx(_components.p,{children:`Dynamic filters let you classify documents in a KB by metadata and automatically narrow the search scope.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`For internal mechanics of dynamic filters — Manual vs. AI comparison, 5-step search flow, and more — see the `,_jsx(_components.a,{href:`/en/workspace/knowledge-filters`,children:`Dynamic Filters Deep-Dive`}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`defining-the-filter-schema`,children:`Defining the Filter Schema`}),`\n`,_jsxs(_components.p,{children:[`Click `,_jsx(_components.strong,{children:`“Add Filter”`}),` in Knowledge Base settings to define filter fields.`]}),`\n`,_jsx(Frame,{caption:`Define filter fields to classify documents by metadata`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/en/workspace/knowledge-filter-schema.png?fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=4463e946540257b1807424fb03897d21`,alt:`Filter schema definition`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1920`,height:`1920`,\"data-path\":`images/en/workspace/knowledge-filter-schema.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/en/workspace/knowledge-filter-schema.png?w=280\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=1b2ac8347fba2c897ecdc588b6925649 280w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/en/workspace/knowledge-filter-schema.png?w=560\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=2c318d3f1b2e8b12745809b9eac5f28c 560w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/en/workspace/knowledge-filter-schema.png?w=840\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=94caae5490af5f4564ecc5f85014c12d 840w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/en/workspace/knowledge-filter-schema.png?w=1100\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=e58fc87e94ead9c654974e26987d3cb6 1100w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/en/workspace/knowledge-filter-schema.png?w=1650\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=eab6446b3abe19b27fad8f3642346317 1650w, https://mintcdn.com/cloocus/V5hK-EjP5aTzhpjg/images/en/workspace/knowledge-filter-schema.png?w=2500\u0026fit=max\u0026auto=format\u0026n=V5hK-EjP5aTzhpjg\u0026q=85\u0026s=5edf2697fdb0ca97580e953376946713 2500w`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Example`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Field Name`})}),_jsx(_components.td,{children:`Filter field name`}),_jsx(_components.td,{children:`”Department”, “Year”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Type`})}),_jsx(_components.td,{children:`Data type`}),_jsx(_components.td,{children:`Single Select, Multi Select, Glossary, Date, Number`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Mark as required`})}),_jsx(_components.td,{children:`Warns files that leave this field empty when it’s set as required`}),_jsx(_components.td,{children:`Required ON/OFF toggle`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Folder mapping`})}),_jsx(_components.td,{children:`On folder upload, stores the folder name at this depth as the value`}),_jsx(_components.td,{children:`None / Folder level 1–3`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Filter Options`})}),_jsx(_components.td,{children:`List of allowed values (Single Select / Multi Select types)`}),_jsx(_components.td,{children:`“Finance, HR, Engineering”`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Agent Description`})}),_jsx(_components.td,{children:`Description so the AI understands the filter`}),_jsx(_components.td,{children:`”Filter by the document’s department”`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`filter-types`,children:`Filter Types`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Single Select`})}),_jsx(_components.td,{children:`Single selection from predefined options`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Multi Select`})}),_jsx(_components.td,{children:`Multiple selections from predefined options`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Glossary`})}),_jsx(_components.td,{children:`Define a filter by selecting a glossary`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Date`})}),_jsx(_components.td,{children:`Date range filter`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Number`})}),_jsx(_components.td,{children:`Integer filter`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`per-file-metadata-settings`,children:`Per-File Metadata Settings`}),`\n`,_jsxs(_components.p,{children:[`After defining the filter schema, set metadata values per file. A `,_jsx(_components.strong,{children:_jsx(_components.code,{children:`filled fields / total filters`})}),` badge at the far right of each file row shows the state at a glance.`]}),`\n`,_jsx(Frame,{caption:`Per-file metadata state is shown as a fill badge`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-metadata.png?fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=60cd6f600f4a87100cca203fea3bb0d4`,alt:`File metadata input`,\"data-og-width\":`2880`,width:`2880`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/en/workspace/knowledge-metadata.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-metadata.png?w=280\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=dcca2882f8196e723e59d3eafbe21c83 280w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-metadata.png?w=560\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=e7f3f30ddae0ac4f1c7b3fbf783e9fbc 560w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-metadata.png?w=840\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=4c19f084cf040fed59b35c2c6be36a26 840w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-metadata.png?w=1100\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=54d33bd907a01bf8dcba04c36378ecf0 1100w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-metadata.png?w=1650\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=28f0d2b0af14f0a80c832b9be61256ac 1650w, https://mintcdn.com/cloocus/Nkm_21uSFcXx93n0/images/en/workspace/knowledge-metadata.png?w=2500\u0026fit=max\u0026auto=format\u0026n=Nkm_21uSFcXx93n0\u0026q=85\u0026s=bc109ac08f73a2881e8b3d8897f07dfb 2500w`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Badge color`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Green`})}),_jsx(_components.td,{children:`All filter fields have values`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Blue`})}),_jsx(_components.td,{children:`Required fields are filled; some optional fields are empty`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Orange`})}),_jsx(_components.td,{children:`A required field is empty`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Gray`})}),_jsx(_components.td,{children:`Nothing filled and no filter marked required`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`While AI extraction runs, an `,_jsx(_components.strong,{children:`“Extracting”`}),` badge replaces the count; with no filters defined, the badge doesn’t appear at all. Color is decided by `,_jsx(_components.strong,{children:`whether required fields are satisfied`}),`, not by how many are filled.`]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`When metadata changes, the vector index is updated automatically. Existing vectors are kept — no re-embedding required.`})}),`\n`,_jsx(Heading,{level:`3`,id:`ai-auto-extraction`,children:`AI Auto-Extraction`}),`\n`,_jsxs(_components.p,{children:[`When you set an `,_jsx(_components.strong,{children:`extraction prompt`}),` on the filter schema, the LLM analyzes document content and filename at upload time and auto-extracts metadata.`]}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Set extraction mode`,children:_jsxs(_components.p,{children:[`Click the `,_jsx(_components.strong,{children:`Manual / AI`}),` toggle in the filter schema and switch to AI mode.`]})}),_jsx(Step,{title:`Write the extraction prompt`,children:_jsx(_components.p,{children:`Write an extraction prompt for each filter.\nExample: “Extract the country name from the filename”`})}),_jsx(Step,{title:`Pick an AI model`,children:_jsx(_components.p,{children:`Select the LLM model for extraction.`})}),_jsx(Step,{title:`Run extraction`,children:_jsx(_components.p,{children:`Runs automatically on upload, or run single/all extraction manually.`})})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Auto-extraction`})}),_jsx(_components.td,{children:`Runs automatically right after upload (AI mode + an extraction hint present)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`AI Extract`})}),_jsx(_components.td,{children:`Re-extract just that file from the Metadata panel that opens when you click it`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Extract (N)`})}),_jsx(_components.td,{children:`Bulk-extract the checked files from the toolbar above the file list`})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`You can use “filename” as a condition in the extraction prompt.\nExample: “If the filename starts with [XX] (country code), extract that country code”`})}),`\n`,_jsx(Heading,{level:`3`,id:`filter-use-during-search`,children:`Filter Use During Search`}),`\n`,_jsx(_components.p,{children:`When a connected KB has dynamic filters, the AI auto-infers filter conditions from the user’s question to narrow search scope.`}),`\n`,_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Q: Show me the Finance team's 2024 policies`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`→ Filters auto-applied: department=Finance, year=2024`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`→ Searches only matching documents`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`tool-description`,children:`Tool Description`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Tool Description`}),`, at the top of the Knowledge Base detail screen, is the AI-only description that tells the agent `,_jsx(_components.strong,{children:`when and in what situations`}),` to search this Knowledge Base. The screen itself reads “Describe when the agent should search this knowledge base.”`]}),`\n`,_jsx(Accordion,{title:`Example of a good tool description`,id:`example-of-a-good-tool-description`,children:_jsx(CodeBlock,{numberOfLines:`3`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`3`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Use when there are questions about company HR policies and internal guidelines.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Reference for HR-related questions like leave, benefits, and travel policies.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),`\n`,_jsx(_components.p,{children:`If the tool description is empty, the KB’s general description is used instead. We recommend writing a specific one so the AI can pick the right Knowledge Base among many.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`AI auto-generation:`}),` Click the `,_jsx(_components.strong,{children:`AI`}),` button next to the tool description — it drafts the text from the KB name, description, file list, and filter info. The dropdown beside it picks the model used for generation.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Connect a Knowledge Base with an empty tool description to an agent and a `,_jsx(_components.strong,{children:`“Tool description is missing”`}),` warning appears above the knowledge list, naming the items involved. It still saves, but the agent has a harder time deciding when to use that Knowledge Base.`]})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The filter edit form has its own field also called `,_jsx(_components.strong,{children:`Agent Description`}),`. That one describes a `,_jsx(_components.strong,{children:`single filter`}),`; the tool description here describes the `,_jsx(_components.strong,{children:`whole Knowledge Base`}),`. The `,_jsx(_components.a,{href:`/en/workspace/knowledge-filters#tool-description-vs-per-filter-agent-description`,children:`Dynamic Filters Deep-Dive`}),` lays out the difference.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`knowledge-base-management`,children:`Knowledge Base Management`}),`\n`,_jsx(Heading,{level:`3`,id:`document-management`,children:`Document Management`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Action`}),_jsx(_components.th,{children:`Method`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Add document`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Add Content (+)`}),` button or drag-and-drop`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Delete document`})}),_jsx(_components.td,{children:`Select a document and click delete`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`View content`})}),_jsx(_components.td,{children:`Click a document to preview the extracted text`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Search`})}),_jsx(_components.td,{children:`Search by filename (server-side, fast even on large KBs)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Sort`})}),_jsx(_components.td,{children:`Newest (default) / Oldest / By name`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Review changes`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Activity History`}),` button at the top`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The file list uses `,_jsx(_components.strong,{children:`infinite scroll`}),` to load 50 entries at a time.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`File state badges:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Badge`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Failed`}),` (red)`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Processing failed — click Retry next to it`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Processing`}),` (orange)`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Processing in progress`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`Summary`}),` (toggle)`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Processed + summary available — click to view inline summary`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{style:{textAlign:`left`},children:[_jsx(_components.strong,{children:`N/M`}),` (fill badge)`]}),_jsx(_components.td,{style:{textAlign:`left`},children:`Metadata fill state, shown only when filters exist`})]})]})]}),`\n`,_jsxs(Note,{children:[_jsxs(_components.p,{children:[`Re-uploading a file with the same name shows a `,_jsx(_components.strong,{children:`duplicate confirmation dialog`}),`.`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Option`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Behavior`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Overwrite`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Delete the existing file and replace`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Skip`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Skip the duplicate, keep the existing file`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Cancel`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Cancel upload`})]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`reindexing`,children:`Reindexing`}),`\n`,_jsxs(_components.p,{children:[`To rebuild the vector index for the entire KB, run reindex from `,_jsx(_components.strong,{children:`Admin Panel > Settings > Documents`}),`. This is admin-only and processes all KBs at once.`]}),`\n`,_jsx(_components.p,{children:`When you edit and save an individual file’s content, only that file is automatically re-processed.`}),`\n`,_jsx(Heading,{level:`3`,id:`using-in-chat`,children:`Using in Chat`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`@ Command`,id:`%40-command`,children:[_jsxs(_components.p,{children:[`Reference directly during chat with `,_jsx(_components.code,{children:`@kb-name`}),`.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`@hr-policy What is the leave application process?`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Tab,{title:`Agent Connection`,id:`agent-connection`,children:_jsx(_components.p,{children:`When a Knowledge Base is connected in agent settings, it’s referenced automatically. Users just chat — no command needed.`})})]}),`\n`,_jsx(_components.p,{children:`Click citation numbers in the AI response to view the source content.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`document-processing-profile-selection`,children:`Document Processing Profile Selection`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`New feature`}),` — Apply different document processing strategies (extraction engine, chunking method, table preservation) per Knowledge Base.`]})}),`\n`,_jsxs(_components.p,{children:[`Choose one of the profiles defined by the admin in `,_jsx(_components.strong,{children:`Admin Panel > Settings > Documents`}),`. If you don’t pick one, the default profile applies.`]}),`\n`,_jsx(Heading,{level:`3`,id:`profile-use-cases`,children:`Profile Use Cases`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Knowledge Base`}),_jsx(_components.th,{children:`Recommended Profile`}),_jsx(_components.th,{children:`Reason`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`HR policy (text PDF)`}),_jsx(_components.td,{children:`Default Extraction`}),_jsx(_components.td,{children:`Plain text, no extra cost`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Financial report (many tables)`}),_jsx(_components.td,{children:`Table Preservation enabled`}),_jsx(_components.td,{children:`Improves table data search accuracy`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Scanned documents (image PDF)`}),_jsx(_components.td,{children:`LLM Vision`}),_jsx(_components.td,{children:`Accurately extracts text inside images`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Technical docs (long reports)`}),_jsx(_components.td,{children:`Semantic Chunking + Context Preservation`}),_jsx(_components.td,{children:`Topic-based separation + preserved opening context`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Only admins can create profiles. If a needed profile is missing, ask your admin. See `,_jsx(_components.a,{href:`/en/admin/settings/documents#document-processing-profiles`,children:`Admin Panel > Settings > Documents`}),` for profile setup.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`advanced-settings`,children:`Advanced Settings`}),`\n`,_jsx(_components.p,{children:`Adjust document processing and search parameters in admin settings.`}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`These settings are `,_jsx(_components.strong,{children:`global defaults for KBs without a Document Processing Profile`}),`. KBs with a profile use the profile settings instead.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`content-extraction-engine`,children:`Content Extraction Engine`}),`\n`,_jsx(_components.p,{children:`Choose the engine for extracting text from documents in admin settings.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Engine`}),_jsx(_components.th,{children:`Strengths`}),_jsx(_components.th,{children:`Best For`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default (PyPDF/Langchain)`})}),_jsx(_components.td,{children:`No setup needed`}),_jsx(_components.td,{children:`Plain-text PDF, DOCX`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Tika`})}),_jsx(_components.td,{children:`Server required, supports many formats`}),_jsx(_components.td,{children:`Mixed file formats`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Docling`})}),_jsx(_components.td,{children:`Server required`}),_jsx(_components.td,{children:`Complex layout documents`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Azure Document Intelligence`})}),_jsx(_components.td,{children:`Azure subscription required, high-precision OCR`}),_jsx(_components.td,{children:`Scanned documents, table-heavy PDFs`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Mistral OCR`})}),_jsx(_components.td,{children:`Mistral API required`}),_jsx(_components.td,{children:`PDF OCR`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Google Cloud Document AI`})}),_jsx(_components.td,{children:`GCP subscription required`}),_jsx(_components.td,{children:`Documents with embedded images`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`LLM Vision`})}),_jsx(_components.td,{children:`Vision LLM-based, high precision`}),_jsx(_components.td,{children:`Complex layouts, charts`})]})]})]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Image files (PNG, JPG, etc.)`}),` are not text-indexed by default — they are stored but their contents are not searchable. To search text inside images, set the knowledge base’s document processing profile to `,_jsx(_components.strong,{children:`Google Cloud Document AI`}),` or `,_jsx(_components.strong,{children:`LLM Vision`}),`. (Azure Document Intelligence and Mistral OCR handle PDF and Office documents but do not support standalone image files.)`]})}),`\n`,_jsx(Heading,{level:`3`,id:`document-processing-profile-options`,children:`Document Processing Profile Options`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Name`})}),_jsx(_components.td,{children:`Enter the document processing profile name`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default Engine`})}),_jsx(_components.td,{children:`Engine used for files whose extension has no engine mapping`}),_jsx(_components.td,{children:`built-in engine`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Extension → Engine Mapping`})}),_jsx(_components.td,{children:`Use the selected engine for specific registered extensions`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`-`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Text Splitter`})}),_jsx(_components.td,{children:`Choose how to split text (default, token, semantic)`}),_jsx(_components.td,{children:`Default (character)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Preserve Tables`})}),_jsx(_components.td,{children:`Keep tables attached to the preceding text chunk instead of splitting them during chunking`}),_jsx(_components.td,{children:`Enabled`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Contextual Chunking`})}),_jsx(_components.td,{children:`Add a per-chunk context summary to improve search accuracy`}),_jsx(_components.td,{children:`See the note below`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[`Contextual chunking only takes effect when a `,_jsx(_components.code,{children:`Context Model`}),` is also selected.`]}),` On a new profile the switch appears on, but the model is empty so nothing is applied. Pick a model and save to use it. It also does not apply to files attached ad hoc in chat — only to documents loaded into a knowledge base.`]})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Text Splitter options:`})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`}),_jsx(_components.th,{children:`Applies To`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Chunk Size`})}),_jsx(_components.td,{children:`Document split unit (characters)`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`1,000`}),_jsx(_components.td,{children:`Default (character), Token`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Chunk Overlap`})}),_jsx(_components.td,{children:`Overlapping characters between chunks`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`100`}),_jsx(_components.td,{children:`Default (character), Token, Semantic`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Min Tokens per Chunk`})}),_jsx(_components.td,{children:`Minimum characters to form a chunk`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`-`}),_jsx(_components.td,{children:`Default (character), Token, Semantic`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Max Tokens per Chunk`})}),_jsx(_components.td,{children:`Maximum characters to form a chunk`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`-`}),_jsx(_components.td,{children:`Default (character), Token, Semantic`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Threshold Type`})}),_jsx(_components.td,{children:`Type of similarity criterion for splitting chunks`}),_jsx(_components.td,{style:{textAlign:`center`},children:`Percentile (recommended)`}),_jsx(_components.td,{children:`Semantic`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Threshold`})}),_jsx(_components.td,{children:`Split-decision threshold per threshold type`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`center`},children:`-`}),_jsx(_components.td,{children:`Semantic`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`embedding-engine`,children:`Embedding Engine`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Engine`}),_jsx(_components.th,{children:`Strengths`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Default (SentenceTransformers)`})}),_jsx(_components.td,{children:`No external transmission, strong security`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Ollama`})}),_jsx(_components.td,{children:`Local server, custom models`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`OpenAI`})}),_jsx(_components.td,{children:`High quality, API costs`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Azure OpenAI`})}),_jsx(_components.td,{children:`Optimized for enterprise`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Gemini`})}),_jsx(_components.td,{children:`Google embedding model, GCP integration`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Vertex AI`})}),_jsx(_components.td,{children:`GCP managed embedding service`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`search-settings`,children:`Search Settings`}),`\n`,_jsxs(_components.p,{children:[`Search settings have two layers — `,_jsx(_components.strong,{children:`global`}),` (admin) and `,_jsx(_components.strong,{children:`per-KB`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Top K`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`Global setting`}),_jsx(_components.td,{children:`Chunks to retrieve via vector search`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Reranker Top K`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`Global setting`}),_jsx(_components.td,{children:`Final chunks after reranking`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Reranker Threshold`})}),_jsx(_components.td,{style:{textAlign:`center`},children:`Global setting`}),_jsx(_components.td,{children:`Minimum reranker score (lower = more pass through)`})]})]})]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Override search settings per Knowledge Base. Click the `,_jsx(_components.strong,{children:`Search Settings`}),` icon on the KB edit screen.\nAll three `,_jsx(_components.strong,{children:`fall back to the global setting when left empty`}),` — the greyed-out number in each field is the global value currently in effect.\nReview or change it under `,_jsx(_components.strong,{children:_jsx(_components.a,{href:`/en/admin/settings/search-engine`,children:`Admin › Settings › Search Engine`})}),`.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`per-kb-document-summary-settings`,children:`Per-KB Document Summary Settings`}),`\n`,_jsxs(_components.p,{children:[`Control `,_jsx(_components.strong,{children:`document summary generation`}),` per KB. Configure under the `,_jsx(_components.strong,{children:`“File Summary”`}),` section in the search settings modal.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Setting`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Description`}),_jsx(_components.th,{style:{textAlign:`center`},children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Enable File Summary`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Auto-generate AI summary on file processing completion`}),_jsx(_components.td,{style:{textAlign:`center`},children:`On`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.strong,{children:`Summary Model`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`LLM model for summarization`}),_jsx(_components.td,{style:{textAlign:`center`},children:`Uses Task Model`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`For files with summaries, click the `,_jsx(_components.strong,{children:`“Summary”`}),` toggle in the list to view inline.`]}),`\n`,_jsx(Heading,{level:`3`,id:`question-generation-multi-vector-search`,children:`Question Generation (Multi-Vector Search)`}),`\n`,_jsxs(_components.p,{children:[`When question generation is enabled, the LLM pre-generates `,_jsx(_components.strong,{children:`“questions a user might ask to find this content”`}),` for each chunk and stores them as separate vectors.`]}),`\n`,_jsx(Mermaid,{chart:`flowchart LR\n A[Document chunk] --> B[Content vector]\n A --> C[LLM generates expected questions]\n C --> D[Question vectors]\n E[User question] --> F{Search}\n B --> F\n D --> F\n F --> G[Weighted result]`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`State`}),_jsx(_components.th,{children:`Search Method`}),_jsx(_components.th,{children:`Effect`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Disabled`}),_jsx(_components.td,{children:`Content vectors only`}),_jsx(_components.td,{children:`Standard search`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enabled`}),_jsx(_components.td,{children:`Weighted sum of content + question vectors`}),_jsx(_components.td,{children:`Improved accuracy with user-question-style phrasing`})]})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Enabling question generation adds LLM calls during document processing. Processing time and cost may increase.`})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Configure question generation per KB independently of the global setting. Use the `,_jsx(_components.strong,{children:`“Question Generation”`}),` section in the search settings modal to enable/disable and select the LLM model.`]})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`best-practices`,children:`Best Practices`}),`\n`,_jsx(Heading,{level:`3`,id:`document-preparation`,children:`Document Preparation`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Clean format`}),`: Distinguish titles and subheadings clearly with consistent styling`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Keep current`}),`: Update documents regularly and remove old ones`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Right size`}),`: Split large documents by topic and group related content together`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`knowledge-base-composition`,children:`Knowledge Base Composition`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Separate by topic`}),`: Create separate KBs for “HR Policy”, “IT Guide”, “Product Manual”, etc.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Granular access`}),`: Manage sensitive info separately and restrict access by department`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Write tool descriptions`}),`: A specific tool description helps agents auto-pick the right KB`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsxs(AccordionGroup,{children:[_jsxs(Accordion,{title:`New Employee Onboarding`,icon:`user-plus`,id:`new-employee-onboarding`,children:[_jsx(_components.p,{children:`Build Knowledge Bases of HR policy, work manuals, and IT guides so new hires can adapt quickly by asking the AI.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Knowledge Bases: “HR Policy”, “Work Manual”, “IT Usage Guide”`}),`\n`,_jsx(_components.li,{children:`Connect 3 KBs to the agent`}),`\n`,_jsx(_components.li,{children:`Differentiate KB purposes via tool descriptions`}),`\n`]})]}),_jsxs(Accordion,{title:`Customer Support Automation`,icon:`headset`,id:`customer-support-automation`,children:[_jsx(_components.p,{children:`Build Knowledge Bases of product manuals, FAQs, and technical docs to provide accurate answers to customer inquiries.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Dynamic filters: filter by product name, version`}),`\n`,_jsx(_components.li,{children:`Agent: customer-support system prompt + Knowledge Base connection`}),`\n`,_jsx(_components.li,{children:`Use citation display to ensure trust`}),`\n`]})]}),_jsxs(Accordion,{title:`Per-Department Policy Management`,icon:`building`,id:`per-department-policy-management`,children:[_jsx(_components.p,{children:`Classify per-department documents with dynamic filters and search the right policies by department.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Dynamic filters: department, year, document type`}),`\n`,_jsx(_components.li,{children:`AI auto-extraction for metadata`}),`\n`,_jsx(_components.li,{children:`Access control to protect sensitive documents`}),`\n`]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`faq`,children:`FAQ`}),`\n`,_jsxs(AccordionGroup,{children:[_jsx(Accordion,{title:`Are there KB capacity limits?`,icon:`circle-question`,id:`are-there-kb-capacity-limits`,children:_jsx(_components.p,{children:`By default, there’s no limit on file count or capacity. Admins can set limits via environment variables.`})}),_jsx(Accordion,{title:`What happens if I re-upload the same file?`,icon:`circle-question`,id:`what-happens-if-i-re-upload-the-same-file`,children:_jsxs(_components.p,{children:[`When a file with the same name is detected, a `,_jsx(_components.strong,{children:`duplicate confirmation dialog`}),` appears with Overwrite, Skip, or Cancel options.`]})}),_jsx(Accordion,{title:`Is text inside PDF images recognized?`,icon:`circle-question`,id:`is-text-inside-pdf-images-recognized`,children:_jsxs(_components.p,{children:[`The default extraction engine extracts text from images embedded in PDFs to a limited degree, but for scanned documents or image-heavy PDFs, `,_jsx(_components.strong,{children:`Azure Document Intelligence`}),`, `,_jsx(_components.strong,{children:`Google Cloud Document AI`}),`, or `,_jsx(_components.strong,{children:`LLM Vision`}),` engines are much more accurate. To upload a standalone image file (PNG/JPG) and search its text, a Google Cloud Document AI or LLM Vision profile is required. Check the extraction engine setting with your admin.`]})}),_jsx(Accordion,{title:`Does changing dynamic filter metadata require re-embedding?`,icon:`circle-question`,id:`does-changing-dynamic-filter-metadata-require-re-embedding`,children:_jsx(_components.p,{children:`No. Metadata changes only update the vector index’s filter fields; existing vectors stay intact. Processed quickly without re-embedding.`})}),_jsxs(Accordion,{title:`What happens to search settings when multiple KBs are connected to one agent?`,icon:`circle-question`,id:`what-happens-to-search-settings-when-multiple-kbs-are-connected-to-one-agent`,children:[_jsx(_components.p,{children:`When multiple KBs are connected, search settings merge as follows:`}),_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Top K, Reranker Top K`}),`: Use the `,_jsx(_components.strong,{children:`largest value`}),` across KBs`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Reranker Threshold`}),`: Use the `,_jsx(_components.strong,{children:`lowest value`}),` across KBs (more results pass)`]}),`\n`]})]}),_jsx(Accordion,{title:`Does changing the Document Processing Profile affect existing documents?`,icon:`circle-question`,id:`does-changing-the-document-processing-profile-affect-existing-documents`,children:_jsx(_components.p,{children:`Existing documents’ vectors are not auto-reprocessed when the profile changes. To apply the new profile to existing documents, delete and re-upload them, or run a full reindex from admin settings.`})}),_jsxs(Accordion,{title:`What's the cost of LLM Vision or Context Preservation?`,icon:`circle-question`,id:`whats-the-cost-of-llm-vision-or-context-preservation`,children:[_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`LLM Vision`}),`: page count × 1 LLM call + 1 heading-level normalization call`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Context Preservation`}),`: chunk count × 1 LLM call`]}),`\n`]}),_jsx(_components.p,{children:`For a 10-page PDF + 20 chunks: LLM Vision (11 calls) + Context Preservation (20 calls) ≈ 31 LLM calls. Bulk uploading large documents can cost a lot, so use selectively for important docs.`})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`related-pages`,children:`Related Pages`}),`\n`,_jsxs(Columns,{cols:2,children:[_jsx(Card,{title:`Dynamic Filters Deep-Dive`,icon:`filter`,href:`/en/workspace/knowledge-filters`,children:_jsx(_components.p,{children:`Filter internals, Manual vs AI, the 5-step search flow`})}),_jsx(Card,{title:`Knowledge Graph`,icon:`share-nodes`,href:`/en/workspace/knowledge-graph`,children:_jsx(_components.p,{children:`Connect Knowledge Bases + glossaries + DBs into one graph`})}),_jsx(Card,{title:`Agents`,icon:`robot`,href:`/en/workspace/agents`,children:_jsx(_components.p,{children:`Connect a Knowledge Base to an agent`})}),_jsx(Card,{title:`Glossary`,icon:`book`,href:`/en/workspace/glossary`,children:_jsx(_components.p,{children:`Improve AI understanding by defining domain terms`})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Knowledge Base","description":"Building and managing Knowledge Bases — document upload, RAG pipeline, dynamic filters, AI metadata extraction","href":"/en/workspace/knowledge"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Example","slug":"example","depth":3,"children":[]},{"title":"Collections and Libraries","slug":"collections-and-libraries","depth":2,"children":[{"title":"Working with a Library","slug":"working-with-a-library","depth":3,"children":[]}]},{"title":"RAG Pipeline","slug":"rag-pipeline","depth":2,"children":[]},{"title":"Creating a Knowledge Base","slug":"creating-a-knowledge-base","depth":2,"children":[{"title":"Supported File Formats","slug":"supported-file-formats","depth":3,"children":[]},{"title":"Max Size / Count","slug":"max-size-/-count","depth":4,"children":[]}]},{"title":"Dynamic Filters","slug":"dynamic-filters","depth":2,"children":[{"title":"Defining the Filter Schema","slug":"defining-the-filter-schema","depth":3,"children":[]},{"title":"Filter Types","slug":"filter-types","depth":3,"children":[]},{"title":"Per-File Metadata Settings","slug":"per-file-metadata-settings","depth":3,"children":[]},{"title":"AI Auto-Extraction","slug":"ai-auto-extraction","depth":3,"children":[]},{"title":"Filter Use During Search","slug":"filter-use-during-search","depth":3,"children":[]}]},{"title":"Tool Description","slug":"tool-description","depth":2,"children":[]},{"title":"Knowledge Base Management","slug":"knowledge-base-management","depth":2,"children":[{"title":"Document Management","slug":"document-management","depth":3,"children":[]},{"title":"Reindexing","slug":"reindexing","depth":3,"children":[]},{"title":"Using in Chat","slug":"using-in-chat","depth":3,"children":[]}]},{"title":"Document Processing Profile Selection","slug":"document-processing-profile-selection","depth":2,"children":[{"title":"Profile Use Cases","slug":"profile-use-cases","depth":3,"children":[]}]},{"title":"Advanced Settings","slug":"advanced-settings","depth":2,"children":[{"title":"Content Extraction Engine","slug":"content-extraction-engine","depth":3,"children":[]},{"title":"Document Processing Profile Options","slug":"document-processing-profile-options","depth":3,"children":[]},{"title":"Embedding Engine","slug":"embedding-engine","depth":3,"children":[]},{"title":"Search Settings","slug":"search-settings","depth":3,"children":[]},{"title":"Per-KB Document Summary Settings","slug":"per-kb-document-summary-settings","depth":3,"children":[]},{"title":"Question Generation (Multi-Vector Search)","slug":"question-generation-multi-vector-search","depth":3,"children":[]}]},{"title":"Best Practices","slug":"best-practices","depth":2,"children":[{"title":"Document Preparation","slug":"document-preparation","depth":3,"children":[]},{"title":"Knowledge Base Composition","slug":"knowledge-base-composition","depth":3,"children":[]}]},{"title":"Use Cases","slug":"use-cases","depth":2,"children":[]},{"title":"FAQ","slug":"faq","depth":2,"children":[]},{"title":"Related Pages","slug":"related-pages","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/cloocus/45db6ee3c57396cb/toc.js","/_mintlify/custom/cloocus/9670a2c81dc38d5e/tools/playwright-video-mcp/index.js","/_mintlify/custom/cloocus/4540e1c308555295/lang-toggle.js"],"subdomain":"cloocus","siteName":"Cloosphere Guide","title":"Knowledge Base - Cloosphere Guide","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"ko":{"href":"/ko/workspace/knowledge","matchLevel":1},"en":{"href":"/en/workspace/knowledge","matchLevel":0}}},"lastModified":"2026-08-26T04:23:58.428Z","originalFileLocation":"en/workspace/knowledge.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Building and managing Knowledge Bases — document upload, RAG pipeline, dynamic filters, AI metadata extraction\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Knowledge Base - Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:description\" content=\"Building and managing Knowledge Bases — document upload, RAG pipeline, dynamic filters, AI metadata extraction\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.cloosphere.ai/en/workspace/knowledge\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=Knowledge+%26+Data\u0026amp;title=Knowledge+Base\u0026amp;description=Building+and+managing+Knowledge+Bases+%E2%80%94+document+upload%2C+RAG+pipeline%2C+dynamic+filters%2C+AI+metadata+extraction\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=8b1c65193fe09687b0671d31394da0935d5cd3c3725f4577aab7ca1ce7da068f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Knowledge Base - Cloosphere Guide\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Building and managing Knowledge Bases — document upload, RAG pipeline, dynamic filters, AI metadata extraction\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cloocus.mintlify.site/_mintlify/api/og/v2?division=Knowledge+%26+Data\u0026amp;title=Knowledge+Base\u0026amp;description=Building+and+managing+Knowledge+Bases+%E2%80%94+document+upload%2C+RAG+pipeline%2C+dynamic+filters%2C+AI+metadata+extraction\u0026amp;theme=97296152c031fdcf5b54d0af\u0026amp;signature=8b1c65193fe09687b0671d31394da0935d5cd3c3725f4577aab7ca1ce7da068f\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/cloocus/WlRjtofBr-j1DZPc/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cloosphere Guide\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5f22d0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.cloosphere.ai/en/workspace/knowledge\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/workspace/knowledge.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.cloosphere.ai/en/workspace/knowledge\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.cloosphere.ai/ko/workspace/knowledge\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.cloosphere.ai/ko/workspace/knowledge\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.cloosphere.ai/#organization\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cloocus/uXAlvLAzCJlwDYsB/images/logo.png?fit=max\u0026auto=format\u0026n=uXAlvLAzCJlwDYsB\u0026q=85\u0026s=93fb26230c58b4ba9411c3e97e20b439\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.cloosphere.ai#website\",\"name\":\"Cloosphere Guide\",\"url\":\"https://docs.cloosphere.ai\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.cloosphere.ai/en/workspace/knowledge#webpage\",\"url\":\"https://docs.cloosphere.ai/en/workspace/knowledge\",\"name\":\"Knowledge Base\",\"description\":\"Building and managing Knowledge Bases — document upload, RAG pipeline, dynamic filters, AI metadata extraction\",\"dateModified\":\"2026-08-26T04:23:58.428Z\",\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.cloosphere.ai/en/workspace/knowledge#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.cloosphere.ai/en/workspace/knowledge#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Cloosphere Guide\",\"item\":\"https://docs.cloosphere.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Knowledge Base\",\"item\":\"https://docs.cloosphere.ai/en/workspace/knowledge\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.cloosphere.ai/en/workspace/knowledge#article\",\"headline\":\"Knowledge Base\",\"name\":\"Knowledge Base\",\"description\":\"Building and managing Knowledge Bases — document upload, RAG pipeline, dynamic filters, AI metadata extraction\",\"url\":\"https://docs.cloosphere.ai/en/workspace/knowledge\",\"mainEntityOfPage\":{\"@id\":\"https://docs.cloosphere.ai/en/workspace/knowledge#webpage\"},\"dateModified\":\"2026-08-26T04:23:58.428Z\",\"publisher\":{\"@id\":\"https://docs.cloosphere.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.cloosphere.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cloosphere Guide\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cloosphere Guide\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/workspace/knowledge.md","siteName":"Cloosphere Guide","nav":{"global":null,"languages":[{"language":"ko","default":true,"pages":[{"title":"ko","href":"/ko/workspace/knowledge"}]},{"language":"en","tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/en"}]},{"tab":"Chat","icon":"comments","pages":[{"title":"Chat","href":"/en/chat/overview"}]},{"tab":"Workspace","icon":"briefcase","groups":[{"group":"Workspace","pages":[{"title":"Workspace","href":"/en/workspace/overview"}]},{"group":"AI Agents","pages":[{"title":"Agents","href":"/en/workspace/agents"},{"title":"Agent Flow","href":"/en/workspace/flows"},{"title":"Flow Node Reference","description":"Reference for the 13 nodes available in the Agent Flow canvas — settings, behavior, and State key conventions","href":"/en/workspace/flows-nodes"}]},{"group":"Knowledge \u0026 Data","pages":[{"title":"Knowledge Base","href":"/en/workspace/knowledge"},{"title":"Dynamic Filters Deep-Dive","description":"Internal mechanics of Knowledge Base dynamic filters, Manual vs AI comparison, and the agent auto-filtering flow","href":"/en/workspace/knowledge-filters"},{"title":"Knowledge Graph","href":"/en/workspace/knowledge-graph"},{"title":"Database","href":"/en/workspace/database"},{"title":"Glossary","href":"/en/workspace/glossary"}]},{"group":"Safety","pages":[{"title":"Guardrails","href":"/en/workspace/guardrails"}]},{"group":"Customization","pages":[{"title":"Prompts","href":"/en/workspace/prompts"},{"title":"Skills","href":"/en/workspace/skills"},{"title":"Tools","href":"/en/workspace/tools"},{"title":"Marketplace","href":"/en/workspace/marketplace"},{"title":"Tags","href":"/en/workspace/tags"}]}]},{"tab":"Collaboration","icon":"users","pages":[{"title":"Collaboration","href":"/en/collaboration/overview"}]},{"tab":"Automation","icon":"clock","pages":[{"title":"Automation","href":"/en/automation/overview"}]},{"tab":"Admin","icon":"gear","pages":[{"title":"Admin","href":"/en/admin/overview"}]},{"tab":"Monitoring","icon":"chart-line","pages":[{"title":"Monitoring","href":"/en/monitoring/overview"}]},{"tab":"Resources","icon":"screwdriver-wrench","pages":[{"title":"Resources","href":"/en/admin/deployment-checklist"}]}]}]},"basePath":"","title":"Knowledge Base - Cloosphere Guide","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}