القائمة
使用 OpenViking Admin 操作 OpenViking 知识与记忆能力的标准 Skill。凡是用户要检索知识、检索记忆、查看资源树、查询知识库或知识树、上传/导入文档、更新知识或记忆、查看导入进度、调用 OpenViking capability，或让大模型基于本项目处理知识资产时，都应优先使用本 Skill。它规定先检查并使用项目 MCP 能力；MCP 不可用时再使用 @openviking-admin/ova-cli；两者都不可用时，提示用户配置 MCP 或安装并配置 OVA CLI。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | openviking-admin |
| description | 使用 OpenViking Admin 操作 OpenViking 知识与记忆能力的标准 Skill。凡是用户要检索知识、检索记忆、查看资源树、查询知识库或知识树、上传/导入文档、更新知识或记忆、查看导入进度、调用 OpenViking capability，或让大模型基于本项目处理知识资产时，都应优先使用本 Skill。它规定先检查并使用项目 MCP 能力；MCP 不可用时再使用 @openviking-admin/ova-cli；两者都不可用时，提示用户配置 MCP 或安装并配置 OVA CLI。 |
本 Skill 指导 Agent 使用 OpenViking Admin 操作 OpenViking 的知识与记忆能力。目标是让模型优先复用项目已经暴露的能力入口，而不是绕过能力平台、臆造接口或直接操作数据库。
按以下顺序选择入口：
MCP -> OVA CLI -> 配置指引
不要把 HTTP 当作本 Skill 的默认兜底。HTTP 是平台能力的一等入口，但本 Skill 的职责是让大模型优先使用更适合 Agent 的 MCP，其次使用本地 CLI；只有在具体运行环境明确提供 HTTP 凭证和端点时，才可参考项目文档使用 HTTP。
当用户要求以下操作时使用本 Skill：
优先判断当前运行环境是否已经配置 OpenViking MCP。
可用迹象包括：
knowledge.searchknowledge.grepresources.listresources.treeknowledgeBases.listknowledgeBases.detailknowledgeTree.listknowledgeTree.detaildocuments.import.createdocuments.import.statusdocuments.extract.guidetools/list 看到上述 capability。如果 MCP 可用，直接使用 MCP tool 调用对应 capability。调用后在结果中保留 traceId，便于排障。
| 用户意图 | 首选 MCP tool |
|---|---|
| 语义搜索 | knowledge.search |
| 文本匹配 | knowledge.grep |
| 资源列表 | resources.list |
| 资源树 | resources.tree |
| 知识库列表 | knowledgeBases.list |
| 知识库详情 | knowledgeBases.detail |
| 知识树列表 | knowledgeTree.list |
| 知识树详情 | knowledgeTree.detail |
| 创建文档导入 | documents.import.create |
| 查看导入进度 | documents.import.status 或 documents.import.events |
| 导入任务列表 | documents.import.list |
| 取消导入 | documents.import.cancel |
| 重试导入 | documents.import.retry |
| 获取萃取规范 | documents.extract.guide |
文档导入来源仅使用 local、url、manifest。WebDAV 不作为导入来源。
如果没有可用 MCP，再检查是否能使用 @openviking-admin/ova-cli。
优先尝试以下命令之一：
ova doctor --output json
ova capabilities list --output json
在仓库开发环境中也可以使用：
npm run ova -- doctor --output json
npm run ova -- capabilities list --output json
如果 CLI 可用，使用 ova 调用能力，并优先使用 --output json 或 --output jsonl，方便 Agent 解析。
| 用户意图 | CLI 命令 |
|---|---|
| 语义搜索 | ova knowledge search --query <query> --output json |
| 文本匹配 | ova knowledge grep --pattern <pattern> --output json |
| 资源列表 | ova resources list --output json |
| 资源树 | ova resources tree --depth 2 --output json |
| 知识库列表 | ova kb list --output json |
| 知识库详情 | ova kb detail --id <kbId> --output json |
| 知识树列表 | ova tree list --kb <kbId> --output json |
| 知识树详情 | ova tree detail --id <nodeId> --output json |
| 创建文档导入 | ova documents import <url> --kb <kbId> --type url --output json |
| 查看导入进度 | ova documents import status --task <taskId> --output json |
| 查看进度事件 | ova documents import status --watch --task <taskId> --output json |
| 导入任务列表 | ova documents import list --output json |
| 取消导入 | ova documents import cancel --task <taskId> --output json |
| 重试导入 | ova documents import retry --task <taskId> --output json |
| 获取萃取规范 | ova documents extract guide --scenario <scenario> --output json |
如果 MCP 与 CLI 都不可用，不要假装已经完成操作。应明确告诉用户当前缺少可用入口，并给出两条可选配置路径。
用户需要先从 OpenViking Admin 控制台创建或获取 capability API key，然后在 MCP 客户端中配置服务。
Claude Desktop / MCP remote 示例：
{
"mcpServers": {
"ova_mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"http://localhost:6001/api/v1/mcp/sse?key=<ov-sk-...>",
"--transport",
"sse-only"
]
}
}
}
也可以使用短期 session key：
http://localhost:6001/api/v1/mcp/sse?sessionKey=<session-key>
全局安装：
npm install -g @openviking-admin/ova-cli
登录并生成本地 profile：
ova auth login \
--server http://localhost:6001 \
--username <username> \
--password <password> \
--tenant-code <tenantCode>
也可以只配置服务地址，再由用户登录：
ova config set --server http://localhost:6001
ova auth login --username <username> --password <password> --tenant-code <tenantCode>
仓库开发环境可使用：
npm run ova -- auth login \
--server http://localhost:6001 \
--username <username> \
--password <password> \
--tenant-code <tenantCode>
如果运行环境需要环境变量，建议提供：
OPENVIKING_ADMIN_BASE_URL=http://localhost:6001
OPENVIKING_TENANT_CODE=<tenantCode>
OPENVIKING_CAPABILITY_KEY=<ov-sk-...>
不要要求用户把密码写入长期环境变量。密码只用于交互登录或短期初始化。
执行能力调用后，回复用户时包含：
MCP 或 OVA CLI。traceId，如果响应中存在。当无法执行时，回复应包含：