docs/guides/knowledge_compilation/apply_knowledge_compilation_template.md
After creating a template, you need to reference the template in an Ingestion Pipeline.
Configuration steps:
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.
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.
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:
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.
After viewing a knowledge artifact, you can use the To Skills feature to further organize and convert the artifact into reusable Skills that can be used by agents.
Steps:
The generated Skill typically includes a name, description, and rules, methods, or instructions extracted and organized from the knowledge artifact, which can be used by agents when performing relevant tasks.
Note
To Skills does not modify the original knowledge artifact. Instead, it generates reusable Skills based on the existing knowledge artifact.
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. |
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:
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.