> For the complete documentation index, see [llms.txt](https://docs.clickai.vn/clickai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clickai.vn/clickai-docs/clickai-docs-en/database/manage-knowledge-content-documents-and-chunks.md). # Manage Knowledge Content — Documents & Chunks ## Table of Contents · \[Manage Documents]\(#manage-documents) · \[Manage Chunks]\(#manage-chunks) · \[Best Practices]\(#best-practices) ## Manage Documents On the Knowledge Base detail page, you can manage all uploaded documents: ### Document Actions
ActionDescription
ViewView all documents, processing status, and details
AddUpload new documents to the Knowledge Base
Enable / DisableToggle documents. Disabled documents won't be retrieved but are still stored
ArchiveArchive documents no longer frequently used
DeletePermanently delete documents from the Knowledge Base
Re-indexRe-index documents when settings are changed
### Document Status
StatusDescription
QueuingWaiting to be processed
ProcessingBeing chunked and indexed
AvailableReady for retrieval
ErrorProcessing failed — click for details
DisabledTurned off — excluded from retrieval
ArchivedArchived
💡 TIP: Use Enable/Disable instead of Delete when you want to temporarily remove documents from retrieval. You can re-enable them anytime without re-uploading. ## Manage Chunks Click on a document to view and manage its chunks: ### Chunk Actions
ActionDescription
ViewView detailed chunk content
EditModify chunk content
AddManually add a new chunk
Enable / DisableToggle individual chunks
DeleteDelete a chunk
Add ImageAttach images to a chunk
### Notes on Editing Chunks With Parent-Child Mode: · When editing a parent chunk, you can choose to regenerate its child chunks or keep them unchanged · Editing a child chunk does not update its parent chunk ⚠️ IMPORTANT: When editing chunks, new content is re-embedded automatically. However, test retrieval after editing to ensure results remain accurate. ## Best Practices ### Check Chunk Quality After creating a Knowledge Base, review chunks to identify issues: · Chunks too short — May lack sufficient context, leading to semantic loss and inaccurate answers · Chunks too long — May include irrelevant information, introducing semantic noise and lowering retrieval precision · Semantically incomplete chunks — Caused by forced chunking that cuts through sentences or paragraphs ### Use Child Chunks as Retrieval Hooks for Parent Chunks In Parent-Child mode, child chunks serve as "hooks" — retrieval entry points, after which the parent chunk provides fuller context. Effective child chunk types:
TypeExample
Keywordsblinking light, won't turn on, red light, connection error, frozen
SummariesGuide to interpreting LED colors and troubleshooting hardware issues
QueriesWhat does a solid red light mean?
### Use Summaries to Bridge Query-Content Gaps Summaries are especially useful when: · User queries differ from document language: Add summaries in the way users actually ask questions · Concepts are implicit or buried in details: Add high-level summaries that surface core concepts · Raw text is non-textual: When a chunk is primarily code, tables, or logs — add descriptive summaries · Related chunks should be retrieved together: Apply identical summaries for grouped retrieval *📖 Previous: \[External Knowledge API]\(./07-external-knowledge-api.md) · Next: \[Metadata]\(./09-metadata.md)* --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.clickai.vn/clickai-docs/clickai-docs-en/database/manage-knowledge-content-documents-and-chunks.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.