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(agents): rebase latest unsubmitted fork follow-ups (#2419)
Lilimamama02fc47a51dbb
diff --git a/docs/images/agents/zh/cli.md b/docs/images/agents/zh/cli.mdindex 4377051db..a278454ec 100644--- a/docs/images/agents/zh/cli.md+++ b/docs/images/agents/zh/cli.md@@ -1,22 +1,21 @@-# CLI 命令行接入面向开发者在本地终端直接安装、配置和使用 OpenViking CLI。-## 步骤1:在终端执行以下命令安装 OpenViking CLI,并进入配置流程:+### 步骤1:在终端执行以下命令安装 OpenViking CLI,并进入配置流程:```bashnpm i -g @openviking/cli && ov config```-## 步骤2:按提示填写 OpenViking 服务地址和 API Key。服务地址可使用:+### 步骤2:按提示填写 OpenViking 服务地址和 API Key。服务地址可使用:```texthttps://api.vikingdb.cn-beijing.volces.com/openviking```-## 步骤3:配置完成后,可运行以下命令查看 CLI 用法:+### 步骤3:配置完成后,可运行以下命令查看 CLI 用法:```bashov --helpdiff --git a/docs/images/agents/zh/mcp.md b/docs/images/agents/zh/mcp.mdindex 3b5bc6ab7..f2bfdbf9f 100644--- a/docs/images/agents/zh/mcp.md+++ b/docs/images/agents/zh/mcp.md@@ -1,5 +1,6 @@+# MCP 接入-## 步骤 1:MCP 配置+### 步骤 1:MCP 配置```json{@@ -14,9 +15,10 @@}```->**关键说明**:`Authorization` 的值需带上 `Bearer` 前缀(注意空格),完整格式为 `Bearer \<API Key\>`---## 步骤 2:测试 MCP 工具连通性+**关键说明**:`Authorization` 的值需带上 `Bearer` 前缀(注意空格),完整格式为 `Bearer \<API Key\>`。+### 步骤 2:测试 MCP 工具连通性输入 `ov health` 检查 ov 的版本和连接状态+```bash+ov health+```diff --git a/docs/images/agents/zh/trae.md b/docs/images/agents/zh/trae.mdindex 00226b30b..a80643b2e 100644--- a/docs/images/agents/zh/trae.md+++ b/docs/images/agents/zh/trae.md@@ -13,24 +13,43 @@- 个人长期任务目标 / OKR / Roadmap 沉淀,Agent 在规划任务时自动对齐+---++## 二、前置准备:获取 API Key++所有 MCP 客户端的接入都依赖同一个 **Authorization Token**,即 OpenViking 控制台中的 API Key。请先按以下步骤获取并妥善保存:++1. 在左侧菜单选择 **用户管理**-## 二、Trae 接入 OpenViking 操作步骤+2. 在用户列表中找到对应用户(个人版默认为 `default` / `admin`),点击 API Key 列右侧的 **复制** 图标-**Trae** 是字节跳动推出的 AI IDE,原生支持通过 MCP 协议加载外部工具与上下文服务。请在 trae 按以下步骤操作:+3. 将复制得到的 `ZGV\.\.\.hiMg` 形式的字符串妥善保存,作为后续所有 Agent 接入的 `Authorization` 值++**安全提示**:API Key 等同于账户密钥,请勿提交到 Git 仓库或公开渠道。建议通过环境变量或加密配置注入。++++----### 步骤 1:打开 Trae 设置+## 三、Trae 接入指南++**Trae** 是字节跳动推出的 AI IDE,原生支持通过 MCP 协议加载外部工具与上下文服务。以下为 OpenViking 的标准接入流程。++### 3\.1 接入步骤++#### 步骤 1:打开设置在 Trae 主界面右上角点击 **设置(齿轮图标)**,进入设置面板。-### 步骤 2:进入 MCP 配置页+#### 步骤 2:进入 MCP 配置页在左侧菜单中选择 **MCP**,进入 MCP Servers 管理页。-### 步骤 3:新增 MCP Server+#### 步骤 3:新增 MCP Server点击右侧的 **\+ 添加** 按钮,在下拉菜单中选择 **手动配置**。@@ -38,9 +57,9 @@-### 步骤 4:粘贴配置 JSON+#### 步骤 4:粘贴配置 JSON-在弹出的配置框中粘贴以下 JSON:+在弹出的配置框中粘贴以下 JSON,并将 `Authorization` 替换为第二章中复制的 API Key:```json{@@ -55,47 +74,41 @@}```+**关键说明**:`Authorization` 的值需带上 `Bearer` 前缀(注意空格),完整格式为 `Bearer \<API Key\>`。+-### 步骤 5:确认并启用+#### 步骤 5:确认并启用点击 **确认** 按钮,Trae 会自动建立 MCP 连接并加载工具列表。连接成功后,`ov\-mcp\-server` 将出现在已配置的 MCP Servers 列表中。配置完成后,可在 MCP 管理页看到 `ov\-mcp\-server` 已加载并启用,右侧开关呈绿色:-### 步骤 6:MCP 连通性检查+#### 步骤 6:MCP 连通性检查接入后建议通过两个简单 query 快速验证 MCP 是否正常工作。在 Trae 对话框中依次输入:-**① ****`ov ls`** — 列出 OpenViking 根目录内容,确认连接畅通、可正确返回目录结构:-```bash-ov ls-```+**① ****`ov ls`** — 列出 OpenViking 根目录内容,确认连接畅通、可正确返回目录结构。-**② ****`ov health`** — 调用 health 工具,确认 OpenViking 服务端状态与当前用户身份:-```bash-ov health-```+**② ****`ov health`** — 调用 health 工具,确认 OpenViking 服务端状态与当前用户身份。-### 步骤:验收标准-`ov ls` 能返回 `agent / resources / session / user` 等目录;`ov health` 返回 `service initialized` 与当前用户名,即表示接入成功。+**验收标准**:`ov ls` 能返回 `agent / resources / session / user` 等目录;`ov health` 返回 `service initialized` 与当前用户名,即表示接入成功。-## 三、配置参数说明+### 3\.2 配置参数说明|字段|必填|说明||---|---|---||`mcpServers`|是|MCP Server 配置根节点||`ov\-mcp\-server`|是|服务别名,可自定义;建议保持与上下文识别一致||`url`|是|OpenViking MCP 服务端点;CN 区固定为 `https://api\.vikingdb\.cn\-beijing\.volces\.com/openviking/mcp`|-|`headers\.Authorization`|是|格式 `Bearer \<API Key\>`,来源见第二章|+|`headers\.Authorization`|是|格式 `Bearer \<API Key\>`|----## 四、常见问题(FAQ)