Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
docs: 清理显式等待的调用示例 (#4998)
bot-of-qin-ctx4c014ab34625
diff --git a/docs/design/ov-compile-design.md b/docs/design/ov-compile-design.mdindex d4775d74c..aa788ede7 100644--- a/docs/design/ov-compile-design.md+++ b/docs/design/ov-compile-design.md@@ -446,7 +446,7 @@ POST /api/v1/content/batch-write```json{"root_uri": "viking://resources/团队知识库",- "wait": true,+ "wait": false,"timeout": 300,"operations": [{diff --git a/docs/en/api/03-filesystem.md b/docs/en/api/03-filesystem.mdindex 6923b3cc5..22e75e89e 100644--- a/docs/en/api/03-filesystem.md+++ b/docs/en/api/03-filesystem.md@@ -559,7 +559,7 @@ client.rm(uri="viking://resources/old-project/", recursive=True)**TypeScript SDK**```typescript-await client.remove("viking://resources/docs/old.md", { wait: true });+await client.remove("viking://resources/docs/old.md");```**Go SDK**diff --git a/docs/en/api/11-snapshot.md b/docs/en/api/11-snapshot.mdindex 957f8d1fe..cd0f671bf 100644--- a/docs/en/api/11-snapshot.md+++ b/docs/en/api/11-snapshot.md@@ -680,7 +680,6 @@ client.write(uri=f"{root}/guide.md",content="# Guide\n\nv1 content\n",mode="create",- wait=True,)v1 = client.snapshot.commit(message="v1 initial import", paths=[root])@@ -689,7 +688,6 @@ client.write(uri=f"{root}/guide.md",content="# Guide\n\nv2 content\n",mode="replace",- wait=True,)v2 = client.snapshot.commit(message="v2 update", paths=[root])diff --git a/docs/en/api/12-content.md b/docs/en/api/12-content.mdindex c2ea88e34..5d4bc1643 100644--- a/docs/en/api/12-content.md+++ b/docs/en/api/12-content.md@@ -242,7 +242,6 @@ result = client.write(uri="viking://resources/docs/api.md",content="# Updated API\n\nFresh content.",mode="replace",- wait=True,options={"tags": ["team=search", "env=prod"], "tag_mode": "replace"},)print(result["root_uri"])@@ -252,7 +251,6 @@ print(result["root_uri"])```typescriptawait client.write("viking://resources/docs/new.md", "# New document\n", {- wait: true,tags: ["team=search", "env=prod"],tagMode: "replace",});@@ -267,7 +265,6 @@ result, err := client.Write("# Updated API\n\nFresh content.",&openviking.WriteOptions{Mode: "replace",- Wait: true,Tags: []string{"team=search", "env=prod"},TagMode: "replace",},@@ -292,7 +289,6 @@ curl -X POST "http://localhost:1933/api/v1/content/write" \"uri": "viking://resources/docs/api.md","content": "# Updated API\n\nFresh content.","mode": "replace",- "wait": true,"tags": ["team=search", "env=prod"],"tag_mode": "replace"}'@@ -304,8 +300,7 @@ curl -X POST "http://localhost:1933/api/v1/content/write" \openviking write viking://resources/docs/api.md \--content "# Updated API\n\nFresh content." \--tags team=search,env=prod \- --tag-mode replace \- --wait+ --tag-mode replace```@@ -392,7 +387,7 @@ result = client.batch_write("mode": "upsert",},],- wait=True,+ wait=False,)```@@ -415,7 +410,7 @@ curl -X POST http://localhost:1933/api/v1/content/batch-write \"mode": "upsert"}],- "wait": true+ "wait": false}'```@@ -648,7 +643,7 @@ Subtree reindex is not transactional. Records skipped because no semantic sourceresult = client.reindex(uri="viking://resources",mode="vectors_only",- wait=True,+ wait=False,options={"tags": ["team=search", "env=prod"],"tag_mode": "replace",@@ -686,13 +681,12 @@ console.log(await client.reindex("viking://resources/docs/", {**Go SDK**-When passing a non-`nil` `ReindexOptions`, set `Wait` explicitly. Go's zero-value is `false`; only `opts=nil` applies the SDK default `wait=true`.+With non-`nil` `ReindexOptions`, omitting `Wait` uses Go's zero value `false`;+only `opts=nil` applies the SDK default `wait=true`.```goresult, err := client.Reindex(ctx, "viking://resources", &openviking.ReindexOptions{Mode: "vectors_only",- Wait: true,Tags: []string{"team=search"},TagMode: "replace",})@@ -705,13 +699,12 @@ fmt.Println(result["status"])```goresult, err := client.Reindex(ctx, "viking://resources", &openviking.ReindexOptions{Mode: "prune_orphans",- Wait: true,DryRun: true,})if err != nil {return err}-fmt.Println(result["would_delete_records"])+fmt.Println(result["task_id"])```**HTTP API**@@ -730,7 +723,7 @@ curl -X POST http://localhost:1933/api/v1/content/reindex \-d '{"uri": "viking://resources","mode": "vectors_only",- "wait": true,+ "wait": false,"tags": ["team=search", "env=prod"],"tag_mode": "replace"}'@@ -753,29 +746,6 @@ openviking reindex viking://user/default/skills --mode semantic_and_vectors --waopenviking reindex viking://resources --mode prune_orphans --dry-run```-**Synchronous response (`wait=true`)**--```json-{- "status": "ok",- "result": {- "uri": "viking://resources",- "mode": "vectors_only",- "status": "completed",- "object_type": "resource",- "scanned_records": 120,- "rebuilt_records": 118,- "deleted_records": 0,- "would_delete_records": 0,- "unsupported_records": 2,- "failed_records": 0,- "duration_ms": 1284,- "warnings": []- },- "time": 0.1-}-```-**Asynchronous response (`wait=false`)**```jsondiff --git a/docs/en/context-compilation/02-llm-wiki.md b/docs/en/context-compilation/02-llm-wiki.mdindex ec6c78c0b..1034ac9f4 100644--- a/docs/en/context-compilation/02-llm-wiki.md+++ b/docs/en/context-compilation/02-llm-wiki.md@@ -23,12 +23,12 @@ If the material is not in OpenViking yet, import it. Use `ov add-resource` for d```bash# Import a directory as a source-ov add-resource ./my-research --to viking://resources/research --wait+ov add-resource ./my-research --to viking://resources/research# Or write a single fileov mkdir viking://resources/researchov write viking://resources/research/notes.md \- --from-file ./notes.md --mode create --wait+ --from-file ./notes.md --mode create```Confirm the source is in place:@@ -42,7 +42,7 @@ ov ls -r viking://resources/researchInstall the LLM Wiki Skill. By default it lands in your user-private skills namespace; use `-p viking://agent/skills` to make it shared across the team:```bash-ov add-skill examples/compile/ov-compile-skills/llm-wiki --wait+ov add-skill examples/compile/ov-compile-skills/llm-wiki```Find the installed Skill URI:diff --git a/docs/en/context-compilation/03-knowledge-graph.md b/docs/en/context-compilation/03-knowledge-graph.mdindex f390e2baa..5b95afbf7 100644--- a/docs/en/context-compilation/03-knowledge-graph.md+++ b/docs/en/context-compilation/03-knowledge-graph.md@@ -21,14 +21,14 @@ Skill source: [examples/compile/ov-compile-skills/knowledge-graph](https://githu## Step 1: Prepare the sources```bash-ov add-resource ./journal-to-the-west --to viking://resources/journal --wait+ov add-resource ./journal-to-the-west --to viking://resources/journalov ls -r viking://resources/journal```## Step 2: Add the Skill```bash-ov add-skill examples/compile/ov-compile-skills/knowledge-graph --wait+ov add-skill examples/compile/ov-compile-skills/knowledge-graphov skills list# → viking://agent/skills/knowledge-graph```diff --git a/docs/en/context-compilation/04-daily-report.md b/docs/en/context-compilation/04-daily-report.mdindex 4cbc04caf..d88fd430f 100644--- a/docs/en/context-compilation/04-daily-report.md+++ b/docs/en/context-compilation/04-daily-report.md@@ -9,14 +9,14 @@ Skill source: [examples/compile/ov-compile-skills/daily-report](https://github.cDaily-report sources are usually sessions, messages, or documents already in OpenViking. To import a batch of records from local:```bash-ov add-resource ./work-logs --to viking://resources/work-logs --wait+ov add-resource ./work-logs --to viking://resources/work-logsov ls -r viking://resources/work-logs```## Step 2: Add the Skill```bash-ov add-skill examples/compile/ov-compile-skills/daily-report --wait+ov add-skill examples/compile/ov-compile-skills/daily-reportov skills list# → viking://agent/skills/daily-report (or viking://user/<you>/skills/daily-report)```diff --git a/docs/en/context-compilation/05-knowledge-distillation.md b/docs/en/context-compilation/05-knowledge-distillation.mdindex 46cca3595..ef9f6e307 100644--- a/docs/en/context-compilation/05-knowledge-distillation.md+++ b/docs/en/context-compilation/05-knowledge-distillation.md@@ -23,14 +23,14 @@ Skill source: [examples/compile/ov-compile-skills/knowledge-distillation](https:## Step 1: Prepare the sources```bash-ov add-resource ./finance-reports --to viking://resources/finance-reports --wait+ov add-resource ./finance-reports --to viking://resources/finance-reportsov ls -r viking://resources/finance-reports```## Step 2: Add the Skill```bash-ov add-skill examples/compile/ov-compile-skills/knowledge-distillation --wait+ov add-skill examples/compile/ov-compile-skills/knowledge-distillationov skills list# → viking://agent/skills/knowledge-distillation (or viking://user/<user_name>/skills/knowledge-distillation)```diff --git a/docs/en/guides/07-operation-telemetry.md b/docs/en/guides/07-operation-telemetry.mdindex 9700e6588..cb93cee70 100644--- a/docs/en/guides/07-operation-telemetry.md+++ b/docs/en/guides/07-operation-telemetry.md@@ -326,7 +326,6 @@ curl -X POST http://localhost:1933/api/v1/resources \-d '{"path": "./docs/readme.md","reason": "telemetry demo",- "wait": true,"telemetry": true}'```diff --git a/docs/en/guides/13-multi-write-storage.md b/docs/en/guides/13-multi-write-storage.mdindex c16385161..0916b5eee 100644--- a/docs/en/guides/13-multi-write-storage.md+++ b/docs/en/guides/13-multi-write-storage.md@@ -382,8 +382,7 @@ After startup, verify with ordinary file APIs:```bashopenviking write viking://resources/multiwrite-check.txt \- --content "multi-write check" \- --wait+ --content "multi-write check"openviking read viking://resources/multiwrite-check.txt```diff --git a/docs/en/guides/15-snapshot.md b/docs/en/guides/15-snapshot.mdindex 723d3931c..6ccef82d8 100644--- a/docs/en/guides/15-snapshot.md+++ b/docs/en/guides/15-snapshot.md@@ -141,7 +141,6 @@ client.write(uri=f"{root}/guide.md",content="# Guide\n\nv1 content\n",mode="create",- wait=True,)v1 = client.snapshot.commit(message="v1 initial import")print("v1:", v1["commit_oid"])@@ -151,7 +150,6 @@ client.write(uri=f"{root}/guide.md",content="# Guide\n\nv2 content\n",mode="replace",- wait=True,)v2 = client.snapshot.commit(message="v2 update")diff --git a/docs/en/guides/18-openviking-assets.md b/docs/en/guides/18-openviking-assets.mdindex 17ec50552..4cc321a7d 100644--- a/docs/en/guides/18-openviking-assets.md+++ b/docs/en/guides/18-openviking-assets.md@@ -254,12 +254,6 @@ Remove `dry_run` after reviewing the plan:ov add-resource --manifest manifest.yaml```-Wait for each resource to finish processing:--```bash-ov add-resource --manifest manifest.yaml --wait --timeout 600-```-The repository contains a complete example — a shared Catalog plus a Manifest that selects fromit — under[`examples/openviking-assets`](https://github.com/volcengine/OpenViking/tree/main/examples/openviking-assets).diff --git a/docs/zh/api/03-filesystem.md b/docs/zh/api/03-filesystem.mdindex 4ebf06ffb..1ecc99ee3 100644--- a/docs/zh/api/03-filesystem.md+++ b/docs/zh/api/03-filesystem.md@@ -593,7 +593,7 @@ client.rm(uri="viking://resources/old-project/", recursive=True)**TypeScript SDK**```typescript-await client.remove("viking://resources/docs/old.md", { wait: true });+await client.remove("viking://resources/docs/old.md");```**Go SDK**diff --git a/docs/zh/api/11-snapshot.md b/docs/zh/api/11-snapshot.mdindex fa625e5b5..30201e150 100644--- a/docs/zh/api/11-snapshot.md+++ b/docs/zh/api/11-snapshot.md@@ -680,7 +680,6 @@ client.write(uri=f"{root}/guide.md",content="# Guide\n\nv1 content\n",mode="create",- wait=True,)v1 = client.snapshot.commit(message="v1 initial import", paths=[root])@@ -689,7 +688,6 @@ client.write(uri=f"{root}/guide.md",content="# Guide\n\nv2 content\n",mode="replace",- wait=True,)v2 = client.snapshot.commit(message="v2 update", paths=[root])diff --git a/docs/zh/api/12-content.md b/docs/zh/api/12-content.mdindex fe2febb93..c2b765010 100644--- a/docs/zh/api/12-content.md+++ b/docs/zh/api/12-content.md@@ -242,7 +242,6 @@ result = client.write(uri="viking://resources/docs/api.md",content="# Updated API\n\nFresh content.",mode="replace",- wait=True,options={"tags": ["team=search", "env=prod"], "tag_mode": "replace"},)print(result["root_uri"])@@ -252,7 +251,6 @@ print(result["root_uri"])```typescriptawait client.write("viking://resources/docs/new.md", "# New document\n", {- wait: true,tags: ["team=search", "env=prod"],tagMode: "replace",});@@ -267,7 +265,6 @@ result, err := client.Write("# Updated API\n\nFresh content.",&openviking.WriteOptions{Mode: "replace",- Wait: true,Tags: []string{"team=search", "env=prod"},TagMode: "replace",},@@ -292,7 +289,6 @@ curl -X POST "http://localhost:1933/api/v1/content/write" \"uri": "viking://resources/docs/api.md","content": "# Updated API\n\nFresh content.","mode": "replace",- "wait": true,"tags": ["team=search", "env=prod"],"tag_mode": "replace"}'@@ -304,8 +300,7 @@ curl -X POST "http://localhost:1933/api/v1/content/write" \openviking write viking://resources/docs/api.md \--content "# Updated API\n\nFresh content." \--tags team=search,env=prod \- --tag-mode replace \- --wait+ --tag-mode replace```@@ -392,7 +387,7 @@ result = client.batch_write("mode": "upsert",},],- wait=True,+ wait=False,)```@@ -415,7 +410,7 @@ curl -X POST http://localhost:1933/api/v1/content/batch-write \"mode": "upsert"}],- "wait": true+ "wait": false}'```@@ -648,7 +643,7 @@ session 子树会被跳过。result = client.reindex(uri="viking://resources",mode="vectors_only",- wait=True,+ wait=False,options={"tags": ["team=search", "env=prod"],"tag_mode": "replace",@@ -686,13 +681,12 @@ console.log(await client.reindex("viking://resources/docs/", {**Go SDK**-传入非 `nil` 的 `ReindexOptions` 时,需要显式设置 `Wait`。Go 的布尔零值为-`false`;只有 `opts=nil` 时 SDK 才会应用 `wait=true` 的默认值。+传入非 `nil` 的 `ReindexOptions` 时,省略 `Wait` 使用 Go 的布尔零值 `false`;+只有 `opts=nil` 时 SDK 才会应用 `wait=true` 的默认值。```goresult, err := client.Reindex(ctx, "viking://resources", &openviking.ReindexOptions{Mode: "vectors_only",- Wait: true,Tags: []string{"team=search"},TagMode: "replace",})@@ -705,13 +699,12 @@ fmt.Println(result["status"])```goresult, err := client.Reindex(ctx, "viking://resources", &openviking.ReindexOptions{Mode: "prune_orphans",- Wait: true,DryRun: true,})if err != nil {return err}-fmt.Println(result["would_delete_records"])+fmt.Println(result["task_id"])```**HTTP API**@@ -730,7 +723,7 @@ curl -X POST http://localhost:1933/api/v1/content/reindex \-d '{"uri": "viking://resources","mode": "vectors_only",- "wait": true,+ "wait": false,"tags": ["team=search", "env=prod"],"tag_mode": "replace"}'@@ -753,29 +746,6 @@ openviking reindex viking://user/default/skills --mode semantic_and_vectors --waopenviking reindex viking://resources --mode prune_orphans --dry-run```-**同步响应(`wait=true`)**--```json-{- "status": "ok",- "result": {- "uri": "viking://resources",- "mode": "vectors_only",- "status": "completed",- "object_type": "resource",- "scanned_records": 120,- "rebuilt_records": 118,- "deleted_records": 0,- "would_delete_records": 0,- "unsupported_records": 2,- "failed_records": 0,- "duration_ms": 1284,- "warnings": []- },- "time": 0.1-}-```-**异步响应(`wait=false`)**```jsondiff --git a/docs/zh/context-compilation/02-llm-wiki.md b/docs/zh/context-compilation/02-llm-wiki.mdindex 11451af44..d8e9f0e76 100644--- a/docs/zh/context-compilation/02-llm-wiki.md+++ b/docs/zh/context-compilation/02-llm-wiki.md@@ -23,12 +23,12 @@ Skill 源码:[examples/compile/ov-compile-skills/llm-wiki](https://github.com/```bash# 导入一个目录作为来源-ov add-resource ./my-research --to viking://resources/research --wait+ov add-resource ./my-research --to viking://resources/research# 或者写入单个文件ov mkdir viking://resources/researchov write viking://resources/research/notes.md \- --from-file ./notes.md --mode create --wait+ --from-file ./notes.md --mode create```确认来源已就位:@@ -42,7 +42,7 @@ ov ls -r viking://resources/research把 LLM Wiki 的 Skill 装进服务。默认落到你的用户私有 skills 命名空间;想让团队共用就用 `-p viking://agent/skills`:```bash-ov add-skill examples/compile/ov-compile-skills/llm-wiki --wait+ov add-skill examples/compile/ov-compile-skills/llm-wiki```查看装好的 Skill URI:diff --git a/docs/zh/context-compilation/03-knowledge-graph.md b/docs/zh/context-compilation/03-knowledge-graph.mdindex 06a2211b8..ba34386a5 100644--- a/docs/zh/context-compilation/03-knowledge-graph.md+++ b/docs/zh/context-compilation/03-knowledge-graph.md@@ -21,14 +21,14 @@ Skill 源码:[examples/compile/ov-compile-skills/knowledge-graph](https://gith## 第一步:准备来源```bash-ov add-resource ./journal-to-the-west --to viking://resources/journal --wait+ov add-resource ./journal-to-the-west --to viking://resources/journalov ls -r viking://resources/journal```## 第二步:添加 Skill```bash-ov add-skill examples/compile/ov-compile-skills/knowledge-graph --wait+ov add-skill examples/compile/ov-compile-skills/knowledge-graphov skills list# → viking://agent/skills/knowledge-graph```diff --git a/docs/zh/context-compilation/04-daily-report.md b/docs/zh/context-compilation/04-daily-report.mdindex fc85a08e6..c17a626a5 100644--- a/docs/zh/context-compilation/04-daily-report.md+++ b/docs/zh/context-compilation/04-daily-report.md@@ -9,14 +9,14 @@ Skill 源码:[examples/compile/ov-compile-skills/daily-report](https://github.日报的来源通常是已经在 OpenViking 里的会话、消息或文档。如果要从本地导入一批记录:```bash-ov add-resource ./work-logs --to viking://resources/work-logs --wait+ov add-resource ./work-logs --to viking://resources/work-logsov ls -r viking://resources/work-logs```## 第二步:添加 Skill```bash-ov add-skill examples/compile/ov-compile-skills/daily-report --wait+ov add-skill examples/compile/ov-compile-skills/daily-reportov skills list# → viking://agent/skills/daily-report (或 viking://user/<你>/skills/daily-report)```diff --git a/docs/zh/context-compilation/05-knowledge-distillation.md b/docs/zh/context-compilation/05-knowledge-distillation.mdindex 8f677a1d0..d57748cbb 100644--- a/docs/zh/context-compilation/05-knowledge-distillation.md+++ b/docs/zh/context-compilation/05-knowledge-distillation.md@@ -23,14 +23,14 @@ Skill 源码:[examples/compile/ov-compile-skills/knowledge-distillation](https## 第一步:准备来源```bash-ov add-resource ./finance-reports --to viking://resources/finance-reports --wait+ov add-resource ./finance-reports --to viking://resources/finance-reportsov ls -r viking://resources/finance-reports```## 第二步:添加 Skill```bash-ov add-skill examples/compile/ov-compile-skills/knowledge-distillation --wait+ov add-skill examples/compile/ov-compile-skills/knowledge-distillationov skills list# → viking://agent/skills/knowledge-distillation (或 viking://user/<user_name>/skills/knowledge-distillation)```diff --git a/docs/zh/guides/07-operation-telemetry.md b/docs/zh/guides/07-operation-telemetry.mdindex 4d667360e..09616afed 100644--- a/docs/zh/guides/07-operation-telemetry.md+++ b/docs/zh/guides/07-operation-telemetry.md@@ -320,7 +320,6 @@ curl -X POST http://localhost:1933/api/v1/resources \-d '{"path": "./docs/readme.md","reason": "telemetry demo",- "wait": true,"telemetry": true}'```diff --git a/docs/zh/guides/13-multi-write-storage.md b/docs/zh/guides/13-multi-write-storage.mdindex 1549592a0..6212dfae7 100644--- a/docs/zh/guides/13-multi-write-storage.md+++ b/docs/zh/guides/13-multi-write-storage.md@@ -382,8 +382,7 @@ openviking-server doctor```bashopenviking write viking://resources/multiwrite-check.txt \- --content "multi-write check" \- --wait+ --content "multi-write check"openviking read viking://resources/multiwrite-check.txt```diff --git a/docs/zh/guides/15-snapshot.md b/docs/zh/guides/15-snapshot.mdindex 162435756..7f6a7da42 100644--- a/docs/zh/guides/15-snapshot.md+++ b/docs/zh/guides/15-snapshot.md@@ -141,7 +141,6 @@ client.write(uri=f"{root}/guide.md",content="# Guide\n\nv1 content\n",mode="create",- wait=True,)v1 = client.snapshot.commit(message="v1 initial import")print("v1:", v1["commit_oid"])@@ -151,7 +150,6 @@ client.write(uri=f"{root}/guide.md",content="# Guide\n\nv2 content\n",mode="replace",- wait=True,)v2 = client.snapshot.commit(message="v2 update")diff --git a/docs/zh/guides/18-openviking-assets.md b/docs/zh/guides/18-openviking-assets.mdindex dbeaf6822..6c92ddfc0 100644--- a/docs/zh/guides/18-openviking-assets.md+++ b/docs/zh/guides/18-openviking-assets.md@@ -240,12 +240,6 @@ ov add-resource --manifest manifest.yaml --args dry_run:trueov add-resource --manifest manifest.yaml```-等待每个资源处理完成:--```bash-ov add-resource --manifest manifest.yaml --wait --timeout 600-```-仓库中包含一个完整示例(一份共享 Catalog 加一份按名选择的 Manifest),位于[`examples/openviking-assets`](https://github.com/volcengine/OpenViking/tree/main/examples/openviking-assets)。