### 3.7.1 人物百科
#### (1) 功能說明
人物百科問答包含著名詩人、演員、歌手、歷史人物等60萬+百科人物數據,支持簡介、出生日期、出生地、死亡日期、代表作、獲得獎項、朝代、主要成就、別名、宗教、職業等50+屬性查詢。
#### (2) 接口說明
**請求方法**
* POST
**請求地址**
* [http://api.ruyi.ai/v1/message](http://api.ruyi.ai/v1/message)
**請求參數說明**
| 參數名 | 參數類型 | 是否必須 | 參數說明 |
| :--- | :--- | :---: | :--- |
| q | String | 是 | 自然語言表達,例如“周杰倫是誰”,"孫中山是什么黨派"等 |
| app\_key | String | 是 | 應用開發者秘鑰,注冊開發者后臺賬號,建立虛擬助理后獲得 |
| user\_id | String | 是 | 用戶唯一標識,便于支持個性化語義解析。建議開發者使用 UUID 字符,且不同用戶必須用不同的 user\_id,防止意圖串。 |
#### (3) 返回說明
**返回參數說明**
| 名稱 | 類型 | 說明 |
| :--- | :--- | :--- |
| code | Integer | 返回代碼 |
| msg | String | 返回代碼描述 |
| parameters | JSON Object | 解析到的實體以及服務說明 |
| action | String | 服務的接口名稱 |
| name | String | 匹配的意圖名稱 |
| result | JSON Object | 接口返回內容 |
| outputs | Array | 服務輸出結果,微信端使用 type 類型為 wechat 開頭的內容;硬件端收到所有內容,依據需求解析使用 |
**返回代碼說明**
| 返回代碼 | 錯誤類型 | 說明 |
| :--- | :--- | :--- |
| 0/200 | 成功 | 請求成功 |
| 400 | 無效請求 | 某些必需參數缺失或參數值錯誤,詳見msg字段 |
| 401 | 未授權 | 授權失敗,app\_key 缺失或錯誤 |
| 403 | 請求被禁止 | 有效請求,但服務拒絕響應,請聯系contact@ruyi.ai |
| 408 | 請求超時 | 請求響應超時,一般響應時間設置為2000ms以內 |
| 429 | 短時間內大量訪問 | 短時間內請求數過多 |
| 500 | 內部錯誤 | 服務處理異常 |
| 503 | 服務不可用 | 服務異常或正在維護 |
#### (4) 請求示例
**請求范例**
_劉備是誰_
_劉備的圖片_
_居里夫人的國籍_
_姚明的身高_
_姚明的體重_
_姚明畢業于哪所高校_
_劉備在哪里出生_
_劉備生于哪一年_
_劉備死于哪一年_
_劉備去世的地方在哪里_
_居里夫人的職業_
_劉備的主要成就_
_劉備的性別_
_劉備是哪個朝代的人_
_玄德是誰_
_劉備的年號叫什么_
_劉備的廟號是_
_昭烈皇帝是誰_
_劉備的陵寢_
_劉備是漢族嗎_
_孫中山的代表作_
**請求示例**
* http://api.ruyi.ai/ruyi-api/v1/message?app_key=APP_KEY&user_id=user0&q=孫中山是誰
返回結果
```json
{
code: 0,
msg: "ok",
result: {
_text: "孫中山是誰",
msg_id: "a697dd17-bcba-499a-bfea-19193afff4d3",
intents: [{
parameters: {
id: "3323b4c6-e42d-3474-8196-ffb4e8eba771",
name: "孫中山"
},
action: "kg.entities",
name: "描述-description",
result: {
code: 200,
response: {
birthPlace: "廣東省香山縣翠亨村(今中山市南朗鎮翠亨村)",
description: "孫中山,名文,字載之,號日新,又號逸仙,幼名帝象,化名中山樵",
image: "http://f.hiphotos.baidu.com/baike/w%3D268%3Bg%3D0/sign=107d70ae2b34349b74066983f1d172f3/80cb39dbb6fd5266e546ada0a818972bd4073610.jpg",
birthDate: "1866年11月12日",
keywords: [
"政治人物",
"元首",
"人物"
],
nationality: "中國",
alternateName: [
"Sun Yat-sen",
"中山",
"逸仙",
"載之",
"日新",
"中山樵",
"帝象",
"SunYatsen"
],
deathDate: "1925年3月12日",
@id: "3323b4c6-e42d-3474-8196-ffb4e8eba771",
occupation: "革命家",
placeOfBurial: "江蘇省南京市玄武區中山陵",
name: "孫中山",
authorOf: "《民權初步》、《孫文學說》、《三民主義》、《實業計劃》等",
accomplishment: "1905年8月20日成立中國同盟會建立共和體制、建立中國國民黨開創中華民國、創建黃埔軍校、中山大學領導二次革命和護法運動",
alumniOf: "香港西醫書院(今香港大學)",
memberOfPoliticalParty: "興中會,中國同盟會,中國國民黨",
ethnicGroup: "漢族",
@type: [
"Person",
"Thing"
]
},
text: "孫中山,名文,字載之,號日新,又號逸仙,幼名帝象,化名中山樵",
type: "dialog"
},
outputs: [{
type: "wechat.text",
property: {
text: "孫中山,名文,字載之,號日新,又號逸仙,幼名帝象,化名中山樵"
}
},
{
type: "dialog",
property: {
text: "孫中山,名文,字載之,號日新,又號逸仙,幼名帝象,化名中山樵",
emotion: "calm"
}
}
],
score: "1.0",
scoreColor: "c4",
is_match: 1,
id: "aea767c5-228e-4e9f-b24e-f64988557fcf"
}],
meta_process_milliseconds: 131
}
}
```
人物屬性說明
cnschema字段| 中文屬性名|
|---|---
|name |姓名
|alternateName |別名
|description |簡介
|image |圖片
|keywords |標簽
|birthPlace |出生地
|birthDate| 出生日期
|deathDate| 死亡日期
|deathPlace| 死亡地
|placeOfBurial |墓地、安葬地
|gender |性別
|children| 子女
|parent| 父母
|sibling| 兄弟姐妹
|spouse |配偶、愛人
|husband |丈夫
|wife |妻子
|colleague |同事,隊友、戰友
|unmarriedPartner| 情侶
|studentOf |老師、師傅、導師
|student |學生、弟子、徒弟、門徒
|height| 身高
|weight |體重
|nationality| 國籍
|worksFor |工作單位
|jobTitle |工作職務、職位
|workLocation |工作地址
|homeLocation| 家庭地址
|alumniOf |畢業院校
|ancestralHome |籍貫
|occupation| 職業、身份
|cnProfessionalTitle |職稱
|fieldOfWork |領域,專業
|academicMajor| 高校專業
|ethnicGroup |民族、民族族群
|nobleFamily| 家族
|religion| 宗教信仰、信仰
|memberOfPoliticalParty |政黨、黨派
|courtesyName |字、表字
|artName |號
|templeName |廟號
|posthumousName| 謚號、私謚
|pseudonym |化名
|birthName |原名
|familyName| 姓氏
|accomplishment |主要成就
|authorOf |作品、代表作
|award |獎項, 獲獎
|earName |年號
|dynasty |朝代、所在年代、所處時代
|phoneNumber| 電話
|email |郵件
|father |父親
|mother| 母親
|dharmaName| 法號、法名
|schoolsOfBuddhism |宗派
|nobleTitle| 爵位、官爵、封爵、封號
|alumniOf| 畢業院校
|academicMajor| 所學專業
|academicDegree |學位
|cnEducationalAttainment |學歷
- 1. 海知智能第三方技能插件開放平臺概述
- 2. 快速接入API
- 2.1 硬件接口調用
- 2.2 快速接入微信
- 2.3 API接入常見問題
- 3. 技能插件
- 3.1 基礎能力類
- 頂級過濾器
- 用戶知識圖譜
- 機器人檔案
- 通用閑聊
- 兒童閑聊
- Smart Reply
- 輕量閑聊
- 3.2 語音游戲類
- 成語接龍
- 詞匯樂園
- 詞語接龍
- 鸚鵡學舌
- 動腦猜猜
- 挑戰單詞
- 冒險世界
- 猜猜我是誰
- 阿拉丁學詩詞
- 貓貓托管所
- 漂流瓶
- 詩詞大會
- 國學大會
- 我愛猜歌名
- 我在看著你
- 燈謎猜猜
- 3.3 休閑娛樂類
- 星座運勢
- 悅耳聲音
- 幸運簽
- 調教機器人
- 娛樂推送
- 3.4 生活服務類
- 黃歷
- 計算器
- 古詩詞
- 時間詢問
- 翻譯類技能
- 天氣資訊
- 日程創建
- 日程創建指令
- 鬧鐘
- 食材知識
- 冥想音樂
- 格言
- 每日英語
- 漢語詞典
- 豆果菜譜
- 古文翻譯
- 3.5 音頻點播類
- 喜馬拉雅FM
- 新聞廣播
- 音樂點播
- Smart Music
- 兒童聽聽
- Smart Audio
- 兒童笑話
- 點播控制指令
- 3.6 視頻點播類
- 影視點播
- 3.7 百科知識類
- 人物百科
- 百科問答
- 實時百科
- 3.8 體育健康類
- 五分鐘健身
- 4. 開發者初級教程
- 4.1 開通服務
- 4.2 創建機器人
- 4.3 設置機器人
- 4.4 獲取技能插件
- 4.5 讓機器人學會聊天
- 4.6 導入知識庫
- 4.7 多種問答形式
- 4.8 數據統計
- 4.9 粉絲管理
- 5. 開發者中級教程
- 5.1 詞典運用
- 5.2 意圖處理
- 5.3 暗號使用
- 5.4 事件觸發
- 5.5 優先級
- 5.6 觸發器
- 5.7 快捷鍵
- 5.8 意圖報錯
- 6. 開發者高級教程
- 6.1 handlebars模版語言
- 6.2 JavaScript簡單介紹
- 6.3 JavaScript使用說明
- 6.4 JavaScript使用案例
- 6.5 JavaScript常見問題
- 7. 快速發布技能
- 8. 幫助中心
- 8.1 常見概念
- 8.2 幫助視頻
- 8.3 聯系我們