您可以通过自然语言指令驱动Qoder、CodeX等代码Agent,管理知识图谱空间中的实体与关系数据,包括单条与批量的增删改查、Cypher图查询与邻居节点遍历。本文为您介绍该能力的功能、使用前提、使用示例与执行结果,并在附录中提供输入信息清单供参考。
功能介绍
知识图谱知识数据管理能力支持您通过自然语言指令,管理知识图谱空间中的实体与关系数据,常见包括创建、更新、删除与查询单条实体或关系,批量写入实体与关系,执行Cypher图查询,以及遍历某个实体的邻居节点。
适用场景:
-
在已发布本体模型的知识图谱空间中录入或维护实体与关系数据。
-
批量导入一批实体或关系。
-
按类型、关键词或属性过滤查询实体与关系。
-
通过Cypher图查询或邻居遍历,探索实体之间的关联关系。
能力限制:实体与关系的增删改查在Neo4j与Lindorm两类图引擎上用法一致,但Cypher图查询仅在绑定Neo4j引擎的空间可用,Lindorm引擎空间不支持Cypher,一般会改用实体列表查询、邻居遍历与语义搜索组合代替;Cypher查询仅支持读取数据,不支持写入或修改;删除数据时通常会先删除关系再删除实体。
使用前提
-
目标知识图谱空间已存在,且本体模型(Schema)已发布到图引擎,需要操作的实体类型与关系类型已在模型中定义。
-
已获取目标知识图谱空间的空间ID。该ID无自助查询途径,需从Dataphin控制台的知识图谱空间列表页获取。
-
写入实体或关系前,通常需先取得目标类型的主键与必填属性清单。
使用示例
您可以直接用自然语言向Agent描述需求,以下为可直接复制的指令示例:
-
在知识图谱空间中创建一个公司实体,名称为阿里巴巴集团,行业为互联网。
-
把这一批公司实体批量导入到指定的知识图谱空间。
-
为A公司与B公司创建一条投资关系,持股比例为33%。
-
查询知识图谱中行业为互联网的公司实体。
-
用Cypher查询阿里巴巴集团对外投资了哪些公司。
-
查看某个公司实体的一跳邻居及其关系。
交互步骤:
-
Agent通常会先与您确认目标知识图谱空间ID,以及要操作的实体类型或关系类型。
-
写入实体或关系前,Agent通常会先获取该类型的主键与必填属性清单,补齐后一次提交,避免逐个字段试错。
-
创建、更新、删除实体或关系等写操作执行前,Agent通常会与您确认类型编码、属性内容与影响范围。
-
删除数据时,Agent通常会先删除相关关系,再删除实体。
-
执行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,双向 |