> For AI agents: the complete documentation index is available at https://docs.danqiuos.com/llms.txt, the full documentation bundle is available at https://docs.danqiuos.com/llms-full.txt.

# 知识库与记忆

## 为不同上下文选择合适位置

知识库保存产品资料、制度、SOP、合同模板和培训材料，帮助数字员工按需检索并引用来源。记忆用于沉淀企业事实、工作方法、用户偏好、风险经验和待验证的灵感，让员工不必每次从头了解业务。

两者适合长期服务企业的数字员工，但不应承担所有数据职责。订单金额、应收状态等持续变化的业务事实应进入结构化数据；具体执行步骤应写入技能。清晰的分工有助于定位错误来自资料、数据还是流程。

## 配置来源与维护责任

知识库应明确资料范围、同步来源、更新责任人和可见范围。检索能力与索引管理能力不同，业务员工按需读取资料，维护派生索引的能力应留给管理角色。回答重要问题时，应给出命中文档、相关依据和更新时间。

记忆也需要来源与边界。用户表达的格式偏好可以记录，但一次任务中的临时假设不应直接变成长期事实。资料更新或用户纠正后，应检查旧记忆是否仍适用，使经验能够被修正。

## 将资料权限与检索准备分开

一个 team 可按产品、项目或制度等业务范围组织多个知识库。对每个知识库分别确认资料来源、更新方式、查看范围、修改范围和维护人。员工能回答问题，不代表可以修改知识原文；维护索引也不等于修改原文。

| 层次      | 需要确认的条件          | 验证方式                 |
| ------- | ---------------- | -------------------- |
| 查看资料    | 当前员工有目标知识库的读取权限  | 读取一份获授权资料，拒绝读取一份受限资料 |
| 修改原文    | 维护角色具有单独的修改授权    | 只读员工修改被拒绝，维护人更新可核对   |
| 语义检索与索引 | 已启用检索，资料处理和索引已完成 | 用真实问题命中文档，再核对引用原文    |

已上传或同步不代表已可检索。`kb_query` 用于检索相关资料、引用和反向链接；`kb_index_admin` 维护文档转换结果、反向链接和语义索引，不用于修改知识库原文。使用前还需核对员工启用的工具集与资源授权，见 [数据与知识工具](https://docs.danqiuos.com/reference/data.md)。

上述知识库能力来自当前开发指南；本页的记忆分类是既有装配建议，该指南未给出记忆工具契约或自动更新保证。记忆是否可用、如何维护，应以实际租户能力验证，不能用长期记忆代替原始资料或业务记录。

## 示例：经营简报的上下文分工

| 内容         | 建议位置     | 使用方式      |
| ---------- | -------- | --------- |
| 企业指标定义与制度  | 知识库      | 检索并引用对应资料 |
| 本月订单与回款    | Arcubase | 读取最新业务记录  |
| 负责人偏好的简报结构 | 记忆       | 调整呈现形式    |
| 汇总与异常处理步骤  | 技能       | 按流程执行和检查  |
| 待验证的指标改进想法 | 灵感记忆     | 标明假设，后续评估 |

这类分工可让企业逐步装配自己的知识体系。资料很多时，先从核心岗位真正需要的文档开始，避免将无维护责任的历史材料全部视为有效依据。

## 边界与验收

检索到资料不代表资料仍然有效；记忆中的经验也不能覆盖最新业务数据或授权边界。不同资料发生冲突时，应说明差异并交由责任人判断，不应无依据地选一个作为定论。

验收时准备有明确答案的资料问题，检查是否命中正确文档、引用能否支持结论、无资料时是否承认缺口。再由维护人更新一份资料，完成必要的索引处理后，核对检索是否采用新依据；另测只读员工不能修改、未授权员工不能读取。无命中时检查来源、权限和索引状态，不能把检索缺口解释成业务事实不存在。记忆启用时，再修改一项已知偏好，核对后续回答是否采用新依据。涉及客户、订单等实时状态时，还应检查是否真正读取了 [业务数据](https://docs.danqiuos.com/platform/arcubase.md)。