开放能力
开发平台
行业应用
生态合作
开发与教学
资讯 社区 控制台
技术能力
语音技术
图像技术
文字识别
人脸与人体识别
视频技术
AR与VR
自然语言处理
知识图谱
数据智能
场景方案
部署方案
行业应用
智能教育
智能医疗
智能零售
智能工业
企业服务
智能政务
智能农业
信息服务
智能园区
智能硬件
知识理解

    汉语检索

    简介

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

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

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

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

    汉语检索接口

    接口描述

    汉语检索接口:融合需求识别与理解、知识推理与计算等AI认知层技术,基于百度汉语知识图谱积累的汉语字典及问答能力,提供汉语领域的知识检索服务。该接口支持汉语词典、汉语问答相关功能。

    汉语词典:可检索汉语的单字、词语、成语、诗词、古文、俗语歇后语、名言警句等,给出对应的拼音、笔画、释义、组词、百度百科等多个内容维度解释信息。

    汉语问答:根据用户的问题给出基于汉语知识场景的解答,例如检索“三个火念什么”、“秋开头的成语”等,可精准输出检索结果,回答汉语客观类知识问题。

    (备注:如需了解更多详情,请链接汉语检索产品页面了解更多,如有更多商务咨询,可提交工单申请。)

    请求说明

    • HTTP方法: POST
    • 请求URL: https://aip.baidubce.com/rpc/2.0/kg/v1/cognitive/chinese_search
    • URL参数:
    参数
    access_token 通过API Key和Secret Key获取的access_token,参考“Access Token获取
    • Header如下:
    参数
    Content-Type application/json
    • body请求示例:
    {
    "query": " 愚公移山 "
    }

    请求格式

    POST方式调用

    注意:要求使用JSON格式的结构体来描述一个请求的具体内容。

    body整体文本内容可以支持GBK和UTF-8两种格式的编码。

    1、GBK支持:默认按GBK进行编码,输入内容为GBK编码,输出内容为GBK编码,否则会接口报错编码错误

    2、UTF-8支持:若文本需要使用UTF-8编码,请在url参数中添加charset=UTF-8 (大小写敏感) 例如 https://aip.baidubce.com/rpc/2.0/nlp/v1/lexer?charset=UTF-8&access_token=24.f9ba9c5241b67688bb4adbed8bc91dec.2592000.1485570332.282335-8574074

    请求参数


    参数 说明
    query 用户的输入

    返回格式

    JSON格式

    默认返回内容为GBK编码

    若用户指定输入为UTF-8编码(通过指定charset参数),则返回内容为UTF-8编码

    返回参数

    参数 说明
    log_id 用于追查异常情况的日志 id
    result json 数组,存放结果
    request 错误码
    response 错误信息

    知识图谱服务 schema 定义

    字段 类型 含义
    request object (required) 请求数据(包括 query 解析结果
    response object (required) 结果数据

    Request 定义

    字段 类型 含义
    query string(required) 请求 query
    queryType string query类型,包括实体( entity ) 、属性问答(property) 、列表问答 (list)
    entityType string 实体类型
    entity object array query中的实体数据,仅当queryType = property 时存在
    property string 属性问答中的属性, 仅当queryType = property 时存在

    Response 定义

    字段 类型 含义
    entity object array 答案对应实体数据:1)queryType=entity 表示query所指的实体,2)queryType =property 表示答案所指的实体,3) queryType=list 表示答案列表所指的实体
    answer string array 答案
    totalEntityNum int 32 列列表问答中答案总数量
    voice string 语音播报内容
    sourceName string 资源方名称
    sourceUrl string 详情页链接
    title string 展现样式标题

    Entity 定义:

    字段 类型 含义
    @ id string 实体 id
    @type string array 实体类型
    @resource string 实体所在的资源库名称
    name string 实体名称
    attrs object array 实体属性列表

    Attrs定义:

    字段 类型 含义
    key string 属性名
    label string 属性中文名
    type string 属性类型 ( simple :普通类型属性, nested :嵌套类型属性 )
    objects object array 属性(值类型、边关系类型)
    order int 32 属性排序,表示属性的重要性

    Objects定义:

    字段 类型 含义
    @ id string 实体 id ,值类型属性无该字段
    @type string array 实体类型,值类型属性无该字段
    @resource string 实体所在的资源库名称,值类型属性无该字段
    @ value string 实体名称或者普通值类型
    attrs object array 嵌套属性

    实体类型数据示例:

     // 输出示例
        {
         "request":{
           "query": "愚公移山",
           "queryType": "entity"
                },
         "response":{
          "voice": "愚公移山,意思是:传说古代有一位老人名叫北山愚公,家门前有两座大山挡住了路,他下决心要把山平掉,另一个老人河曲智叟笑他太傻,认为不可能。愚公回说:"我死了有儿子,儿子死了还有孙子,子子孙孙是没有穷尽的。这两座山可不会再增高了,凿去一点就少一点,终有一天要凿平的。"(见于《列子·汤问》)比喻做事有毅力,有恒心,不怕困难。",
          "sourceName":"百度汉语"
          "sourceUrl":
         "http://hanyu.baidu.com/zici/s?wd=%E6%84%9A%E5%85%AC%E7%A7%BB%E5%B1%B1",
         "title": "愚公移山",
         "entity":[
        {
         "@type":["idiom"],
         "name":"愚公移山",
         "attrs":[
        {
         "key":"url",
         "label":"详情页",
         "type":"simple",
         "objects":[
        {"@value":
         "http://hanyu.baidu.com/zici/s?wd=%E6%84%9A%E5%85%AC%E7%A7%BB%E5%B1%B1"}]
         },
        {
         "key":"antonym",
         "label": "反义词",
         "type": "simple",
         "objects": [
        {"@value": "虎头蛇尾"},
        {"@value": "有头无尾"}
                 ]
         },
        {
         "key":"definition",
         "label":"释义释义",
         "type": "simple",
         "objects": [
        {"@value": "传说古代有一位老人名叫北山愚公,家门前有两座大山挡住了路,他下决心要把山平掉,另一个老人河曲智叟笑他太傻,认为不可能。愚公回答说:“我死了有儿子,儿子死了还有孙子,子子孙孙是没有穷尽的。这两座山可不会再增高了,,凿去一点就少一点,终有一天要凿平的。”(见于《列子·汤问》)比喻做事有毅力,有恒心,不怕困难。"}
                 ]
         },
        {
         "key": "source",
         "label": "出处",
         "type": "simple",
         "objects": [
        {"@value":"清·黄宗羲《张苍水墓志铭》:“愚公移山;精卫填海;常人藐为说铃;贤圣指为血路也。"}
                 ]
         },
        {
         "key":"spell",
         "label":"拼音拼音",
         "type":"simple",
         "objects":[
        {"@value":"[yú gōng yíshān]"}
                ]
         },
        {
         "key":"synonym",
         "label":"近义词",
         "type":"simple",
         "objects":[
                 {"@value": "持之以恒"},
                 {"@value": "铁杵磨针"},
                 {"@value": "精卫填海"},
                 {"@value": "铁杵成针"},
                 {"@value": "锲而不舍"}
                ]
          },
         {
          "key":"wubi",
          "label":"五笔",
          "type":"simple",
          "objects":[
         {"@value":"JWTM"}
                  ]
          }
                ]
         }
                ]
                 }
        }

    属性问答(值类型答案)数据示例:

    // 输出示例
    {
     "request":{
      "query":"赢的笔画数",
      "queryType":"property",
      "property":"笔画",
      "entity":[
        {
         "name":"赢",
         "@type":["word"],
         "attrs":[
           {
            "key":"image",
            "label":"图片",
            "type":"simple",
            "objects": [{"@value":
    "http://t11.baidu.com/it/u=387362101,389055632&fm=58&s=0B2C7022CAB117B97F39
    2CD70300E0A0"}]
            },
          {
           "key":"definition",
           "label":"释义",
           "type":"simple",
           "objects":[{"@value":"1.获利。2.胜。与“输”相对。3.通“盈”。充满"。}]
           },
           {
            "key":"radicals",
            "label":"部首",
            "type":"simple",
            "objects": [{"@value":"贝"}]
            },
            {
             "key":"spell",
             "label":"拼音",
             "type":"simple",
             "objects":[{"@value":"[yíng]"}]
            },
            {
             "key": "stroke_count",
             "label": "笔画笔画",
             "type": "simple",
             "objects":[{"@value":"17"}]
            },
            {
             "key":"stroke_order",
             "label":"笔顺",
             "type":"simple",
             ""objects": [{"@value": "点、横、竖折/竖弯、竖、横折、横、撇、横折钩、横、横、竖、横折、撇、点、撇、横折弯钩/横斜钩、点"}]
            },
            {
             "key":"stroke_order_gif",
             "label": "笔顺动画",
             "type":"simple",
             "objects": [{"@value": "http://appcdn.fanyi.baidu.com/zhdict/gif/b5ac76cf0899f4850a8f50bb6d3940568.gif"}]
            },
            {
             "key":"stroke_order_iconv",
             "label":"笔顺图标",
             "type":"simple",
             "objects": [{"@value": "4、1、14、2、5、1、3、9、1、1、2、5、3、4、3、19、4"}]
            },
            {
             "key":"wubi",
             "label":"五笔",
             "type":"simple",
             "objects": [{"@value": "YNKY"}]
             }
               ]
          }
            ]
            },
       "response":{
         "answer":["17"],
         "voice":"赢字共17画",
         "sourceName":"百度汉语",
         "sourceUrl":"http://hanyu.baidu.com/zici/s?wd=%E8%B5%A2&query=%E8%B5%A2%E7%9A%84%E7%AC%94%E7%94%BB%E6%95%B0&srcid=28533&from=kg2&from=kg2",
         "title": "赢的笔画"
               }
    }

    属性问答(实体类型答案)数据示例:

    // 输出示例
    {
     "request":
      "query":"春晓是谁写的",
      "queryType":"property",
      "property":"作者",
      "entity":[
        {
         "name":"春晓",
         "@type":["poem"]
         }
             ]
     },
       "response":{
        "voice":"春晓的作者是孟浩然",
        "sourceName":"百度知识图谱",
        "sourceUrl":"http://baike.baidu.com/view/7496.htm#sub7438677", 
        "title":"春晓的作者",
        "entity":[
          {
            "@type":["author"],
            "name":"孟浩然",
            "attrs":[
              {
               "key":"summary"
               "label":"摘要",
               "type":"simple",
               "objects":[
                {"@value":"孟浩然(689 740),男,汉族,唐代诗人。本名不详(一说名浩),襄州襄阳(今湖北襄阳)人,世称“孟襄阳”。浩然,少好节义,喜济人患难,工于诗。年四十游京师,唐玄宗诏咏其诗,至“不才明主弃”之语,玄宗谓:“卿自不求仕,朕未尝弃卿,奈何诬我?”因放还未仕,后隐居鹿门山,著诗二百余首。孟浩然与另一位山水田园诗人王维合称为“王孟”。"}
                       ]
                }
                   ]
           }
               ]
               }
               }

    列表问答数据示例:

    // 输出示例
    {
      "request":{
        "query":"带花的诗句",
        "queryType":"list"
             },
       "response":{
         "voice":"1.五花马,千金裘,呼儿将出换美酒,与尔同销万古愁。2.借问酒家何处有?牧童遥指杏花村。3.感时花溅泪,恨别鸟惊心",
         "sourceName":"百度汉语",
         "sourceUrl":
    "http://hanyu.baidu.com/s?wd=%E5%B8%A6%E8%8A%B1%E7%9A%84%E8%AF%97%E5%8F%A5",
         "title":"带花的诗句",
         "entity":[
          {
           "name":五花马,千金裘,呼儿将出换美酒,与尔同销万古愁",
           "@type": ["poemline"],
           "attrs":[
            {
             "key":"url",
             "label":"详情页",
             "type":"simple",
             "objects":[
              {"@value":
    "http://hanyu.baidu.com/shici/detail?pid=60841450e8714b78a6f7ef385dcb63e0"}
                    ]
              },
           {
            "key":"aurhor",
            "label":"作者",
            "type":"simple",
            "objects":[
            {"@value":"李白"}
                   ]
           },
           {
            "key":"dynasty",
            "label":"朝代",
            "type":"simple",
            "objects":[
           {"@value":"唐"}
                   ]
            }
                 ]
             },
       {
        "name":"借问酒家何处有?牧童遥指杏花村",
        "@type":["poemline"],
        "attrs":[
          {
           "key":"url",
           "label":"详情页",
           "type":"simple",
           "objects":[
            {"@value":"http://hanyu.baidu.com/shici/detail?pid=62bd01655ee04c60b01c1ee41bce805b"}
                  ]
           },
          {
           "key":"author",
           "label":"作者",
           "type":"simple",
           "objects":[
            {"@value":"杜牧"}
                  ]
           },
          {
           "key":"dynasty",
           "label":"朝代",
           "type":"simple",
           "objects":[
            {"@value":"唐"}
                  ]
           }
         ]
       },
       {
        "name":"感时花溅泪,恨别鸟惊心",
        "@type":["poemline"],
        "attrs":[
          {
           "key":"url",
           "label":"详情页",
           "type":"simple",
           "objects":[
           {"@value": "http://hanyu.baidu.com/shici/detail?pid=d68bb774aa644f37a101a2fc3197bc82"}
                  ]
           },
         {
          "key":"author",
          "label":"作者",
          "type":"simple",
          "objects":[
           {"@value":"杜甫"}
                 ]
          },
         {
          "key":"dynasty",
          "label":"朝代",
          "type": "simple",
          "objects":[
           {"@value":"唐"}
                 ]
           }
         ]
        }
       ]
      }
     }