| name | ontology-core |
| description | 操作 知识网络（BKN）— 构建知识网络、查询 Schema/实例、语义搜索、执行 Action。 操作数据源与数据视图 — 数据源连接与查询、原子/自定义视图浏览与 SQL 查询。 操作 Vega 可观测平台 — 查询 Catalog/资源/连接器类型、健康巡检。 当用户提到"知识网络"、"知识图谱"、"查询对象类"、"执行 Action"、 "数据源"、"数据视图"、"原子视图"、"Catalog"、"Vega"、 "健康检查"、"巡检"等意图时自动使用。 |
| allowed-tools | Bash(ontology *) |
| argument-hint | ["自然语言指令"] |
Ontology CLI
平台的命令行工具 ontology，覆盖知识网络管理与查询、数据源、数据视图、Vega 可观测、通用 API 调用。
安装
无需安装。ontology 已内置在执行环境，直接调用即可。
使用方式
ontology <command> [subcommand] [options]
完整子命令与参数以当前 CLI 为准：运行 ontology --help（或 -h）查看与代码同步的用法列表；查版本用 ontology --version / -V。子命令细节用 ontology <group> <subcommand> --help（例如 ontology bkn push --help、ontology dataview find --help）。
本 skill 下的 references/*.md 与 CLI 行为对齐；表格与 reference 为速查。
别名：ontology curl 等同于 ontology call。
业务域（business domain）：ontology CLI 没有 config 命令组；business domain 按命令传 -bd <value> 参数。本部署默认使用 bd_public，无需显式传入。
使用前提
**直接执行 ontology <command> 即可。
CLI 在同网络下会按服务名直连后端（vega-backend:13014、vega-bkn-backend:13014、vega-mdl-data-model:13020、vega-mdl-uniquery:13011、vega-data-connection:8098、vega-ontology-query:13018、vega-agent:5000），无需设置 ONTOLOGY_BASE_URL。
调用约定
ontology --user-id <accountId> <command> [options]
- 必须显式传
--user-id <accountId>（顶层选项，写在子命令之前）。本部署下所有命令组（bkn / ds / dataview / vega / call，含 curl 别名）都适用；缺省时调用会失败或语义错误
- 若未拿到 accountId，先向用户索要，不要自行编造或省略
- ontology CLI 没有
auth / token / config 命令组，无需任何登录或登录状态检查
- 出现 401/认证类错误时，直接报错，不要尝试刷新 token 或引导用户登录
业务域优先级
- 命令行
-bd <value> 参数（每条命令显式传入）
- 默认
bd_public
命令组总览
本部署仅运行 Vega 一侧的服务（vega-web / vega-backend / vega-bkn-backend / mdl-data-model / mdl-uniquery / data-connection / ontology-query 等）。
未部署 Decision Agent / Skill Registry / Toolbox / Dataflow 等服务，且 ontology CLI 自身也已移除 auth / config / agent / skill / toolbox / dataflow / context-loader 命令组，对应能力全部不可用。
| 命令组 | 说明 | 常用命令 | 详细参考 |
|---|
bkn | BKN 知识网络管理、Schema、查询、Action | bkn list、bkn get <id>、bkn search、bkn object-type、bkn validate/push、pull、create-from-ds/create-from-csv 等 | references/bkn.md |
ds | 数据源管理 | ds list、ds get <id>、ds tables <id>、ds connect ... | references/ds.md |
dataview | 原子/自定义数据视图（mdl-data-model） | dataview list、find --name、get、query（SQL / mdl-uniquery）、delete | references/dataview.md |
vega | Vega 可观测平台 | vega health、vega stats、vega catalog list、vega resource list、vega connector-type list | references/vega.md |
call | 通用 API 调用 | call <url> [-X POST] [-d '...']（可用 curl 别名） | references/call.md |
操作指南
按需阅读：需要子命令完整参数或编排示例时，读取对应的 reference 文件。
遇到关于 agent / skill / toolbox / dataflow / context-loader 的请求：先告知用户 ontology CLI 与本环境均未提供，不要尝试执行。
调用示例
ontology bkn list
ontology vega health
ontology ds list
ontology dataview list
注意事项
- 无需任何
export 环境变量：本部署 AUTH_ENABLED=false，CLI 也内置了所有服务的默认地址，直接执行 ontology <command> 即可
- 本部署 business domain 固定为
bd_public（ontology CLI 默认值）；如需切换业务域，使用 -bd <value> 参数显式传入
- 本部署不可用的命令组：ontology CLI 已无
auth / token / config；本部署也未提供 agent / skill / toolbox / tool / dataflow / context-loader 对应服务。用户提到 Agent / Skill / Toolbox / 数据流编排相关需求时，先说明环境不支持，不要尝试执行
- Action 执行有副作用，执行前向用户确认
- 出现 401 等认证错误时直接报错，不要尝试登录或刷新
查询策略（object-type query）
调用 object-type query 时必须限制 limit、用 search_after 分页、用 condition 过滤，避免宽表 JSON 截断。完整规则与示例见 references/bkn.md。
