Apply a Knowledge Compilation Template
Configure the Ingestion Pipeline
After creating a template, you need to reference the template in an Ingestion Pipeline.
Configuration steps:
- Create or open an Ingestion Pipeline.
- Add and connect Parser, Chunker, Compiler, and Indexer.
- Open CompilerOperator and select the target CompilationTemplate from the template list.
- Check node connections and required parameters, and then save the Pipeline.
Note: CompilationTemplate only defines "how to compile". A KnowledgeArtifact is generated only after the template is referenced in CompilerOperator and the document actually executes this Pipeline.
Apply the Pipeline in Dataset
- Go to the Dataset page and create a Dataset or open an existing Dataset.
- Upload the documents to process.
- In the file list, select Configure Ingestion Pipeline.
- Select the Ingestion Pipeline that contains CompilerOperator.
- Start parsing and check in the task logs whether Parser, Chunker, Compiler, and Indexer complete in sequence.
If CompilationTemplate is modified, completed documents are not automatically recompiled. You need to reparse or rerun the Pipeline according to the operations currently provided by the product before the new configuration can be applied.
View Knowledge Artifacts
After knowledge compilation is complete, enter the corresponding knowledge base and select Artifacts from the left sidebar. In the upper-right corner of the Artifacts page, select the artifact type you want to view from the drop-down list, such as Wiki, To Skills, Tree/Page index, Graph, Mind map, or Timeline, to view the corresponding generated results.
Knowledge artifacts can be divided by generation scope into document-level and knowledge-base-level artifacts:
- Document-level knowledge artifacts: Graph, Tree, PageIndex, MindMap, and Timeline can generate corresponding document-level results during document knowledge compilation and can be viewed in Artifacts.
- Knowledge-base-level knowledge artifacts: Some knowledge artifacts support further generation of knowledge-base-level results based on documents in the knowledge base. After executing a knowledge-base-level generation task, you can view the generated results in Artifacts. Wiki is generated as a knowledge-base-level artifact. After knowledge compilation for related documents is complete, you need to go to the Artifacts page of the knowledge base and click generate. The system then generates Wiki based on the compilation results in the current knowledge base.
Graph can also be further generated as a knowledge-base-level knowledge artifact through knowledge-base-level generation operations after document-level knowledge compilation is complete.
When a knowledge-base-level knowledge artifact generation task is executed, the system generates corresponding knowledge-base-level logs. You can use the logs to view the task execution status and related runtime information. When a generation task fails or the result is abnormal, check it together with the log information.
Knowledge Artifact Check
After knowledge artifacts are generated, check the generated results based on the template used and confirm whether the content and structure meet expectations.
For different knowledge artifact types, focus on the following checks:
| Type | Check Focus |
|---|---|
| Graph | Whether entities are duplicated; whether relationship directions are correct; whether there are unsupported nodes or edges. |
| Tree | Whether the hierarchy is clear; whether peer nodes are at similar abstraction levels; whether summaries are accurate. |
| PageIndex | Whether chapter hierarchy is preserved; whether facts and conclusions come from the corresponding chapters. |
| MindMap | Whether the central topic is clear; whether branches are duplicated or crossed; whether node names are concise. |
| Timeline | Whether time is accurate; whether event order is correct; whether relative time is misinterpreted. |
| Wiki | Whether page topics are reasonable; whether links between pages are valid; whether facts are consistent with sources. |
Update Knowledge Artifacts
After knowledge artifacts are generated, the system continuously detects document changes in the knowledge base. When documents are added to or removed from the knowledge base, the corresponding knowledge artifacts are not automatically regenerated. Instead, an update prompt is displayed to remind users to synchronize the latest knowledge base content.
When document changes are detected, an Update button appears in the upper-left corner of the knowledge artifact page, and the number of documents to update is displayed next to the button.
Hover over the update prompt area to view the specific document changes:
- New documents: Documents uploaded to the knowledge base after the knowledge artifact was generated and not yet included in the current knowledge artifact.
- Removed documents: Documents deleted from the knowledge base after the knowledge artifact was generated, but whose related content has not yet been synchronized and removed from the current knowledge artifact.
- Number indicator: Indicates the current number of documents detected as pending update.
After confirming that synchronization is needed, click Update. The system updates the knowledge artifact based on the current document changes in the knowledge base, keeping it consistent with the latest documents in the knowledge base.
Note: Uploading or deleting knowledge base documents alone does not immediately update existing knowledge artifacts. After the update prompt appears, you need to manually click Update to complete synchronization.