Menu
数据语义服务 API - 提供表单视图的语义理解功能。 用于: (1) 查询字段语义和业务对象识别结果 (2) 触发/批量理解表单视图 (3) 批量业务对象匹配
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
数据权限管理技能：支持资源权限查询与权限申请。 先判定“查询权限”还是“申请权限”，再按资源类型执行对应接口。 当用户提出“申请权限”、“查是否有权限”、“给某资源授权”时使用。
Guides creation of BKN (Business Knowledge Network) definition files following v2.0.1 spec. Covers network, object_type, relation_type, action_type, concept_group. Use when creating knowledge networks, BKN files, object types, relation types, action types, concept groups, or when user asks to model business knowledge in BKN format. When kweaver-core is also loaded, use it to run kweaver CLI (auth, bkn push) after files exist.
数据分析员工（Data Analyst Agent）的唯一总入口：凡与数据资产、取数、指标、表/视图、 治理职责、知识网络等相关的问题，必须先经本 skill 做编排与路由，再进入找表或问数等子流程。 当用户提出数据类问题、需要知识网络选择、或需要在找表与问数之间切换时使用。
向飞书指定用户（通过 user_id）推送消息。 支持文本、卡片、图片、文件等多种消息类型。当用户需要给飞书用户发送推送消息时自动使用。
全局归档协议。只要任务需要写入任何文件（含 PLAN.md、报告、JSON 等归档物），必须按本技能执行 Session→ARCHIVE_ID、TIMESTAMP、双轨路径（根段须为 archives/）、回读校验与状态回执；WebUI 的 archive_grid 必须用 Markdown 中语言标识为 json 的围栏代码块输出。
KWeaver CLI 操作层 — 内化自 kweaver-core。 覆盖认证、平台业务域（config）、知识网络管理与查询、Agent CRUD 与对话、 数据源管理、数据视图、Skill 注册、Vega 可观测、context-loader 语义搜索、通用 API 调用。 仅由 bkn-creator pipeline 内部读取，不独立注册到宿主 skill 系统。
| name | data-semantic |
| description | 数据语义服务 API - 提供表单视图的语义理解功能。 用于: (1) 查询字段语义和业务对象识别结果 (2) 触发/批量理解表单视图 (3) 批量业务对象匹配 |
| version | 1.2.0 |
| user-invocable | true |
| metadata | {"openclaw":{"skillKey":"data_semantic","emoji":"🧠"}} |
| config | {"kn_id":"d6ptuq46vfkhfektuntg","ot_id":"d6rmtl46vfkhfektuoe0","base_url":"https://dip.aishu.cn/api/data-semantic/v1","logic_view_base_url":"https://dip.aishu.cn/api/data-view/v1"} |
| 操作 | 说明 | 关键参数 |
|---|---|---|
list | 查询逻辑视图列表 | keyword, datasource_id |
query | 查询语义理解结果 | form_view_id |
understand | 触发表单理解 | form_view_id 或 datasource_id |
batch | 批量理解（≤100个） | form_view_ids |
match | 批量对象匹配 | kn_id, ot_id, entries |
| 参数 | 必填 | 说明 |
|---|---|---|
operation | ✅ | list/query/understand/batch/match |
auth_token | ✅ | JWT Token |
form_view_id | query/understand | 单视图 ID |
datasource_id | 数据源理解 | 数据源 UUID |
keyword | 可选 | 关键字搜索 |
operation: list
keyword: 用户
operation: query
form_view_id: <uuid>
输出：字段语义表格 + 业务对象表格 + 属性表格
operation: understand
form_view_id: <uuid>
输出：字段语义表格 + 业务对象表格 + 属性表格
operation: batch
form_view_ids: [<uuid1>, <uuid2>, ...]
输出：仅统计报告，不输出详细语义
operation: understand
datasource_id: <uuid>
≤50个视图直接执行，>50个调用Python脚本
operation: match
kn_id: <配置值>
ot_id: <配置值>
entries: [{"name": "客户信息"}]
| 状态码 | 状态名称 | 处理动作 |
|---|---|---|
| 0 | 未理解 | 触发生成 → 轮询等待 → 状态2后提交确认 → 重新生成 → 轮询 → 提交确认 → 完成 |
| 1 | 理解中 | 轮询等待 → 状态2/3/4 → 同状态2处理 |
| 2 | 待确认 | 提交确认 → 重新生成 → 轮询等待 → 状态2后提交确认 → 完成 |
| 3 | 已完成 | 触发重新生成 → 轮询等待 → 状态2后提交确认 → 完成 |
| 4 | 待确认(重新理解) | 触发重新生成 → 轮询等待 → 状态2后提交确认 → 完成 |
| 5 | 理解失败 | 输出失败原因，终止 |
⚠️ 批量理解时，无论当前状态是已完成(3)还是待确认(4)，都会触发重新理解
# 数据源批量理解
python scripts/data_semantic_batch.py --token <JWT> --datasource-id <UUID>
# 批量视图理解
python scripts/data_semantic_batch.py --token <JWT> --view-ids <id1,id2>
# 断点续传
python scripts/data_semantic_batch.py --token <JWT> --resume
📊 数据语义理解报告
| 项目 | 内容 |
|---|---|
| 视图技术名称 | <tech_name> |
| 视图业务名称 | <biz_name> |
| 理解状态 | <status_name> |
📈 识别统计
| 类别 | 统计 |
|---|---|
| 字段语义 | 总字段: <total>, 已补全: <completed> |
| 业务对象 | 对象: <count> 个, 属性: <attr_count> 个 |
| 技术名称 | 业务名称 | 字段角色 | 字段描述 |
|---|---|---|---|
| user_id | 用户ID | 业务主键 | 用户唯一标识 |
| user_name | 用户名称 | 业务特征 | 用户姓名 |
| create_time | 创建时间 | 时间字段 | 记录创建时间 |
| 技术名称 | 字段类型 | 字段描述 |
|---|---|---|
| ext_field1 | VARCHAR | 扩展字段 |
| 属性名称 | 字段技术名称 | 字段业务名称 | 字段角色 | 字段描述 |
|---|---|---|---|---|
| 客户ID | customer_id | 客户编号 | 业务主键 | 客户唯一标识 |
| 客户名称 | customer_name | 客户名称 | 业务特征 | 客户姓名 |
🧠 批量理解报告
| 项目 | 内容 |
|---|---|
| 总视图数 | <total_count> |
| 成功 | <success_count> |
| 失败 | <fail_count> |
批量理解仅输出统计报告，如需详情请单独查询
echo | curl -d @-