知识理解

简介

Hi,您好,欢迎使用百度知识图谱知识理解的API服务。

本文档主要针对API开发者,描述百度知识图谱的相关技术内容。如果您对文档内容有任何疑问,可以通过以下方式联系我们:

1.在百度智能云控制台内提交工单,咨询问题类型请选择人工智能-知识图谱;

2.百度AI社区--知识图谱官方版块:http://ai.baidu.com/forum/topic/list/174

接口能力

实体标注接口,支持输入一段中文短文本(64个汉字),识别短文本中的实体,并给出实体的分类、描述及百科实体链接等。

请求格式

请求URL数据格式
向API服务地址使用POST发送请求,必须在URL中带上参数access_token,可通过后台的API Key和Secret Key生成,具体方式请参考“Access Token获取”。
完整接口流程请参考:新手指南-接入指南

返回格式

JSON格式

实体标注接口

接口描述

实体标注接口,支持输入一段中文短文本(64个汉字),识别短文本中的实体,并给出实体的分类、描述及百科实体链接等。

备注:如需申请使用和提高调用额度,请通过实体标注介绍页面的“商务合作”提交申请;

请求说明

实体标注请求URL:https://aip.baidubce.com/rpc/2.0/kg/v1/cognitive/entity_annotation

HTTP方法:POST Header: application/json

输入参数

参数 类型 描述
data string 需要进行实体标注的文本字符串(最多64个汉字,utf8编码)
// 输入示例
curl -X POST 'https://aip.baidubce.com/rpc/2.0/kg/v1/cognitive/entity_annotation?access_token=【用户access_token】' -H 'content-type: application/json' -d '{"data": "刘德华的老婆"}'

输出参数

参数 类型 描述
log_id int 请求logid
entity_annotation array 实体标注结果的数组集合
_bdbkKgId string 百科newid
_bdbkUrl string 百科url
annoType string 标注类型:Instance |Category | Property
concept array 概念标注结果
+level1 string 一级概念
+level2 string 二级概念
confidence string 实体关联至该@id的置信度
desc string 实体的简介
mainReqRankList array 主需求实体,列出所有候选实体信息,根据热度从高到低排列
importance string 关联的实体在输入中的核心程度,越重要打分越高,打分区间为[0, 1]
mention string 实体在query中的名字
offset string 实体在query中的位置偏移
status string 用于对关联结果进行标识,包括LINKED(正常关联)|LINKED_MAINREQ(主需求关联) |NIL(NIL实体,即不在库中)| UNK (未知)四种种状态。
只有当status值为LINKED, LINKED_MAINREQ时,才为有效的关联结果,NIL及UNK可以认为是mention识别的结果但无法和库中已有id进行关联, 在entity_annotation层次下
// 输出示例
{
    "log_id": 6367018173853945311,
    "entity_annotation": [
        {
            "status": "LINKED",
            "confidence": "0.991616",
            "concept": {
                "level1": "人物",
                "level2": "文化人物,娱乐人物"
            },
            "_bdbkKgId": "114923",
            "mention": "刘德华",
            "_bdbkUrl": "http://baike.baidu.com/item/%E5%88%98%E5%BE%B7%E5%8D%8E/114923",
            "offset": "0",
            "desc": "中国香港男演员、歌手、词作人"
        },
        {
            "status": "LINKED",
            "confidence": "0.817889",
            "concept": {
                "level1": "语言文化",
                "level2": "文字词汇"
            },
            "_bdbkKgId": "827",
            "mention": "老婆",
            "_bdbkUrl": "http://baike.baidu.com/item/%E8%80%81%E5%A9%86/827",
            "offset": "4",
            "desc": "汉语词语"
        }
    ]
}

错误码

错误情形返回包体

{ 
    “error_code”:123455, 
    “error_msg”:”error description” 
    “log_id”: 12345567898 
}

错误码

错误码 英文描述 说明
100 Invalid parameter 包含了无效或错误参数,请检查代码
110 Access token invalid or no longer valid Access Token失效
111 Access token expired Access token过期
282000 internal error 内部错误
282356 input length exceeds limit 输入长度超限