豆包工作接入 OpenViking Context 连接器为豆包注入 OpenViking 持久化上下文记忆【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking本文以 OpenViking 仓库中 豆包工作接入文档 为核心主体完整讲解如何在豆包工作中安装、配置并验证 OpenViking Context 连接器同时结合仓库中的鉴权、API Key 与 MCP 集成实现说明从获取 USER API Key 到连接器真正可用的完整链路。读完本文你将掌握在豆包工作中为 AI 助手接入 OpenViking 上下文数据库的具体操作步骤、验证方法与故障排查手段并理解背后 API Key 与 MCP 工具的运作原理。为什么要在豆包工作中接入 OpenViking Context豆包工作是字节跳动推出的企业级 AI 工作平台用户可以在其中通过对话完成文档处理、信息检索与任务协作。而 OpenViking 是专为 AI Agent 设计的开源上下文数据库它将 Agent 所需的全部长期上下文——Memory记忆、Resource知识资源、Skill技能——统一抽象为目录结构并提供语义检索与渐进式内容加载能力参见 OpenViking 架构说明 与 快速开始。在豆包工作与 OpenViking 的集成场景中参见 Agent 接入索引豆包工作属于MCP 接入方式通过豆包工作原生的“技能·连接器·伙伴”能力安装 OpenViking 提供的官方连接器接入后即可让豆包在对话中自动召回 OpenViking 中存储的相关记忆并将新的对话内容沉淀回上下文数据库从而获得跨会话、可积累的持久化上下文能力。接入前的准备获取 OpenViking USER API Key安装连接器所需的唯一凭证是OpenViking USER API Key。理解这个 Key 的来龙去脉能帮你少走弯路。鉴权模式与密钥体系OpenViking 默认使用API Key 鉴权模式auth_mode: api_key只需在服务端配置root_api_key即可启用详见 鉴权指南。其密钥体系分为两类密钥用途获取方式root_api_key部署级管理密钥解析为 ROOT 身份在ov.conf中由管理员配置USER API Key普通用户身份供 MCP 连接器、SDK、CLI 使用通过 Admin API /ov admin命令创建从源码结构看openviking/server/api_keys/new.py当前用户密钥采用新格式base64url(account_id).base64url(user_id).base64url(secret)三段式结构。服务端可以直接从密钥中解码出账户与用户身份parse_api_key无需前缀索引查找密钥的 secret 部分仍通过 Argon2id启用api_key_hashing_enabled时或文件级 AES 加密保护。身份角色在 openviking/server/api_keys/models.py 中限定为USER或ADMINROOT身份只能来自root_api_key。创建用户并取得 USER API Key豆包工作连接器需要的是某个具体用户的 API Key即role: user或role: admin的账户成员密钥而非 root 密钥。创建方式详见 Admin API 文档方式一CLI推荐# 在 ovcli.conf 中配置了 root_api_key 的前提下创建账户 ov --sudo admin create-account acme # 在工作区 acme 中注册用户 bob返回 USER API Key ov --sudo admin register-user acme bob --role user方式二HTTP APIcurl -X POST http://localhost:1933/api/v1/admin/accounts/acme/users \ -H Content-Type: application/json \ -H X-API-Key: root-or-admin-key \ -d { user_id: bob, role: user, seed: bob-seed }方式三Python SDKimport openviking as ov client ov.SyncHTTPClient(api_keyroot-or-admin-key) client.initialize() result client.admin_register_user(account_idacme, user_idbob, roleuser) print(result[user_key]) # 这就是 USER API Key几点注意事项源自 Admin API 文档seed是可选的确定性密钥种子省略时使用随机密钥seed属于密钥材料过短容易被猜测生产环境建议省略。trusted模式下响应不会包含user_key字段。无法通过注册接口直接创建ROOT角色。密钥需要妥善保管。若泄露可随时重新生成regenerate_key会立即作废旧密钥参见 Admin API 文档。另外本地默认模式未启用鉴权下无需 API Key连接启用鉴权的 Server 时SDK/CLI 一般通过环境变量OPENVIKING_API_KEY提供密钥参见 快速开始。步骤 1安装 OpenViking Context 连接器拿到 USER API Key 后即可在豆包工作中完成连接器安装以下操作步骤以原 豆包工作接入文档 为基准打开豆包工作点击左侧导航栏的技能·连接器·伙伴搜索 “OpenViking Context”点击其右侧的。在弹出的“授权配置”窗口中填写 OpenViking USER API Key{{OPENVIKING_API_KEY}}即把你准备好的 USER API Key 粘贴到该字段环境变量OPENVIKING_API_KEY在豆包工作侧由该授权配置字段承载。点击保存并连接。当页面顶部出现“连接器已安装”提示且 “OpenViking Context” 右侧由变为“已添加”状态即表示接入完成。说明原文档此处配有界面截图位于线上文档站docs.openviking.net/agents/image/doubao-work/系列图片本仓库不包含该截图资源请以豆包工作实际界面为准。步骤 2验证接入是否生效连接器安装完成后按以下两步验证返回豆包主对话点击对话框下方的连接器确认能够找到 “OpenViking Context”。点击对话框下方的更多技能确认能够找到“OpenViking 上下文数据库”技能并让豆包调用 OpenViking 返回相关内容例如让豆包检索你已存入 OpenViking 的资源或记忆。验证通过后豆包工作即拥有 OpenViking 的持久化上下文能力对话中可自动召回相关记忆新内容也会被沉淀回上下文数据库。接入后能做什么连接器背后的 MCP 工具集“OpenViking Context” 连接器在服务端本质上连接的是 OpenViking 内置的MCP 端点http://server:1933/mcp与 REST API 同进程同端口参见 MCP 集成指南。豆包工作通过该连接器获得约 15 个 MCP 工具核心能力包括工具能力find/search语义检索search的modecontext可直接组装可注入的上下文remember将消息存储到长期记忆并触发记忆提取add_resource/read/write/edit添加与管理viking://资源文件、URL、目录list/tree/grep/glob浏览、搜索资源树forget删除任意viking://URIhealth检查服务健康状态工具中访问个人工作区时统一使用家目录别名viking://~它会展开为viking://user/当前用户因此不同用户在同一个 Server 上拥有互相隔离的上下文空间参见 MCP 集成指南。从 豆包工作接入索引 的定位来看豆包工作接入后主要获得的是持久化上下文记忆对话中自动召回相关记忆、存储新内容让企业用户在豆包工作中与 AI 协作的成果可跨会话复用。故障排查若接入过程中遇到问题参照下表定位源自原 豆包工作接入文档 的故障排查表问题处理搜索不到 “OpenViking Context”确认使用的是豆包工作而非其他豆包产品清除搜索条件后重新搜索若仍未出现请联系企业管理员确认连接器是否已对当前组织开放提示连接失败检查 OpenViking USER API Key 是否正确补充两个排查要点Key 过期或已重新生成如果管理员曾执行过regenerate_key旧 Key 会立即失效需要重新获取并在豆包工作的“授权配置”中更新参见 Admin API 文档。服务端不可达确认 OpenViking Server 正在运行且 MCP 端点可访问可执行curl http://localhost:1933/health预期返回{status: ok}参见 MCP 集成指南。企业管理员视角连接器的组织开放与多租户管理故障排查表提到“请联系企业管理员确认连接器是否已对当前组织开放”这对应豆包工作侧由企业管理员统一管理连接器的可见范围。而在 OpenViking 侧管理员负责的是账户与用户account / user的多租户管理账户account即工作区由 ROOT 创建每个账户下可注册多个用户角色为USER或ADMINADMIN 可管理本账户内的用户用户被删除时会自动退出所有用户组参见 Admin API 文档。因此豆包工作的组织管理员需要确保两件事一是豆包侧已向本组织开放 “OpenViking Context” 连接器二是 OpenViking 侧已为使用豆包的成员创建好对应账户与用户并分发 USER API Key形成一一对应的身份闭环。相关文档豆包工作接入文档英文版Agent 接入索引豆包工作条目MCP 集成指南 — 完整工具参数与OPENVIKING_PUBLIC_BASE_URL配置鉴权指南 —api_key/trusted等鉴权模式Admin API多租户 — 账户、用户、用户组与密钥管理快速开始 — 本地服务启动与OPENVIKING_API_KEY设置OpenViking 架构说明 — 上下文数据库设计【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 豆包工作接入 OpenViking Context 连接器：为豆包注入 OpenViking 持久化上下文记忆
豆包工作接入 OpenViking Context 连接器为豆包注入 OpenViking 持久化上下文记忆【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking本文以 OpenViking 仓库中 豆包工作接入文档 为核心主体完整讲解如何在豆包工作中安装、配置并验证 OpenViking Context 连接器同时结合仓库中的鉴权、API Key 与 MCP 集成实现说明从获取 USER API Key 到连接器真正可用的完整链路。读完本文你将掌握在豆包工作中为 AI 助手接入 OpenViking 上下文数据库的具体操作步骤、验证方法与故障排查手段并理解背后 API Key 与 MCP 工具的运作原理。为什么要在豆包工作中接入 OpenViking Context豆包工作是字节跳动推出的企业级 AI 工作平台用户可以在其中通过对话完成文档处理、信息检索与任务协作。而 OpenViking 是专为 AI Agent 设计的开源上下文数据库它将 Agent 所需的全部长期上下文——Memory记忆、Resource知识资源、Skill技能——统一抽象为目录结构并提供语义检索与渐进式内容加载能力参见 OpenViking 架构说明 与 快速开始。在豆包工作与 OpenViking 的集成场景中参见 Agent 接入索引豆包工作属于MCP 接入方式通过豆包工作原生的“技能·连接器·伙伴”能力安装 OpenViking 提供的官方连接器接入后即可让豆包在对话中自动召回 OpenViking 中存储的相关记忆并将新的对话内容沉淀回上下文数据库从而获得跨会话、可积累的持久化上下文能力。接入前的准备获取 OpenViking USER API Key安装连接器所需的唯一凭证是OpenViking USER API Key。理解这个 Key 的来龙去脉能帮你少走弯路。鉴权模式与密钥体系OpenViking 默认使用API Key 鉴权模式auth_mode: api_key只需在服务端配置root_api_key即可启用详见 鉴权指南。其密钥体系分为两类密钥用途获取方式root_api_key部署级管理密钥解析为 ROOT 身份在ov.conf中由管理员配置USER API Key普通用户身份供 MCP 连接器、SDK、CLI 使用通过 Admin API /ov admin命令创建从源码结构看openviking/server/api_keys/new.py当前用户密钥采用新格式base64url(account_id).base64url(user_id).base64url(secret)三段式结构。服务端可以直接从密钥中解码出账户与用户身份parse_api_key无需前缀索引查找密钥的 secret 部分仍通过 Argon2id启用api_key_hashing_enabled时或文件级 AES 加密保护。身份角色在 openviking/server/api_keys/models.py 中限定为USER或ADMINROOT身份只能来自root_api_key。创建用户并取得 USER API Key豆包工作连接器需要的是某个具体用户的 API Key即role: user或role: admin的账户成员密钥而非 root 密钥。创建方式详见 Admin API 文档方式一CLI推荐# 在 ovcli.conf 中配置了 root_api_key 的前提下创建账户 ov --sudo admin create-account acme # 在工作区 acme 中注册用户 bob返回 USER API Key ov --sudo admin register-user acme bob --role user方式二HTTP APIcurl -X POST http://localhost:1933/api/v1/admin/accounts/acme/users \ -H Content-Type: application/json \ -H X-API-Key: root-or-admin-key \ -d { user_id: bob, role: user, seed: bob-seed }方式三Python SDKimport openviking as ov client ov.SyncHTTPClient(api_keyroot-or-admin-key) client.initialize() result client.admin_register_user(account_idacme, user_idbob, roleuser) print(result[user_key]) # 这就是 USER API Key几点注意事项源自 Admin API 文档seed是可选的确定性密钥种子省略时使用随机密钥seed属于密钥材料过短容易被猜测生产环境建议省略。trusted模式下响应不会包含user_key字段。无法通过注册接口直接创建ROOT角色。密钥需要妥善保管。若泄露可随时重新生成regenerate_key会立即作废旧密钥参见 Admin API 文档。另外本地默认模式未启用鉴权下无需 API Key连接启用鉴权的 Server 时SDK/CLI 一般通过环境变量OPENVIKING_API_KEY提供密钥参见 快速开始。步骤 1安装 OpenViking Context 连接器拿到 USER API Key 后即可在豆包工作中完成连接器安装以下操作步骤以原 豆包工作接入文档 为基准打开豆包工作点击左侧导航栏的技能·连接器·伙伴搜索 “OpenViking Context”点击其右侧的。在弹出的“授权配置”窗口中填写 OpenViking USER API Key{{OPENVIKING_API_KEY}}即把你准备好的 USER API Key 粘贴到该字段环境变量OPENVIKING_API_KEY在豆包工作侧由该授权配置字段承载。点击保存并连接。当页面顶部出现“连接器已安装”提示且 “OpenViking Context” 右侧由变为“已添加”状态即表示接入完成。说明原文档此处配有界面截图位于线上文档站docs.openviking.net/agents/image/doubao-work/系列图片本仓库不包含该截图资源请以豆包工作实际界面为准。步骤 2验证接入是否生效连接器安装完成后按以下两步验证返回豆包主对话点击对话框下方的连接器确认能够找到 “OpenViking Context”。点击对话框下方的更多技能确认能够找到“OpenViking 上下文数据库”技能并让豆包调用 OpenViking 返回相关内容例如让豆包检索你已存入 OpenViking 的资源或记忆。验证通过后豆包工作即拥有 OpenViking 的持久化上下文能力对话中可自动召回相关记忆新内容也会被沉淀回上下文数据库。接入后能做什么连接器背后的 MCP 工具集“OpenViking Context” 连接器在服务端本质上连接的是 OpenViking 内置的MCP 端点http://server:1933/mcp与 REST API 同进程同端口参见 MCP 集成指南。豆包工作通过该连接器获得约 15 个 MCP 工具核心能力包括工具能力find/search语义检索search的modecontext可直接组装可注入的上下文remember将消息存储到长期记忆并触发记忆提取add_resource/read/write/edit添加与管理viking://资源文件、URL、目录list/tree/grep/glob浏览、搜索资源树forget删除任意viking://URIhealth检查服务健康状态工具中访问个人工作区时统一使用家目录别名viking://~它会展开为viking://user/当前用户因此不同用户在同一个 Server 上拥有互相隔离的上下文空间参见 MCP 集成指南。从 豆包工作接入索引 的定位来看豆包工作接入后主要获得的是持久化上下文记忆对话中自动召回相关记忆、存储新内容让企业用户在豆包工作中与 AI 协作的成果可跨会话复用。故障排查若接入过程中遇到问题参照下表定位源自原 豆包工作接入文档 的故障排查表问题处理搜索不到 “OpenViking Context”确认使用的是豆包工作而非其他豆包产品清除搜索条件后重新搜索若仍未出现请联系企业管理员确认连接器是否已对当前组织开放提示连接失败检查 OpenViking USER API Key 是否正确补充两个排查要点Key 过期或已重新生成如果管理员曾执行过regenerate_key旧 Key 会立即失效需要重新获取并在豆包工作的“授权配置”中更新参见 Admin API 文档。服务端不可达确认 OpenViking Server 正在运行且 MCP 端点可访问可执行curl http://localhost:1933/health预期返回{status: ok}参见 MCP 集成指南。企业管理员视角连接器的组织开放与多租户管理故障排查表提到“请联系企业管理员确认连接器是否已对当前组织开放”这对应豆包工作侧由企业管理员统一管理连接器的可见范围。而在 OpenViking 侧管理员负责的是账户与用户account / user的多租户管理账户account即工作区由 ROOT 创建每个账户下可注册多个用户角色为USER或ADMINADMIN 可管理本账户内的用户用户被删除时会自动退出所有用户组参见 Admin API 文档。因此豆包工作的组织管理员需要确保两件事一是豆包侧已向本组织开放 “OpenViking Context” 连接器二是 OpenViking 侧已为使用豆包的成员创建好对应账户与用户并分发 USER API Key形成一一对应的身份闭环。相关文档豆包工作接入文档英文版Agent 接入索引豆包工作条目MCP 集成指南 — 完整工具参数与OPENVIKING_PUBLIC_BASE_URL配置鉴权指南 —api_key/trusted等鉴权模式Admin API多租户 — 账户、用户、用户组与密钥管理快速开始 — 本地服务启动与OPENVIKING_API_KEY设置OpenViking 架构说明 — 上下文数据库设计【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考