### 3.1.2 用戶知識圖譜
#### (1) 功能說明
1、用戶通過`我是你的主人我叫吳彥祖`對話引導,讓機器人記憶自己的姓名。設置完成后,詢問`我是誰`機器人即可回答`你是我的主人吳彥祖`,則完成設置;如果需要更改記憶的信息,則告訴機器人`忘記主人`清除記憶,重新設置。
2、用戶通過`當我說XX的時候你就說YY`的對話來訓練機器人像自己一樣說話,甚至讓機器人達到學習新知識的目的。問答訓練完成后立即生效。如果要讓機器人忘掉所學的東西,則告訴他`忘記對話`可刪除全部訓練數據。
#### (2) 接口說明
**請求方法**
* POST
**請求地址**
* 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=我是你的主人,我叫丸子
返回結果
```
{
"_text": "我是你的主人,我叫丸子",
"msg_id": "32232061-e000-42dd-ba3a-56b60d49e8d2",
"intents": [{
"parameters": {
"type": "ruyi-customized-user-info",
"upsert": "true",
"master": "丸子",
"item_status": "VALID",
"service": "memory"
},
"action": "sys.action.item/update",
"name": "姓名_我是你的主人,我叫xx",
"result": {
"updated_item": {
"_id": "6ac1718f-cb3e-4f00-b996-ee511a3f17c5",
"type": "ruyi-customized-user-info",
"master": "丸子",
"item_status": "VALID",
"service": "memory",
"appId": "2013efe4-0f8e-423e-848c-be31f9f54396",
"userId": "1487232964983",
"updated_time": 1487234439755,
"created_time": 1487234439755
},
"msg": "ok",
"text": "哦~~ 那我以后就叫你丸子了,可以嗎",
"type": "dialog"
},
"outputs": [{
"type": "wechat.text",
"property": {
"text": "哦~~ 那我以后就叫你丸子了,可以嗎"
}
}, {
"type": "dialog",
"property": {
"text": "哦~~ 那我以后就叫你丸子了,可以嗎",
"emotion": "suspect"
}
}],
"score": "1.0",
"scoreColor": "c4",
"is_match": 1,
"id": "0aec4575-cfbc-426a-b32e-53ae6710ff19"
}],
"meta_process_milliseconds": 73
}
```
**詳細參數說明**
名稱|類型|說明
---|---|---|---
service|string|服務名稱
master|string|用戶姓名
question|string|訓練機器人對話之提問
answer|string|訓練機器人對話之回答
- 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 聯系我們