知识图谱知识数据管理SKILL

更新时间:
复制 MD 格式

您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,管理知识图谱空间中的实体与关系数据,包括单条与批量的增删改查、Cypher图查询与邻居节点遍历。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。

功能介绍

知识图谱知识数据管理能力支持您通过自然语言指令,管理知识图谱空间中的实体与关系数据,常见包括创建、更新、删除与查询单条实体或关系,批量写入实体与关系,执行Cypher图查询,以及遍历某个实体的邻居节点。

适用场景:

  • 在已发布本体模型的知识图谱空间中录入或维护实体与关系数据。

  • 批量导入一批实体或关系。

  • 按类型、关键词或属性过滤查询实体与关系。

  • 通过Cypher图查询或邻居遍历,探索实体之间的关联关系。

说明

能力限制:实体与关系的增删改查在Neo4j与Lindorm两类图引擎上用法一致,但Cypher图查询仅在绑定Neo4j引擎的空间可用,Lindorm引擎空间不支持Cypher,一般会改用实体列表查询、邻居遍历与语义搜索组合代替;Cypher查询仅支持读取数据,不支持写入或修改;删除数据时通常会先删除关系再删除实体。

使用前提

  • 目标知识图谱空间已存在,且本体模型(Schema)已发布到图引擎,需要操作的实体类型与关系类型已在模型中定义。

  • 已获取目标知识图谱空间的空间ID。该ID无自助查询途径,需从Dataphin控制台的知识图谱空间列表页获取。

  • 写入实体或关系前,通常需先取得目标类型的主键与必填属性清单。

使用示例

您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:

  • 在知识图谱空间中创建一个公司实体,名称为阿里巴巴集团,行业为互联网。

  • 把这一批公司实体批量导入到指定的知识图谱空间。

  • 为A公司与B公司创建一条投资关系,持股比例为33%。

  • 查询知识图谱中行业为互联网的公司实体。

  • 用Cypher查询阿里巴巴集团对外投资了哪些公司。

  • 查看某个公司实体的一跳邻居及其关系。

交互步骤:

  1. Agent通常会先与您确认目标知识图谱空间ID,以及要操作的实体类型或关系类型。

  2. 写入实体或关系前,Agent通常会先获取该类型的主键与必填属性清单,补齐后一次提交,避免逐个字段试错。

  3. 创建、更新、删除实体或关系等写操作执行前,Agent通常会与您确认类型编码、属性内容与影响范围。

  4. 删除数据时,Agent通常会先删除相关关系,再删除实体。

  5. 执行Cypher图查询前,Agent通常会先确认空间绑定的图引擎是否为Neo4j,并为查询节点指定类型标签、设置返回条数上限。

执行结果

操作完成后,您可以获得以下结果:

  • 返回内容:创建实体返回实体ID,批量创建返回成功与失败数量,创建关系返回关系ID,查询返回实体或关系列表,Cypher查询返回节点、边或标量结果,邻居遍历返回邻居节点与连接关系。

  • 完成状态:以命令返回的成功标识与数量为准,批量写入时一般会同时返回成功数与失败数。

  • 查看与验证:可通过实体或关系查询、Cypher查询核对已写入的数据是否符合预期。

说明

命令行返回成功仅表示请求已受理,最终请以Dataphin界面显示的实际结果为准。

附录:输入信息

以下为管理知识图谱知识数据时可能涉及的信息项,仅供参考。实际使用时,Agent会根据您的指令自动识别所需信息,缺失时再向您询问;标注为无需提供的信息项由系统自动生成,您无需准备。

信息项

是否必填

说明

示例

租户ID

条件必填

已在凭证配置中指定时可省略。

1234567890123456789

知识图谱空间ID

是

目标空间ID,无自助查询途径,需从Dataphin控制台知识图谱空间列表页获取。

——

实体类型编码

实体操作必填

须在本体模型中已定义。

COMPANY

关系类型编码

关系操作必填

须在本体模型中已定义。

INVEST

实体或关系属性

写操作必填

属性编码须与本体模型定义一致,主键与必填属性须补齐。

名称=阿里巴巴集团

起始与目标实体ID

创建关系必填

关系两端的实体ID。

——

Cypher查询语句

Cypher查询必填

仅Neo4j引擎空间可用,节点须带类型标签。

MATCH (c:COMPANY) RETURN c.name

遍历深度与方向

否

邻居遍历可选,方向取In、Out、Both,默认Both。

深度1,双向