Skip to content

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

docs(memory): document version field that now rejects v1 (#2264) (#2280)

Evocb4f6d27be14
diff --git a/docs/en/guides/01-configuration.md b/docs/en/guides/01-configuration.md
index cdb50b738..2fda89404 100644
--- a/docs/en/guides/01-configuration.md
+++ b/docs/en/guides/01-configuration.md
@@ -1116,6 +1116,7 @@ For memory-related settings, add a `memory` section in `ov.conf`:
```json
{
"memory": {
+ "version": "v2",
"agent_scope_mode": "user+agent"
}
}
@@ -1123,6 +1124,7 @@ For memory-related settings, add a `memory` section in `ov.conf`:
| Field | Description | Default |
|-------|-------------|---------|
+| `version` | Memory implementation version. Only `"v2"` is supported (legacy `"v1"` removed in #2264 — passing `"v1"` now raises a `ValueError` at config load). | `"v2"` |
| `agent_scope_mode` | Deprecated and ignored. Kept only for backward compatibility with older `ov.conf` files. Agent/user namespace behavior is now controlled by per-account namespace policy. | `"user+agent"` |
`agent_scope_mode` no longer changes namespace behavior. The server now uses account-level namespace policy to choose between `viking://agent/{agent_id}/...` and `viking://agent/{agent_id}/user/{user_id}/...`.
diff --git a/docs/zh/guides/01-configuration.md b/docs/zh/guides/01-configuration.md
index 33cb3b65c..8ba94298d 100644
--- a/docs/zh/guides/01-configuration.md
+++ b/docs/zh/guides/01-configuration.md
@@ -1088,6 +1088,7 @@ openviking-server --config /path/to/ov.conf
```json
{
"memory": {
+ "version": "v2",
"agent_scope_mode": "user+agent"
}
}
@@ -1095,6 +1096,7 @@ openviking-server --config /path/to/ov.conf
| 字段 | 说明 | 默认值 |
|------|------|--------|
+| `version` | 记忆实现版本。仅支持 `"v2"`(#2264 已移除旧版 `"v1"`;传入 `"v1"` 会在配置加载时抛出 `ValueError`)。 | `"v2"` |
| `agent_scope_mode` | 已废弃且被忽略。仅为兼容旧版 `ov.conf` 保留。当前 agent/user 命名空间行为由 account 级 namespace policy 控制。 | `"user+agent"` |
`agent_scope_mode` 不再影响命名空间行为。服务端现在根据 account 级 namespace policy 在 `viking://agent/{agent_id}/...` 与 `viking://agent/{agent_id}/user/{user_id}/...` 之间选择。