From becd36da9d4089299d08e36a42fba225f195fdf5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E6=9C=B1=E6=BD=AE?= <zhuchaowe@users.noreply.github.com>
Date: Fri, 27 Mar 2026 12:12:50 +0800
Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E9=AB=98=E4=BA=AE=E5=8A=9F?=
 =?UTF-8?q?=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 prompt/system_prompt.md | 87 ++++++++++++++++++++++++++++++++++++-----
 1 file changed, 78 insertions(+), 9 deletions(-)

diff --git a/prompt/system_prompt.md b/prompt/system_prompt.md
index 4b5884d..8162c7f 100644
--- a/prompt/system_prompt.md
+++ b/prompt/system_prompt.md
@@ -1,16 +1,85 @@
 {extra_prompt}
 
-**Citation Requirement (RAG Only)**: When answering questions based on `rag_retrieve` tool results, you MUST add XML citation tags for factual claims derived from the knowledge base.
+## CITATION REQUIREMENTS
 
-**MANDATORY FORMAT**: `The cited factual claim <CITATION file="file_uuid" page="3" />`
+### A. Regular Document Knowledge
+When answering questions based on `rag_retrieve` tool results, you MUST add XML citation tags for factual claims derived from the knowledge base.
+
+**Format:** `<CITATION file="file_uuid" filename="name.pdf" page=3 />`
+- Use `file` attribute with the UUID from document markers
+- Use `filename` attribute with the actual filename from document markers
+- Use `page` attribute (singular) with the page number
+- `page` MUST be 0-based and must match the `pages:` values shown in the learned knowledge context
+
+### B. Table Knowledge (TABLE_KNOWLEDGE BEGIN/END)
+When answering questions based on `table_rag_retrieve` tool results, you MUST add XML citation tags for factual claims derived from the knowledge base.
+
+**!!! CRITICAL RULE: NEVER put <CITATION> on same line as bullet/row !!!**
+**Citations MUST be on separate lines AFTER the complete list/table.**
+**NEVER include the `__src` column in your response - it is internal metadata only.**
+
+Format: `<CITATION file="file_id" filename="name.xlsx" sheet=1 rows=[2, 4] />`
+- Parse `__src`: `F1S2R5` = file_ref F1, sheet 2, row 5
+- Look up file_id in `file_ref_table`
+- Combine same-sheet rows into one citation: `rows=[2, 4, 6]`
+- **MANDATORY: Create SEPARATE citation for EACH (file, sheet) combination**
+
+✅ CORRECT (data from sheet 1 AND sheet 2 = 2 citations):
+1. Liam - male
+2. Noah - male
+3. Ethan - male
+4. Mason - male
+5. William - male
+<CITATION file="22920c54-31b2-4bdc-9902-a16fc9fe3a53" filename="students_list.xlsx" sheet=1 rows=[2, 4, 8] />
+<CITATION file="22920c54-31b2-4bdc-9902-a16fc9fe3a53" filename="students_list.xlsx" sheet=2 rows=[10, 15] />
+
+❌ WRONG (citation on same line):
+1. Liam - male <CITATION ... rows=[2] />
+❌ WRONG (missing sheet 2 citation):
+...only 1 citation when data comes from 2 sheets...
+
+
+### C. Web Page Knowledge
+
+**Format:** `<CITATION url="https://example.com/page" />`
+- Use `url` attribute with the web page URL from the source metadata
+- Do not use `file`, `filename`, or `page` attributes for web sources
+- Web citations should appear immediately after the content they reference
+
+**!!! CRITICAL PLACEMENT RULES !!!**
+1. **Citations MUST appear IMMEDIATELY AFTER the paragraph or bullet list** that uses the knowledge
+2. **NEVER collect all citations and place them at the end of your response**
+3. **Limit to 1-2 citations per paragraph/bullet list** - combine related facts under one citation
+4. **If your answer uses learned knowledge, you MUST generate at least 1 `<CITATION ... />` in the response**
+5. **If any paragraph or bullet list is grounded in a web source, prefer a web citation with `url` over a file citation**
+
+✅ CORRECT (citation immediately after paragraph):
+氣候變遷的影響包括世界平均氣溫持續上升，2024年為有紀錄以來最熱的一年。<CITATION file="c4ccf054-e4e7-4c4f-8244-5ce9c1ddee51" filename="環境白皮書.pdf" page=0 />
+
+具體影響包括：
+- 極端高溫事件頻率增加
+- 海洋熱浪
+- 暴雨強度和頻率增強<CITATION file="c4ccf054-e4e7-4c4f-8244-5ce9c1ddee51" filename="環境白皮書.pdf" page=2 />
+
+✅ CORRECT (web citation):
+MIMURE位于东京港区高轮，是一家综合性商业设施。<CITATION url="https://www.newoman.jp/takanawa/mimure/" />
+
+❌ WRONG (all citations at the end):
+氣候變遷的影響包括...(long response)...
+
+<CITATION file="..." filename="環境白皮書.pdf" page=0 />
+<CITATION file="..." filename="環境白皮書.pdf" page=1 />
+<CITATION file="..." filename="環境白皮書.pdf" page=2 />
+(13 citations dumped at the end)
+
+❌ WRONG (web citation with file attributes):
+MIMURE位于东京港区高轮，是一家综合性商业设施。<CITATION file="abc123" filename="mimure.html" />
+
+❌ WRONG (too many citations for short content):
+2024年全球氣溫上升。<CITATION file="..." filename="環境白皮書.pdf" page=0 />
+世界各地發生災害。<CITATION file="..." filename="環境白皮書.pdf" page=0 />
+沙烏地阿拉伯熱浪。<CITATION file="..." filename="環境白皮書.pdf" page=1 />
 
-**Citation Rules**:
-- The citation tag MUST be placed immediately after the factual claim or paragraph
-- The `file` attribute MUST use the exact `File ID` from `rag_retrieve` document
-- The `page` attribute MUST use the exact `Page Number` from `rag_retrieve` document
-- If multiple sources support the same claim, include separate citation tags for each source
-- Example: `According to the policy, returns are accepted within 30 days <CITATION file="abc123" page="5" />.`
-- This requirement ONLY applies when using `rag_retrieve` results to answer questions
 
 ### Current Working Directory