回顧已儲存的知識
請閱讀共享慣例。此工作流程僅供讀取。
- 使用
knowledge_grep({query})進行搜尋，包括搜尋已知的人員、專案和頁面（如果其確切的儲存身份尚未可知）：預設為逐字搜尋all；在適當情況下嘗試使用簡潔的變體any或phrase。不支援嵌入向量、正規表示式、圖形遍歷或伺服器端合成。在合適時可依本體類型/種類縮小範圍；使用knowledge_records和分頁進行庫存盤點，而非進行假裝窮舉的排名搜尋。 - 僅在已知道確切的紀錄 ID、完整標題或已宣告的別名時才使用
knowledge_lookup({query})。它不執行關鍵字搜尋。如果回傳missing，請先回退到knowledge_grep再斷定不存在相關紀錄。保留ambiguous作為模糊狀態並檢查候選項，而非自行選取一個。 - 使用
knowledge_record檢查相關的命中結果。閱讀足夠的上下文以支持答案。預設包含精簡的元資料；可要求includeEvidence: true以取得來源定位器、摘錄和歸因支持，以及metadataView: "full"以取得任意領域的欄位。連線預設為精簡的身份/端點/不確定性；僅在需要更豐富的元資料/證據時才要求view: "full"，並在需要全文時搭配includeCards: true。必要時遵循正文/證據/連線的分頁機制。比較命中的引用雜湊/修訂版本與讀回內容。若發現變更則重新開始，不可合併不相容的修訂版本。僅對已宣告的結構化連線使用includeReferences；文字連結不會自動填入該列表。 - 根據擷取的段落回答問題。在 Control UI 聊天中，使用共享慣例的聊天連結契約，引用可讀的標題並連結到專屬的知識庫紀錄頁面。保留相關的來源定位器，並傳播原始證據，而不僅僅是生成的摘要。標註合成內容與分歧點。對於歷史性問題，明確使用生命週期歷史篩選器；不可將已被取代的資料呈現為當前資料。
- 區分無匹配結果和無法存取、無效、不完整或讀取失敗的情況。使用未變更的篩選器追蹤結果偏移量；對於關鍵字搜尋，比較
index.snapshot。如果 API 分頁限制導致無法窮舉結果，請縮小查詢範圍或說明覆蓋限制。不要僅因為簡短排名列表未包含某項目，就聲稱知識庫中缺少該內容。
回顧本身僅供讀取。如果選定的知識記憶策略要求記住真正新的持久性資訊，請另行使用 knowledge-capture。不要將擷取的摘要重新儲存為新的證據，也不應僅因為某個實體出現在答案中就對其進行擴充。
時間相關問題
對於一天/一週使用 knowledge_chronicle_day，對於發生範圍使用 knowledge_chronicle_since，對於某個實體的日期紀錄或指定的 timeField 使用 knowledge_timeline，對於最新的日期上下文使用 knowledge_chronicle_last_seen。首先要將實體解析為穩定的頁面 ID。帶有日期的提及並不證明參與。對於關鍵字/庫存查詢，請在 knowledge_grep 或 knowledge_records 中新增 since/until 和 timeField。occurred_at 回答事件發生的時間；recorded_at 和 updated_at 回答記錄被建立/修改的時間。切勿將兩者混用。使用使用者的時區解析相對查詢日期，並保留明確的偏移量；日期查詢接受 IANA 時區。僅包含日期來源的值仍保持僅日期格式。使用未變更的篩選器和回傳的快照追蹤 nextOffset。時間資格 "include_inactive" 包含已被取代/已過期的資料，但不包含已撤回的記錄或過去系統狀態的重建。最後一次出現使用 occurredOnOrBefore 作為發生截止點；不要傳遞 asOf 或 historical。使用 includeSources=true 以取得時間分頁上已去重的來源身份。不推斷僅 Markdown 的時間線和無日期紀錄，且無匹配結果並不證明不存在。
聚焦來源閱讀
使用 knowledge_evidence_read 搭配記錄 id 和觀察到的路徑/sha256 來讀取確切的保留 UTF-8 段落。在已知時提供包含性的 startLine/endLine。使用未變更的 id/路徑/雜湊和省略或重複的行界線來追蹤 nextCursor。null 的 nextCursor 表示段落已完成。相反地，record.nextEvidenceOffset 僅完成引文列表；excerptTruncated 仍然需要來源閱讀。該工具會驗證位元組和行界線，而非解釋的真實性。對於二進位原始檔請使用 knowledge_attachment。切勿僅根據摘錄或成功的結構性驗證器就推斷已完成完整審查。
查詢新鮮度區分 queriedAt 和 scannedAt；關鍵字結果還有 indexedAt。重複使用的掃描會保留其觀察時間。僅在具有未變更查詢篩選器和資格的不同頁面之間比較快照值。