文档首页/ 知识图谱 KG/ API参考/ API/ 实体链接
更新时间：2024-04-24 GMT+08:00
查看PDF
分享

实体链接

功能介绍

对用户文本进行分析，识别出其中的实体，并返回图谱中关联节点的信息。

URI

POST /v1/{project_id}/kg/kg-instances/{kg_id}/apps/entity-linking

表1 路径参数

参数

是否必选

参数类型

描述

kg_id

是

String

知识图谱ID。在KG服务控制台“我的图谱”页面，单击图谱名称，进入图谱详情页左上角获取知识图谱ID。

project_id

是

String

用户项目ID。获取方法请参见获取项目ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

text

是

String

用户输入文本，长度限制为1-50个字符。

最小长度：1

最大长度：50

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

entities

Array of EntityLinkingRespEntityMention objects

实体链接结果。
表4 EntityLinkingRespEntityMention

参数

参数类型

描述

entity_id

String

链接到的图谱节点对应的实体id。

entity_title

String

链接到的图谱节点对应的实体名称。

mention

String

实体名称。

offset

Integer

实体文本在待分析文本中的起始位置。

请求示例

分析识别文本为 "李娜唱的青藏高原真好听"的实体

https://nlp-ext.cn-north-4.myhuaweicloud.com/v1/1604d8170cd84440a81281e5a3a04f8b/kg/kg-instances/6cdcea01-bac0-48f6-acb5-9385ea3e24ad/apps/entity-linking

{
  "text" : "李娜唱的青藏高原真好听"
}

响应示例

状态码： 200

OK

{
  "entities" : [ {
    "mention" : "李娜",
    "offset" : 0,
    "entity_id" : "6939670486880563336",
    "entity_title" : "李娜（流行歌手、佛门女弟子）"
  }, {
    "mention" : "青藏高原",
    "offset" : 4,
    "entity_id" : "8654144631589645401",
    "entity_title" : "青藏高原（李娜演唱歌曲）"
  } ]
}

状态码： 400

Bad Request

{
  "error_code" : "KGP.2007",
  "error_msg" : "kg not found"
}

状态码： 403

Forbidden

{
  "error_code" : "KGP.0004",
  "error_msg" : "Auth failed"
}

状态码

状态码

描述

200

OK

400

Bad Request

403

Forbidden

错误码

请参见错误码。

父主题： API

相关文档