CowAgent 个人知识库 - 数字先锋API文档

**CowAgent 的个人知识库系统 — 结构化知识沉淀、自动整理与知识图谱**

个人知识库是 Agent 的长期结构化知识存储，保存在工作空间的 knowledge/ 目录下。与按时间线组织的记忆不同，知识库以主题为维度，将用户分享的文章、对话中的洞察、学习材料等整理为互相关联的 Markdown 页面，形成可持续增长的知识网络。

![](/uploads/editor/20260614/img_6a2e738c6ad9b5.42550742.png)

**核心概念**

知识 vs 记忆
维度	知识库（knowledge/）	长期记忆（memory/）
- 组织方式	按主题分类、互相关联	按时间线、日期文件
- 写入方式	Agent 主动整理结构化内容	上下文裁剪时自动摘要
- 内容特点	提炼后的结构化知识	原始对话摘要
- 典型用途	学习笔记、技术文档、项目知识	对话历史、事件记录

**目录结构**
```bash
~/cow/knowledge/
├── index.md          # 知识索引，所有页面的入口
├── log.md            # 变更日志，记录每次写入
├── concepts/         # 概念类知识
│   └── machine-learning.md
├── entities/         # 实体类知识（人物、组织、工具）
│   └── openai.md
└── sources/          # 来源类知识（文章、论文）
    └── llm-wiki.md
```
目录结构是灵活的 — Agent 会根据实际内容自动创建合适的分类目录。用户也可以通过对话的方式自定义目录组织方式。

![](/uploads/editor/20260614/img_6a2e73eb7dda47.43439112.png)

**自动整理**
知识库的写入是 Agent 的自主行为，在以下场景中触发：
1. 用户分享文章或文档 — Agent 自动提取关键信息，创建结构化知识页面
2. 对话产生有价值的结论 — Agent 将洞察整理为知识页面，并与已有知识建立关联
3. 用户主动要求整理 — 用户可以通过对话指导 Agent 组织和更新知识

![](/uploads/editor/20260614/img_6a2e741b628cb0.05025906.png)

每个知识页面都包含与其他页面的交叉引用链接，逐步构建起一个知识图谱。

**知识检索**
Agent 在对话中可以通过以下方式检索知识：
1. 索引查阅 — 通过 knowledge/index.md 快速定位相关知识页面
2. 语义搜索 — 通过 memory_search 工具对知识库内容进行语义检索
3. 直接读取 — 通过 memory_get 工具读取特定知识文件

**Web 控制台**
Web 控制台提供了专用的「知识」模块，支持：
1. 文档浏览 — 树状目录结构，可搜索、可折叠，点击查看文档内容
2. 知识图谱 — 可视化展示知识之间的关联关系，节点可直接跳转至文档
3. 对话联动 — Agent 回复中引用的知识文档链接可直接点击跳转查看1.

![](/uploads/editor/20260614/img_6a2e748d1cb369.56135279.png)

**CLI 命令**
通过 /knowledge 命令管理知识库：
**命令	说明**
/knowledge	显示知识库统计信息
/knowledge list	以树状结构显示文件目录
/knowledge on	开启知识库功能
/knowledge off	关闭知识库功能

**相关配置**
**参数	说明	默认值**
knowledge	是否启用个人知识库功能	true
agent_workspace	工作空间路径，知识库存储在此目录的 knowledge/ 子目录下	~/cow

上一篇：CowAgent 长期记忆下一篇：CowAgent 常用命令