Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

5.2 KB
Raw Blame

上下文编译概览

ov compile 读取 OpenViking 中的文档、笔记、网页或会话记录,按指定 Skill 整理成 Wiki、知识图谱、日报等内容,并写回 OpenViking。

它是怎么工作的

使用已安装 Skill 编译时,需要指定:

  • --from:一个或多个来源目录或文件。
  • --to:输出目录。
  • --skill:已安装的 Skill URI,定义输出内容和结构。

可选的 --instruction 用来补充本次任务的范围、受众、语言、侧重点或日期。

编译由服务端配置的 Agent Runtime 执行,本地部署可使用内置 VikingBot。它以请求用户的身份读取来源和 Skill,在独立的 Agent Loop 中整理并写入内容。任务异步运行,返回 task_id 后可查询进度和结果。

一条命令跑起来

先按 LLM Wiki 示例 导入来源、安装 Skill,再执行:

ov compile \
  --from viking://resources/research \
  --to viking://resources/research-wiki \
  --skill viking://agent/skills/llm-wiki \
  --instruction "把研究资料整理成便于团队检索的知识库"

命令会立即返回一个 cmp_... 任务 ID,之后用 ov task status <id> 查看进度、用 ov task cancel <id> 取消。完整的字段说明、任务生命周期和 HTTP 接口见 Agent Runtime API。

使用 Web Studio

Studio 提供 /compile 列表、/compile/new 新建表单和 /compile/tasks/<task_id> 任务详情页。可以选择并预览 Skill、浏览来源目录、提交多个来源、查看或取消任务,以及打开产物目录。文件系统终端也支持 compile 和 task,并可将参数带入表单。

任务列表游标使用进程内密钥签名,并绑定调用者和筛选条件。服务重启后旧游标失效,刷新列表即可重新开始。一个副本签发的游标不能直接用于另一个副本。分页扫描已存储的任务记录,不依赖索引,读取成本仍随保留的历史数量增长。

重试 HTTP 提交时,复用相同的 Idempotency-Key 和请求参数;同一 Key 对应的参数变化时返回 409。提交恢复只在任务记录保留期间有效:完成或取消的记录在最后一次更新后保留 24 小时,失败记录保留 7 天。这不是永久提交历史,也不保证跨实例 exactly-once。提交恢复见 Agent Runtime,任务操作见任务管理。

换个 Skill,就换一种产物

Skill 决定输出内容和结构。仓库提供以下示例,其中 LLM Wiki 和 Knowledge Graph 还包含可视化脚本:

Skill 产物形态 适合 示例
LLM Wiki 一套互相链接的 Markdown 页面(实体页、概念页、方法页……)加一个导航 index.md 需要人和 Agent 都能快速检索、导航、复用的知识库 LLM Wiki 示例
Knowledge Graph entities/*.md 节点 + 一个 relations.jsonl 关系表 需要按实体、类型、关系去遍历的结构化知识图谱 Knowledge Graph 示例
日报 每个日期一页 <YYYY-MM-DD>.md 从对话、会话、消息、任务记录里还原「每天真正做了什么」 日报示例
知识蒸馏 按主题组织的高层次结论页 从一个或多个知识库里提炼跨来源的发现、趋势、变化 知识蒸馏示例

前两个示例还给出了从导入来源 → 添加 Skill → 执行编译 → 可视化产物的完整 ov 命令,照着做就能得到一张可交互的 HTML 图。

不止生成新产物:整理已有记忆

除了用 Skill 把来源材料编译成新的知识产物,ov compile 还有一种特殊模式——把 --skill 设为 memory,即可对已有的记忆目录做就地整理(去重、合并、拆分、精简),且不经过 VikingBot。详见 记忆整理。

前置条件

  • 使用 Skill 的示例需要一个已配置 Compile Runtime 的 OpenViking 服务;本地使用需安装 openviking[bot] 依赖,并通过 --with-bot 启用内置 VikingBot。--skill memory 模式在进程内运行,不需要 Compile Runtime,也不传 --from。默认端点是 http://localhost:1933;远程使用需要 API Key,参见 鉴权。没有服务先看 快速开始。
  • ov CLI 已配置好连接(~/.openviking/ovcli.conf,或由 OPENVIKING_CLI_CONFIG_FILE 指定的文件)。
  • 示例中的 examples/... 是仓库相对路径。先下载 OpenViking 仓库,在仓库根目录运行命令。
  • 可视化脚本需要 Python 3。LLM Wiki 脚本还需要 openviking Python 包。

相关文档