向量数据库VikingDB
向量数据库VikingDB
- 文档首页
向量数据库VikingDBViking CLI & Skill
文档反馈
问问助手一、概述
Viking Skill 基于两层封装构建：
- CLI 层：将 Viking 平台的三大核心能力——向量数据库（VikingDB）、知识库（KnowledgeBase） 和 记忆库（Memory）——封装为统一的命令行工具
viking-cli，开发者可通过命令行直接操作 Viking 的全部核心功能。 - Skill 层：在 CLI 之上进一步包装为 Skill，用户只需用自然语言描述需求，Skill 会自动将其转换为对应的
viking-cli命令并执行。对于超出 CLI 覆盖范围的需求，Skill 会主动提示用户，避免无效操作。
二、步骤
2.1 安装 viking-cli
curl -fsSL http://viking-skills.tos-cn-beijing.volces.com/viking-cli/install.sh | bash
2.2 安装 viking-cli skill
链接： https://findskill.com/volcengine/viking/byted-viking-cli
# Trae npx skills add https://skills.volces.com/skills/volcengine/viking -s byted-viking-cli --agent trae # Trae-CN npx skills add https://skills.volces.com/skills/volcengine/viking -s byted-viking-cli --agent trae-cn # OpenClaw npx skills add https://skills.volces.com/skills/volcengine/viking -s byted-viking-cli --agent openclaw
三、使用方式
3.1 前置准备
- 申请火山云的编程账号 AK/SK
- 为账号授予 VikingdbFullAccess 和 TOSFullAccess 权限
开通对象存储 TOS 服务是为了将本地文件上传至知识库
3.2 初始化认证
# 执行auth命令 viking-cli auth # 输入 region、ak、sk、project 等全局信息 # 一键创建个人知识库 viking-cli knowledge setup # 一键创建个人记忆库 viking-cli memory setup # 一键创建个人向量库 viking-cli vikingdb setup --file /file/path/data.json --vectorize-field content_field
提示：
setup创建的 collection 默认命名为viking_cli_{userid}，后续命令在不指定--collection时自动使用该默认值
四、CLI 命令总览
在命令后使用 --help 可查看命令详情
4.1 通用命令
命令 | 说明 |
|---|---|
| 查看 CLI 版本 |
| 全局认证配置（AK / SK / Region / Project） |
4.2 向量数据库（vikingdb）
命令 | 说明 | 示例 Prompt |
|---|---|---|
| 用结构化文件（CSV / JSON / JSONL）一键创建数据集、索引并导入数据 | "把这个文件的数据一键导入到向量库：/Users/xxx/xxx.json" |
| 创建数据集 | "创建一个名为 test_db 的向量数据集" |
| 查询数据集详情 | "查看数据集 test_db 的信息" |
| 列出所有数据集 | "列出我的所有向量数据集" |
| 更新数据集 | "更新数据集 test_db 的描述" |
| 删除数据集 | "删除数据集 test_db" |
| 创建索引 | "为数据集 test_db 创建一个索引" |
| 查询索引详情 | "查看索引 test_index 的信息" |
| 列出所有索引 | "列出所有索引" |
| 更新索引 | "将索引 test_index 的 cpu_quota 调整为 4" |
| 启用索引 | "启用索引 test_index" |
| 禁用索引 | "禁用索引 test_index" |
| 删除索引 | "删除索引 test_index" |
| 导入本地文件到数据集 | "把 data.csv 导入到数据集 test_db" |
| 按 ID 获取数据 | "从 test_db 中获取 id1 和 id2 的数据" |
| 删除数据 | "删除 test_db 中 id1 和 id2 的数据" |
| 按 ID 相似搜索 | "在 test_db 中找和 id1 相似的 10 条数据" |
| 按关键词搜索 | "使用向量库 oncall_database_v2 的数据集，检索分析下知识库 API 接口 check sign" |
4.3 知识库（knowledge）
命令 | 说明 | 示例 Prompt |
|---|---|---|
| 一键创建个人知识库 | "创建一个知识库" |
| 创建知识库 | "创建 Viking 知识库，名为 viking_cli_test" |
| 查询知识库详情 | "查看知识库 viking_cli_test 的信息" |
| 列出所有知识库 | "列出我的所有知识库" |
| 删除知识库 | "删除知识库 viking_cli_test" |
| 添加文档（URL） | "将 https://xxx/xxx.pdf 添加到知识库 viking 中" |
| 添加本地文件到知识库 | "把 /Users/xxx/report.pdf 添加到知识库" |
| 添加本地目录下的文件到知识库 | "创建知识库 viking_cli_test，并将 /Users/xxx 目录中的文件添加进去" |
| 获取文档详情 | "查看知识库中文档 doc_001 的详情" |
| 列出知识库中的文档 | "列出知识库 viking_cli_test 中的所有文档" |
| 更新文档 | "更新文档 doc_001 的名称" |
| 删除文档 | "删除知识库中的文档 doc_001" |
| 知识库检索 | "在知识库中搜索关于 API 鉴权的内容" |
| 知识服务的检索与问答 | "基于知识库分析下 2025 Q1 财报的亮点" |
4.4 记忆库（memory）
命令 | 说明 | 示例 Prompt |
|---|---|---|
| 一键创建个人记忆库 | "创建一个记忆库" |
| 创建记忆库 | "创建一个名为 my_memory 的记忆库" |
| 查询记忆库详情 | "查看记忆库 my_memory 的信息" |
| 列出所有记忆库 | "列出我的所有记忆库" |
| 更新记忆库 | "更新记忆库 my_memory 的描述" |
| 删除记忆库 | "删除记忆库 my_memory" |
| 会话归档 | "使用记忆库 viking_cli，记录：今天排查了一个 API 超时问题" |
| 记忆检索 | "使用记忆库 viking_cli，检索用户接入 Viking 相关问题的处理方法" |