T/CES 102-2022 电力人工智能知识图谱组件功能及接口规范

ICS 35.240.50
CCS L 65
团体标准
T/CES 102—2022
电力人工智能知识图谱组件功能及
接口规范
Function and interface specification of
power artificial intelligence knowledge graph component
2022-06-22 发布 2022-06-24 实施
中国电工技术学会 发布

T/CES 102—2022
I
目 次
前言................................................................................................................................................................... Ⅱ
1 范围............................................................................................................................................................... 1
2 规范性引用文件........................................................................................................................................... 1
3 术语和定义................................................................................................................................................... 1
4 缩略语........................................................................................................................................................... 2
5 系统架构....................................................................................................................................................... 2
5.1 电力知识图谱........................................................................................................................................ 2
5.2 总体架构................................................................................................................................................ 3
5.3 功能架构................................................................................................................................................ 4
5.4 知识图谱的构建方式............................................................................................................................. 4
6 功能模块....................................................................................................................................................... 4
6.1 知识建模组件能力................................................................................................................................ 4
6.2 知识存储组件能力................................................................................................................................ 5
6.3 知识计算组件能力................................................................................................................................ 5
6.4 知识融合组件能力................................................................................................................................ 5
6.5 知识获取组件能力................................................................................................................................ 5
6.6 知识应用组件能力................................................................................................................................ 5
7 服务接口....................................................................................................................................................... 5
7.1 接口总体规范........................................................................................................................................ 5
7.2 接口列表及能力描述............................................................................................................................. 6
8 性能指标....................................................................................................................................................... 6
8.1 知识建模性能指标................................................................................................................................ 6
8.2 知识存储性能指标................................................................................................................................ 6
8.3 知识抽取性能指标................................................................................................................................ 7
8.4 知识融合性能指标................................................................................................................................ 8
8.5 知识计算性能指标................................................................................................................................ 8
8.6 知识应用性能指标................................................................................................................................ 9
附录A（资料性附录） 知识图谱本体建模工具........................................................................................ 10
A.1 模型定义............................................................................................................................................. 10
A.2 模型引入............................................................................................................................................. 10
A.3 模型视图............................................................................................................................................. 10
A.4 属性分组............................................................................................................................................. 10
A.5 导入导出............................................................................................................................................. 10
附录B（资料性附录） 服务接口参数及返回值说明................................................................................. 11
B.1 图谱探索接口..................................................................................................................................... 11
B.2 图谱问答接口..................................................................................................................................... 12
B.3 知识推荐接口..................................................................................................................................... 12
B.4 知识卡片接口..................................................................................................................................... 13
B.5 图谱语句解析接口.............................................................................................................................. 14
T/CES 102—2022
II
前 言
本文件按照GB/T 1.1—2020《标准化工作导则 第1 部分：标准化文件的结构和起草规则》的规定
起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由国网信息通信产业集团有限公司提出。
本文件由中国电工技术学会标准工作委员会能源智慧化工作组归口。
本文件起草单位：国网信息通信产业集团有限公司、国家电网有限公司大数据中心、福建亿榕信息
技术有限公司、北京国网信通埃森哲信息技术有限公司、安徽继远软件有限公司、国网重庆市电力公司
电力科学研究院、四川大学、四川中电启明星信息技术有限公司、国网重庆市电力公司、中国电力科学
研究院有限公司、国网四川省电力公司、重庆大学、国网智能电网研究院有限公司。
本文件主要起草人：李强、刘迪、赵峰、邱镇、陈振宇、庄莉、李炳森、廖逍、黄晓光、刘永清、
向辉、谢可、张捷、谭洪恩、吕跃春、张凌浩、苏少春、杨迎春、周孔均、李博、钟加勇、彭舰、田鹏、
刘礼、吕小红、厉仄平、纪鑫、杨志、武同心、王准、杨智伟、张乐、江孔辰、任俊达、黄飞虎、王金
策、王晓东、张琳瑜、崔迎宝、刘璟、朱署光、尹玉、崔蔚、李温静、王卫卫、李道兴、甘津瑞、刘浩、
郭庆、梁翀、浦正国。
本文件为首次发布。
T/CES 102—2022
1
电力人工智能知识图谱组件功能及接口规范
1 范围
本文件规定了电力人工智能知识图谱组件的系统架构、功能模块、服务接口及性能指标规范要求等
内容。
本文件适用于电力生产供应，企业经营管理等专业对电力人工智能知识图谱组件的应用开发等环
节，各单位自建知识图谱工具应参照执行。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，
仅该日期对应的版本适用于本文件。
GB/T 28821—2012 关系数据管理系统技术要求
GB/T 37722—2019 信息技术 大数据存储与处理系统功能要求
GB/T 2900.103—2020 电工术语 发电、输电及配电 电力系统可信性及服务质量
GB/T 34654—2017 电工术语 标准编写规则
GB/T 2900.96—2015 电工术语 计算机网络技术
3 术语和定义
GB/T 28821—2012、GB/T 37722—2019 界定的以及下列术语和定义适用于本文件。
3.1
知识图谱 knowledge graph
知识图谱最早由Google 提出，是用于增强其搜索的知识库；其本质上是一种语义网络（semantic
network）；网络中的结点代表实体（entity）或者概念（concept），边代表实体/概念之间的各种语义关系。
[来源：Q/GDW12118.2—2021，3.7]
3.2
知识 knowledge
经维护、处理和解释后的信息。知识是一种经过验证为真的共同信念，是人对客观规律的认知。知
识是经过选择的信息，具有一定的目的性。知识是人对客观规律的认识与掌握，是通过人的思维重新组
合和系统化的信息。
3.3
本体 ontology
语义数据模型，用于定义事物的类型以及可用于描述它们的属性，是广义的数据模型，并不包含有
关具体个体的信息。
3.4
知识建模 knowledge modeling
建立知识图谱的概念模型和知识层次的活动，通过知识建模，知识图谱构建任务能够明确知识图谱
的本体结构。
T/CES 102—2022
2
3.5
资源描述框架 resource description framework
使用XML 语法来表示的资源模型（Resource model），用来描述Web 资源的特性，及资源与资源之
间的关系，其本质是一个数据模型（Data Model），由W3C 在1999 年2 月22 日颁布。
3.6
资源描述框架模型模式 RDF schema(RDFS)
用于定义元数据属性元素（例如“创建者”），以描述资源的一种定义语言。它在RDF 的基础上提
供了一个术语、概念的定义方式，以及哪些属性可以应用到哪些对象上，为RDF 模型提供了一个基本
的类型系统。
3.7
网络本体语言 Web ontology language
W3C 提出的对RDFS 扩展语言，用于对本体进行语义描述。
3.8
神经网络 neural networks
使用权值可调整加权链路连接基本处理元素后所组成的网络，通过把非线性函数作用到其输入值上
使每个单元产生一个值，并把它传送给其他单元或把它表示成输出值。
3.9
本体建模 ontology modeling
本体建模是动态知识图谱构建过程中非常重要的环节，可以很好地梳理实体以及实体间关系.在建
立研究领域研究数据的本体模型时应遵从Gruber 提出的完全性、一致性等原则，合理规范的进行研究
领域的本体构建。
4 缩略语
下列缩略语适用于本文件。
API：应用程序接口（Application Programming Interface）
HTTPS：超文本传输安全协议（Hyper Text Transfer Protocol over Secure Socket Layer）
OWL：网络本体语言（Web Ontology Language）
TPS：每秒处理的事务个数（Transactions Per Second）
XML：可扩展标记语言（Extensible Markup Language）
RESTful：表述性状态转移（Representational State Transfer）
5 系统架构
5.1 电力知识图谱
电力知识图谱以结构化方式刻画电力系统中的概念、实体、事件及其之间的关系，充分利用电力物
联网所承载的数据信息，为电力行业产业链提供一种更为有效的跨媒体大数据组织、管理、认知能力。
由于电力领域知识广泛来源于传统的电力知识工程系统、专家经验知识库等结构化数据与电力标准、制
度、法律、法规以及专家、技术人员的经验等半/非结构化数据，涉及多个业务领域，因而其知识也可
按照复用程度的差异划分为通用知识和专用知识两大部分。但是电力领域通用知识与专用知识之间的界
限具有模糊性，实际操作时需要根据实际业务进行统计分析来判定通用、专用知识之间的边界。
电力领域中的知识本体主要包括实体、概念、关系、属性、属性值、函数以及约束等方面内容。由
于不同层次的知识在表示复杂程度上有所差异，大部分领域知识图谱优先对实体、概念、关系、属性进
T/CES 102—2022
3
行知识建模。其本体架构可简单划分为概念层和实例层。实际的电力业务中存在大量诸如缴费、倒闸、
消缺等词语，既不属于概念范畴也不属于实例范畴，作为一种跟业务强相关的动作、事件、规范边界的
业务名词，无法准确的融合到概念层或实例层。针对上述情况，本文在研究电力领域知识本体建模时采
用3 层电力领域知识表示架构，如图1 所示，业务层作为概念层与实例层之间的桥梁，与动作、事件等
知识要素进行映射，形成3 层电力领域知识表示架构。在电力业务垂直领域进行本体迁移时，需要根据
业务领域知识同时更新概念层、业务层以及实例层的专用数据。
图1 电力领域知识表示架构图
5.2 总体架构
知识图谱组件应满足服务化建设原则，提供包括知识建模、知识存储、知识获取、知识融合等通用
知识图谱服务，应采用RESTful API 对外服务，实现知识图谱共性化服务建设，形成统一标准服务体系，
支撑各类业务应用。知识图谱组件总体架构如图2 所示。
图2 电力知识图谱组件总体框架
T/CES 102—2022
4
5.3 功能架构
知识图谱组件功能包括知识建模组件、知识存储组件、知识计算组件、知识融合组件、知识获取组
件及知识应用组件。知识图谱组件功能架构如图3 所示。
图3 电力知识图谱组件功能框架
5.4 知识图谱的构建方式
知识图谱的构建需要原始的数据进行抽象表达。按照数据的结构化程度来分，可以分为结构化数据、
半结构化数据和非结构化数据，根据数据的不同的结构化形式，采用不同的方法，将数据转换为三元组
的形式，然后对三元组的数据进行知识融合，主要是实体对齐，以及和数据模型进行融合，经过融合之
后，会形成标准的数据表示，为了发现新知识，可以依据一定的推理规则，产生隐含的知识，所有形成
的知识经过一定的质量评估，最终进入知识图谱，依据知识图谱这个数据平台，可以实现语义搜索，智
能问答，推荐系统等应用。图4 展示了知识图谱的构建方式。
图4 电力知识图谱的构建方式
6 功能模块
6.1 知识建模组件能力
知识建模组件应具备辅助用户建立知识图谱数据模型的能力，应支持多层级知识体系建模，应支持
T/CES 102—2022
5
自顶向下建模方式，应支持概念、属性的批量导入，并且能够及时的响应数据的变化，避免大量的模型
变更。知识图谱本体建模工具应具备的功能见附录A。
6.2 知识存储组件能力
知识存储组件应具备图谱数据接入与管理功能。针对图谱数据接入，应提供在线编辑、文件导入等
服务，并可实现知识图谱增量式构建；针对图谱数据管理，应提供图谱数据查看、图谱语言查询、知识
溯源等功能。
6.3 知识计算组件能力
知识计算组件应提供知识标引、知识推理等图谱数据计算功能，可通过实体标引多模态数据、实体
属性与关系推理方式扩展知识范围，应具备通过手工/批量两种方式将资源型数据与图谱数据的链接功
能，应支持概念、实体的知识标引及标引关系的再利用，且应具备通过业务规则配置方式，推理产生新
的关系，并接入图谱，实现知识补全。
6.4 知识融合组件能力
知识融合组件应实现将图谱中冗余知识进行融合，可通过自动计算或业务专家的干预等方式实现知
识融合，提升知识图谱的数据质量。
6.5 知识获取组件能力
知识获取组件应实现将不同来源、不同结构的数据转化成知识，再到知识图谱的过程，应包括对结
构化、非结构化数据的处理，应支持从数据库进行源数据接入。
6.6 知识应用组件能力
知识应用组件应具备图谱可视化分析及意图识别配置的能力，应以可视化的方式提供知识图谱可视
化、网络结构分析、统计分析、推理分析等应用。
7 服务接口
7.1 接口总体规范
接口总体规范从接口协议、域名、版本控制、路径规则、请求方式、命名规范六个方面进行规范和
要求。内容包括：
a） 接口协议：API 与客户端用户的通信协议，应使用HTTPS 协议，以确保交互数据的传输安全。
b） 域名：应尽量将API 部署在专用域名之下，例如https://api.example.com，如果确定API 很简单，
不会有进一步扩展，可以考虑放在主域名下，例如https://www.example.com/api。
c） 版本控制：应将API 的版本号放入URL 中，例如https://api.example.com/v{n}，n 代表版本号，
分为整型和浮点型，整型代表大功能版本，如v1、v2、v3 等，浮点型代表补充功能版本，如
v1.1、v1.2、v2.1、v2.2 等。采用多版本并存，增量发布的方式。对于一个API 或服务，应在
生产中至少保留3 个最详细的版本。
d） 路径规则：路径表示API 的具体地址，每个路径地址代表一种资源，所以路径地址中不能有动
词，只能有名词。数据库中的表一般都是同种记录的集合，所以API 中的名称也应该为复数。
例如https://api.example.com/v1/users、https://api.example.com/v1/schemas 等。
e） 请求方式：API 接口的请求方式包括GET、POST。
f） 命名规范：API 接口的方法命名，要符合一定规范。命名应使用中缀上限风格。以小写字母开
T/CES 102—2022
6
头，后面子单词的首字母也要大写，所有其他字母均为小写。不要使用下划线将单词隔开。例
如：add{XXX}。
7.2 接口列表及能力描述
接口列表对服务接口名称和能力进行定义与描述，详见表1。
表1 接口列表
序号 接口名称 接口能力描述
1 图谱探索接口
读取知识图谱的实体关系数据，支持按照节点类型、边类型过滤。接口请求参
数及接口返回值详见附录B
2 图谱问答接口
基于给定的知识图谱，进行图谱库中知识的问答，包括实体属性问答、实体关
系问答、属性约束问答、属性最值问答及多跳问答。接口请求参数及接口返回值
详见附录B
3 知识推荐接口
为某一实体进行特定多种关系的实体推荐，一般见于搜索引擎的右侧推荐区域。
接口请求参数及接口返回值详见附录B
4 知识卡片接口
读取实体的知识卡片，用于搜索引擎或百科的实体卡片。接口请求参数及接口
返回值详见附录B
5 图谱语句解析接口
可根据输入的语句，返回该语句的实体、属性、关系等信息。输入应为自然语
句。接口请求参数及接口返回值详见附录B
8 性能指标
8.1 知识建模性能指标
知识建模工具性能指标要求参见表2。
表2 知识建模工具性能指标
功能模块 指标要求 前置条件
建模工具平均响应时间＜2s —
知识建模
支持100 人同时开展在线编辑，同步更新周期＜3s —
8.2 知识存储性能指标
8.2.1 知识存储数据量级指标
知识存储数据量级指标要求参见表3。
表3 知识存储数据量级指标
功能模块 指标要求 前置条件
支持亿级别节点、百亿以内三元组知识的存储 —
知识存储
支持TB 级图谱数据存储 —
8.2.2 知识写入性能指标
知识写入性能指标要求参见表4。
T/CES 102—2022
7
表4 知识写入性能指标
功能模块 指标要求 前置条件
知识存储 批量写入速度≥50 000 三元组每秒 -
8.2.3 知识基础查询性能指标
知识基础查询性能指标要求参见表5。
表5 知识基础查询性能指标
功能模块 指标要求 前置条件
实体基础检索，返回节点总数不超过1 万个，时间≤1s 亿级别节点
实体属性检索，返回节点总数≤1 万个，响应时间≤1s 亿级别节点、十亿级别属性
多属性条件（≤2 个条件）检索，返回节点总数不超过1 万个，
响应时间≤2s
亿级别节点、十亿级别属性
知识图谱中单节点图谱探索响应时间＜1s 亿级别节点、十亿级别关系
知识图谱中4 步以内两节点路径发现平均响应时间＜1min 亿级别节点、十亿级别关系
知识存储
知识图谱中4 步以内多节点关联分析平均响应时间＜2min 亿级别节点、十亿级别关系
8.3 知识抽取性能指标
8.3.1 结构化知识抽取性能指标
结构化知识抽取性能指标要求参见表6。
表6 结构化知识抽取性能指标
功能模块 指标要求 前置条件
知识抽取 在数据源（接口）性能满足条件下，结构化知识抽取速度＞10 000 三元组每秒 —
8.3.2 非结构化知识抽取性能指标
8.3.2.1 实体抽取性能指标
实体抽取性能指标要求参见表7。
表7 实体抽取性能指标
功能模块 指标要求 前置条件
知识抽取 实体抽取，抽取结果平均准确率＞90%，平均召回率＞75% 标注语料数量＞1 000
8.3.2.2 关系分类性能指标
关系分类性能指标要求参见表8。
表8 关系分类性能指标
功能模块 指标要求 前置条件
知识抽取 关系抽取，抽取结果平均准确率＞85%，平均召回率＞75% 标注语料数量＞1 000
T/CES 102—2022
8
8.3.2.3 属性抽取性能指标
属性抽取性能指标要求参见表9。
表9 属性抽取性能指标
功能模块 指标要求 前置条件
知识抽取 属性抽取，抽取结果平均准确率＞85%，平均召回率＞75% 标注语料数量＞1 000
8.3.2.4 事件抽取性能指标
事件抽取性能指标要求参见表10。
表10 事件抽取性能指标
功能模块 指标要求 前置条件
知识抽取 事件抽取中触发词抽取的准确率＞90%，召回率＞75% —
8.4 知识融合性能指标
8.4.1 实体对齐性能指标
实体对齐性能指标要求参见表11。
表11 实体对齐性能指标
功能模块 指标要求 前置条件
知识融合 实体对齐算法的准确率＞90% —
8.4.2 属性融合性能指标
属性融合性能指标要求参见表12。
表12 属性融合性能指标
功能模块 指标要求 前置条件
知识融合 属性融合准确率＞85% —
8.5 知识计算性能指标
8.5.1 知识链接性能指标
知识链接性能指标要求参见表13。
表13 知识链接性能指标
功能模块 指标要求 前置条件
知识计算 知识链接准确率＞90%，召回率＞75% —
8.5.2 知识推理性能指标
知识推理性能指标要求参见表14。
T/CES 102—2022
9
表14 知识推理性能指标
功能模块 指标要求 前置条件
规则推理的准确率＞95%（给定推理的规则集及图谱中的事实，
对推理结果进行人工验证）
—
知识计算
在知识图谱基本完备（即包含推理目标需要的事实支撑）的基础
上，神经网络推理的准确率＞80%（对推理结果进行人工验证）
—
8.6 知识应用性能指标
8.6.1 知识搜索性能指标
知识搜索性能指标要求参见表15。
表15 知识搜索性能指标
功能模块 指标要求 前置条件
搜索吞吐量事务数/s（TPS）为100，单次搜索响应时间＜0.5s
记录数不高于1 000W（无索
引写入）
基础搜索的召回率和准确率不低于85%，top3 准确率不低于90% —
语义搜索的召回率和准确率不低于85%，top3 准确率不低于90% —
知识应用
词库的数量不少于1 万 —
8.6.2 知识问答性能指标
知识问答性能指标要求参见表16。
表16 知识问答性能指标
功能模块 指标要求 前置条件
实体识别准确率＞85%，需识别文本中的数字、时间、人名、地名、
机构名等信息
—
针对知识图谱中的知识查询问答准确率＞80% —
知识图谱中基础问答（实体属性、实体关系问答）响应时间≤1s 亿级别
知识图谱中约束类问答响应时间≤1s 亿级别
知识应用
知识图谱中多跳查询类问答响应时间≤2s 亿级别
8.6.3 知识卡片性能指标
知识卡片性能指标要求参见表17。
表17 知识卡片性能指标
功能模块 指标要求 前置条件
知识卡片将与实体相关、经过梳理的知识提供给用户的正确率＞85% —
知识卡片 用户满意度评价维度包括响应时间、用户负担、搜索结果的价值等 —
内容与结构包括对知识卡片提供的实体属性数量和实体属性的内容 —
T/CES 102—2022
10
附 录 A
（资料性附录）
知识图谱本体建模工具
A.1 模型定义
基于“概念-实体-属性-关系-事件-规则-链接”统一知识表示模型，应具备图谱模型构建功能，应支
持在线定义概念、属性、关系、边属性。
A.2 模型引入
模型发布可用于图谱模型共享；模型引入功能应具备通过引用其他图谱模型，从而实现快速构建目
标图谱模型。
A.3 模型视图
模型视图应包含概念可视化与关系可视化。概念可视化应具备展示概念的上下位关系、数值属性、
对象属性，并应具备模型报告导出功能。关系可视化应展示图谱模型中概念之间的关联关系，并支持可
视化结果的图片导出。
A.4 属性分组
属性分组应支持对图谱模型的数值属性、对象属性建立自定义分组，辅助业务应用。
A.5 导入导出
应提供图谱模型的批量导入导出能力，支持的格式应包含Excel、RDF、OWL。应可采用标准的资
源描述框架RDF 与网络本体语言OWL 格式进行模型的导入导出；并可通过Excel 模板文件导入进行图
谱概念、数值属性、对象属性的批量定义。
T/CES 102—2022
11
附 录 B
（资料性附录）
服务接口参数及返回值说明
B.1 图谱探索接口
B.1.1 接口请求参数
接口请求参数见表B.1。
表B.1 接口请求参数
参数 类型 是否必填 描述
graphId string 是 图谱ID
id string 否 实体id
kw String 否 实效体名称，当id 为空时生
distance integer 否 读取层数
highLevelSize integer 否 第二层以上节点查询个数，如果指定，第2 层及第2 层以上返回的节
点以此数为限
direction integer 否 查询边关系的方向，0 表示双向，1 表示出发，2 表示到达
allowAtts string 否 查询指定的属性，格式为json 数组，默认为查询全部
allowTypes string 否 查询指定的概念，格式为json 数组，默认为查询全部
replaceClassIds string 否 需要被替换后的classId 列表，格式为json 数组。
allowAttsKey string 否 属性唯一标识key 列表，当allowAtts 为空时生效，数据将被转换为
allowAtts 参数
allowTypesKey string 否 概念唯一标识key 列表，当allowTypes 为空时生效，数据将被转换为
allowTypes 参数
replaceClassIdsKey string 否 概念唯一标识key 列表，当replaceClassIds 为空时生效，数据将被转
换为replaceClassIds 参数
allowAttrGroups string 否 查询指定的属性分组，格式为json 数组，默认为不按照属性分组查询
attAttFilters string 否 边附加属性过滤条件，json 数组格式
attSorts string 否 边序按，照默边认的不附排件序属性排
reservedAttFilters string 否 保留边属性过滤条件，json 数组格式
isInherit bool 否 allowTypes 字段指定的概念是否继承
isRelationMerge bool 否 是否进行关系合并
privateAttRead bool 否 取读取私有属性，默认true
pageNo integer 否 页数，0 表示不分页
pageSize integer 否 每页数量
hyponymyDistance integer 否 上下位关系的读取层数，0 表示不读取
graphRule string 否 图搜索时其他业务筛选规则条件有委无此参
entityQuery string 否 节点过滤条件
graphBean string 否 在指定的图谱范围内进行图探索
T/CES 102—2022
12
B.1.2 接口返回值
接口返回值见表B.2。
表B.2 接口返回值
参数 类型 必需 详细说明
status integer 是
整体返回状态码
200=全部成功
500=失败
msg string 是 返回消息信息
data array of objects 是 返回结果
graph array of objects 是 实例的详细信息
B.2 图谱问答接口
B.2.1 接口请求参数
接口请求参数见表B.3。
表B.3 接口请求参数
参数 类型 是否必填 描述
graphId string 是 图谱ID
query string 是 查询问题
pageNo integereger 否 当前页数
pageSize integereger 否 每页数量
B.2.2 接口返回值
接口返回值见表B.4。
表B.4 接口返回值
参数 类型 必需 详细说明
status integer 是
整体返回状态码
200=全部成功
500=失败
msg string 是 返回消息信息
data array of objects 是 返回结果
answers array of objects 是 答案
B.3 知识推荐接口
B.3.1 接口请求参数
接口请求参数见表B.5。
T/CES 102—2022
13
表B.5 接口请求参数
参数 类型 必需 描述
graphId string 是 图谱ID
entityId long 否 实体id
kw string 否 实体名称
direction integereger 否
关系方向。默认正向，0 表示双向，1 表示出发，
2 表示到达，默认0
allowAtts string 否 推荐范围，格式为属性id 的json 数组
allowAttsKey string 否 唯一属性定义key，allowAtts 为空是生效
pageSize integereger 否 allowAtts 中每个id 返回结果的数量
B.3.2 接口返回值
接口返回值见表B.6。
表B.6 接口返回值
参数 类型 必需 详细说明
status integer 是
整体返回状态码
200=全部成功
500=失败
msg string 是 返回消息信息
data array of objects 是 返回结果
entities array of objects 是 推荐实体
B.4 知识卡片接口
B.4.1 接口请求参数
接口请求参数见表B.7。
表B.7 接口请求参数
参数 类型 必需 描述
graphId string 是 图谱ID
id long 否 概念或实体id
kw string 否 实体名称，当id 为空时生效
concept bool 否 是否为概念，默认值为false
isRelationAtts bool 否 是否读取对象属性
allowAtts string 否 查询组，默认为属性查询，全格部式为json
allowAttsKey string 否
属性唯一标识key 列表，当allowAtts 为空时生效，数
据将被转换为allowAtts 参数
T/CES 102—2022
14
B.4.2 接口返回值
接口返回值见表B.8。
表B.8 接口返回值
参数 类型 必需 详细说明
status integer 是
整体返回状态码
200=全部成功
500=失败
msg string 是 返回消息信息
data array of objects 是 返回结果
entity array of objects 是 返回实体
B.5 图谱语句解析接口
B.5.1 接口请求参数
接口请求参数见表B.9。
表B.9 接口请求参数
参数 类型 必需 描述
graphId integer 否 指定查询的图谱实例
query string 是 问题
B.5.2 接口返回值
接口返回值见表B.10。
表B.10 接口返回值
参数 类型 必需 详细说明
status integer 是
整体返回状态码
200=全部成功
500=失败
msg string 是 返回消息信息
data array of objects 是 返回结果
entities array of objects 是 问句中包含的实体集合
properties array of objects 是 问句中包含的实体属性集合
relations array of objects 是 问句中包含的关系集合