回忆已保存的知识
阅读共享约定。此工作流为只读。
- 使用
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查询发生范围，使用knowledge_timeline查询实体的带日期记录或所选timeField字段，使用knowledge_chronicle_last_seen查询最新的带日期上下文。首先将实体解析为稳定的页面ID。带日期的提及并不证明出席。对于关键字/清单查询，在knowledge_grep或knowledge_records中添加since/until和timeField参数。occurred_at回答事件发生时间；recorded_at和updated_at回答记录创建/更改时间。切勿将一个替换为另一个。使用用户的时区解析相对查询日期，保留显式偏移；日期查询接受IANA时区。来源的仅日期值保持为仅日期。使用未更改的过滤器和返回的快照遵循nextOffset。时间资格参数"include_inactive"包含已取代/过期材料，从不包含已撤回记录或系统过去状态的重建。Last-seen使用occurredOnOrBefore作为发生截止日期；不要传递asOf或historical参数。在时间页面上使用includeSources=true获取去重后的来源身份。不推断纯Markdown时间线和无日期记录，无匹配并不证明不存在。
聚焦来源阅读
使用knowledge_evidence_read，传入记录ID和观察到的路径/sha256，读取确切的保留UTF-8段落。已知时提供包含性的startLine/endLine。使用未更改的id/path/hash和省略或重复的行边界跟随nextCursor。null nextCursor表示段落结束。相反，record.nextEvidenceOffset仅完成引用列表；excerptTruncated仍然需要来源阅读。该工具验证字节和行边界，而不是解释的真实性。对二进制原件使用knowledge_attachment。切勿从摘录或成功的结构验证器推断完整审查结果。
查询新鲜度区分queriedAt和scannedAt；关键字结果还有indexedAt。重用的扫描保留其观察时间。仅对比未更改的查询过滤器和资格参数下不同页面的快照值。