Open Api接入文档
接口说明
接口地址
http接入： http://api.turingos.cn/turingos/api/v2 https接入：https://api.turingos.cn/turingos/api/v2
若对数据通信有较高的安全要求，建议选择https接入方式来访问图灵服务，由于ssl层验证预计会额外多花费40~50ms。
请求方法
Method: POST
Content-Type: application/json
编码方式：UTF-8
加密说明
Open API接口默认不加密（Biz平台可选择加密状态），为保证接口的安全性和稳定性，可对接口数据进行加密；
- 加密必须包含的信息：APIkey，Secret（需通过图灵Biz平台 - 机器人信息页获取）；
- 加密方式详见：测试demo
- 加密后请求示例如下：
{
"data":"加密后的内容",
"key":"ed474dae62*********67050faea1788",
"timestamp":"150******7793"
}
协议说明
请求示例
{
"data": {
"content": [{
"data": "你好"
}],
"userInfo": {
"uniqueId": "uniqueId"
}
},
"key": "ed474dae62********67050faea1788",
"timestamp": "150******7793"
}
请求参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| data | Json | Y | 请求参数 |
| key | String | Y | 用户apikey |
| timestamp | String | Y | 时间戳 |
data字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| content | json | Y | 输入信息 |
| userInfo | json | Y | 用户参数 |
| clientInfo | json | N | 客户端状态 |
data - content 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| type | int | N | 输入类型 type=0 文本（默认） type=4 主动交互 |
| data | String | Y | type=0 输入文本类型内容; type=4 主动交互，具体说明如下 |
data - userInfo 字段说明
| 参数 | 类型 | 是否必须 | 取值范围 | 说明 |
|---|---|---|---|---|
| uniqueId | String | Y | 1. 长度小于等于32位。 2. 需由字母或数字组成，其他字符可能导致部分功能错误！ |
用户唯一标识（与旧文档中userId一致），可隔离上下文 |
| requestIP | String | N | 客户端ip地址 | 可上传客户端ip地址 |
| useCodes | Array<int> | N | 应用code | 用户此次交互仅使用该参数中的应用 |
data - clientInfo 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| appState | json | N | 客户端状态 |
| robotSkill | json | N | 应用自定义参数 |
clientInfo - appState 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| code | int | Y | 应用code |
| operateState | int | Y | 请求应用时的状态值（与输出的operateState无关） |
clientInfo - robotSkill 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| key | String | N | 应用code |
| value | Array<int> | N | key应用使用的自定义参数 |
返回示例
{
"globalId": "523532****73091",
"intent": {
"code": 10002,
"operateState": 1100
},
"results": [
{
"groupType": 0,
"values": {
"text": "请告诉我您在哪个城市",
"emotionId": 0
},
"resultType": "text"
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| globalId | String | Y | 请求唯一标识，用于图灵排查日志 |
| intent | Intent | Y | 请求意图 |
| results | Array<Result> | N | 输出结果集 |
Intent 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| code | int | Y | 输出技能code |
| operateState | int | Y | 技能状态（每个技能单独定义） |
| intentName | String | N | 意图名称 |
| actionName | String | N | 意图动作名称 |
| parameters | Map | N | 应用参数 |
Intent - operateState 字段说明
| 通用operateState | 说明 |
|---|---|
| 1000 | 主动退出 |
| 1010 | 无上下文结束 |
| 1100 | 启动 |
| 1200 | 暂停 |
| 1300 | 继续 |
| 1400 | 等待重启 |
补充说明：
- operateState为技能意图，存在扩展性，可能后续会有新增。
- 每个技能会输出单独定义operateState，可在技能说明中，对应技能查看operateState
results 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| resultType | String | Y | 输出类型 文本（text） 链接（url） 音频（voice） 视频（video） 图片（image） 图文（news） 动作表情（action） |
| values | Map | Y | 输出内容（必包含key等于resultType的值） |
| groupType | int | Y | 组类型(普通接入可忽略该参数) 0为独立输出; 大于0时可能包含同组相关内容 |
TuringOs技能说明
儿童聊天(100000)
技能描述
儿童聊天基于图灵亿万级别的儿童语料库，回答活泼自然且正能量，在用户与机器人闲聊时，用户询问机器人一句话，机器人会通过对话语的理解返回相应的回答，并且回答符合儿童的聊天交互，语言温和恰当。
图灵在儿童聊天上提供了对交互用户的基本信息的记忆功能，信息会记录在图灵云端，丰富交互的乐趣。目前的记忆能力包括对姓名、年龄、性别、星座的记忆。重复告知机器人信息，第二次会覆盖第一次的信息。
普通返回示例
- 我们做朋友吧
{
"globalId": "121905844965310218",
"intent": {
"code": 100000,
"operateState": 1010
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"emotionId": 10300,
"sentenceId": 101,
"text": "当然。我们要做超级霹雳无敌可爱组合。"
}
}
]
}
记忆能力返回示例
- 我是小肖
{
"globalId": "111905849091110365",
"intent": {
"code": 100000,
"operateState": 1010
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"emotionId": 10300,
"sentenceId": 0,
"text": "小肖，好可爱的名字哟～"
}
}
]
}
- 我是谁
{
"globalId": "111905850627710127",
"intent": {
"code": 100000,
"operateState": 1010
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"emotionId": 0,
"sentenceId": 0,
"text": "小肖对不对？嘿嘿，难不倒小峰robot的哟～"
}
}
]
}
成语接龙(10005)
技能描述
成语接龙是图灵提供的学习成语的小游戏。接龙采用积分的形式，回答错误会继续进行，可以获取提示，成语有三次跳过的机会，三次跳过后会结束游戏并公布分值。此技能为多轮技能，记得退出哦。
使用说明
| 指令功能 | 指令词 |
|---|---|
| 进入语 | 成语接龙、我想玩成语接龙、进入成语接龙 |
| 正常回答 | 升官发财 |
| 提示答案 | 提示、提示一下 |
| 切换题目 | 换一个、换题、跳过 |
| 退出游戏 | 不玩了、退出游戏、退出 |
返回示例
- 成语接龙
{
"globalId": "111905887223610082",
"intent": {
"code": 10005,
"operateState": 1100
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "欢迎进入“成语接龙”游戏，接不上了可以跟我说“提示”、 “换题”或“跳过”； 不想玩了可以对我说 “退出” 。我就静静地看你能撑到第几个成语。请接：指日高升"
}
}
]
}
- 升官发财
{
"globalId": "111905893820810090",
"intent": {
"code": 10005,
"operateState": 2200,
"parameters": {
"success": true
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "哇~~~猴赛雷哦！接得好快！得1分。该我啦：【彩云易散】"
}
}
]
}
- 提示一下
{
"globalId": "121905896632410125",
"intent": {
"code": 10005,
"operateState": 2100
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "我就无奈地提示下吧：[三~两~, 散~碎~, 三~鼎~, 三真~~, 三~~烈]"
}
}
]
}
- 换一个
{
"globalId": "111905898594610333",
"intent": {
"code": 10005,
"operateState": 3110
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "看在你这么可爱的份上，我就换一题吧：参参伍伍"
}
}
]
}
- 不玩了
{
"globalId": "111905899822710095",
"intent": {
"code": 10005,
"operateState": 1400
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "听你哒，咱们就到这吧~~你这一轮总共答对了1道题!"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | int | Y | 1400：答题结束/退出 1110：再来(答题结束后有效) 1100：开始 3100：提示意图 2200：回答题目 3110：下一题 2210/2220：应用内无关意图 |
英文对话(100102)
技能描述
图灵提供的使用英文进行对话的功能，当你输入英文的时候，返回信息也是英文。
说法示例
1. Hello
2. I love you
返回示例
- I love you
{
"globalId": "121940785475710227",
"intent": {
"code": 100102,
"operateState": 1010
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "Thanks I like you a lot too my friend."
}
}
]
}
知识库(100302)
技能描述
基于图灵的NLU能力，精准命中用户预编写的问答对。支持相似问法扩展，并且支持通过对action、emotion的参数扩展（暂时只支持数字），来实现动作控制和表情控制。
使用方式
1.在【“Biz开放平台” - “机器人功能” - “知识库”】模块中点击“新增问题”，添加问题及答案；
2.选中答案文本，点击“添加表情和动作”，填写对应值；
3.当与机器人进行交互且命中预设问题时，将返回设置的动作及表情值，以便设备端进行相应处理；
返回示例
- 你好呀 【知识库中问答为： Q : 你好呀 A : 你的嘴真甜呢[emotion:5;action:7]】
{
"globalId": "111906526412410045",
"intent": {
"code": 100302,
"operateState": 1010,
"parameters": {}
},
"results": [
{
"groupType": 1,
"resultType": "text",
"values": {
"emotionId": 10300,
"text": "你的嘴真甜呢"
}
},
{
"groupType": 2,
"resultType": "action",
"values": {
"action": {
"emotion": "5",
"action": "7"
}
}
}
]
}
- 你好呀 【知识库中问答为： Q : 你好呀 A : 你的嘴真甜呢】
{
"globalId": "111906533185210286",
"intent": {
"code": 100302,
"operateState": 1010,
"parameters": {}
},
"results": [
{
"groupType": 1,
"resultType": "text",
"values": {
"emotionId": 10300,
"text": "你的嘴真甜呢"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| action | String | N | 动作指令 |
| emotion | String | N | 情感标志（可参考附录 - 情绪ID） |
operateState字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | int | Y | 1010：无上下文结束 |
歌曲点播(200101)
技能描述
歌曲点播是图灵提供的一套歌曲播放的能力。
使用说明
| 点播指令 | 示例 |
|---|---|
| 随机播歌 | 我想听歌、唱首歌 |
| 多轮操作 | 唱首歌、下一首、上一首、单曲循环、暂停播放、继续播放、停止 |
返回示例
- 我想听流行歌曲
{
"globalId": "111940932510310032",
"intent": {
"code": 200101,
"intentName": "play_music",
"operateState": 1100,
"parameters": {
"singer": "",
"name": "小朋友"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "我要开始唱小朋友了。"
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://iot-cdn.turingapi.com/202005121728/21ff96bc5abb490b93a7bc33136c55df/media/audio/791c0140b4d611e8ac31f48e3878ef95.mp3"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| singer | String | N | 歌手名 |
| name | String | N | 歌曲名 |
operateState字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | int | Y | 1100：开始 1101：无解析内容的开始（如：唱首歌） 2002：停止 1200：暂停 1300：继续 2005：上一首 2006：下一首 3001：随机播放 3002：单曲循环 3003：列表循环 |
故事点播(200201)
技能描述
故事点播是图灵提供的一套故事播放的能力。
使用说明
| 点播指令 | 示例 |
|---|---|
| 随机点播 | 我想听故事、讲个故事 |
| 多轮操作 | 讲个故事、下一个、上一个、单曲循环、暂停、继续、停止 |
返回示例
- 我想听故事
{
"globalId": "121940942972210253",
"intent": {
"code": 200201,
"intentName": "play_story",
"operateState": 1100,
"parameters": {
"author": "",
"name": "故事"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "我要开始讲故事了。"
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://iot-cdn.turingapi.com/202005121730/06285c4cb27bf431ca802522dd14f707/media/audio/20180524/2538443e47db41b9a8b26efcf7bdf3c7.mp3"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| author | String | N | 作者 |
| name | String | N | 故事名 |
operateState字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | int | Y | 1100：开始 1101：无解析内容的开始（如：唱首歌） 2002：停止 1200：暂停 1300：继续 2005：上一首 2006：下一首 3001：随机播放 3002：单曲循环 3003：列表循环 |
十万个为什么(200205)
技能描述
基于图灵的知识图谱与专属教育知识库构建的十万个为什么问答。
说法示例
1. 人为什么要喝水
返回示例
- 人为什么要喝水
{
"globalId": "121906409711410036",
"intent": {
"code": 200205,
"operateState": 1010
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "水是人类最必需的营养素之一,是吸收营养、输送营养物质的介质,又是排泄废物的载体,人通过水在体内的循环完成新陈代谢过程。在这个过程中水还具有人体散热,调节体温等作用,它对人类生命至关重要,所以人要喝水。"
}
}
]
}
绕口令(200207)
技能描述
绕口令是图灵提供的日常小技能，可以让机器人讲一个绕口令。绕口令是文字的形式返回。
说法示例
1. 讲个绕口令
返回示例
- 讲个绕口令
{
"globalId": "121905955999110343",
"intent": {
"code": 200207,
"intentName": "tongue_twisters",
"operateState": 1010
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "盘里放着一个梨，桌上放块橡皮泥。小丽用泥学捏梨，眼看着梨手捏泥，比比，真梨、假梨差不离。"
}
}
]
}
维基百科(200209)
技能描述
维基百科是图灵基于自身知识库，并结合维基百科的适合百科内容，搭建的百科问答能力。
说法示例
1. 深圳简介
2. 周杰伦是谁
返回示例
- 深圳简介
{
"globalId": "121905996008110032",
"intent": {
"code": 200209,
"intentName": "wiki",
"operateState": 1010,
"parameters": {
"wiki_keyword": "深圳"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "深圳，中国四大一线城市之一，广东省辖市，地处广东省南部，珠江三角洲东岸。深圳是中国改革开放建立的第一个经济特区，是中国三大全国性金融中心之一。"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| wiki_keyword | String | N | 意图中询问的百科本体 |
脑筋急转弯(200211)
技能描述
脑筋急转弯是图灵提供的日常小技能，有两轮交互。可以让机器人出一个脑筋急转弯，机器人会先给出问题，在用户说“答案”后，机器人会返回答案。
说法示例
两轮交互：
1. 说个脑筋急转弯
2. 答案
返回示例
- 说个脑筋急转弯
{
"globalId": "121905977566610256",
"intent": {
"code": 200211,
"intentName": "riddles",
"operateState": 1101,
"parameters": {
"answer": "答：很简单加顿号"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "问：你怎么区分东南西北？想知道答案吗？请对我说：“答案”。"
}
}
]
}
- 答案
{
"globalId": "121905978973410245",
"intent": {
"code": 200211,
"intentName": "find_answer",
"operateState": 1010
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "答：很简单加顿号"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 1101：输出问题 1010：答案输出(结束) |
顺口溜(200212)
技能描述
顺口溜是图灵提供的日常小技能，可以让机器人讲一个顺口溜，顺口溜是文字的形式返回。
说法示例
1. 讲个顺口溜
返回示例
- 讲个顺口溜
{
"globalId": "121905973392510318",
"intent": {
"code": 200212,
"intentName": "doggerel",
"operateState": 1010
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "一天到晚，二目无光，三餐不食，四肢无力，五谷不分，六亲不认，七窃不通，八面威风，久坐不动，十分无用。"
}
}
]
}
动物叫声(200301)
技能描述
动物叫声是模仿动物叫声的一个趣味小应用。
说法示例
1. 狗的叫声
返回示例
- 狗的叫声
{
"globalId": "111907543622710108",
"intent": {
"code": 200301,
"intentName": "animal_sounds",
"operateState": 1010,
"parameters": {
"english": "dog",
"name": "狗",
"animalName": "狗"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "请听狗的声音。"
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://iot-cdn.turingapi.com/202005082043/02fd4b4ae7259b7199f752af4d4031f6/media/audio/2018-10-16/de27ffec-d50f-414b-9a06-ac0e282881ad.mp3"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| english | String | N | 意图中动物英文名称 |
| name | String | N | 意图中动物名称 |
| animalName | String | N | 实际输出的动物名称 |
大自然声音(200302)
技能描述
大自然声音是机器人模仿大自然的声音的一个趣味小应用。
说法示例
1. 打雷的声音
2. 下雨的声音
返回示例
- 打雷的声音
{
"globalId": "111907563892510441",
"intent": {
"code": 200302,
"intentName": "natural_sounds",
"operateState": 1010,
"parameters": {
"name": "雷",
"resourcesName": "雷"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "请听雷的声音。"
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://iot-cdn.turingapi.com/202005082047/38c9a4decee9aa89743cf9fbcae62b52/media/audio/20181207/fbe88e3ab5e3460884a52ab89f9b1859.mp3"
}
}
]
}
字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| name | String | N | 名称 |
乐器声音(200303)
技能描述
乐器声音是机器人模仿乐器的声音的一个趣味小技能。
说法示例
1. 钢琴的声音
返回示例
- 钢琴的声音
{
"globalId": "121907662933210151",
"intent": {
"code": 200303,
"intentName": "music_instrument",
"operateState": 1010,
"parameters": {
"name": "钢琴",
"resourcesName": "钢琴"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "请听钢琴的声音。"
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://iot-cdn.turingapi.com/202005082103/99a2372537d74273a0ce180beb83b713/media/audio/3a691b281af311e99fd860f6774f01f9.mp3"
}
}
]
}
字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| name | String | N | 名称 |
诗词背诵(200401)
诗词背诵
诗词背诵是图灵提供的一套诗词学习能力，可以让机器人背诵各朝各代的诗词，可以询问诗词的作者、诗词的上下句等。当诗词有音频资源（即朗诵版）时，图灵会优先返回音频资源的朗读，如果没有则会返回诗词的文字。
使用说明
| 指令 | 示例 |
|---|---|
| 背诵诗词 | 背诵静夜思 |
| 询问作者 | 登鹳雀楼的作者是谁 |
| 类型背诵 | 背诵一首唐诗 |
| 作者点播 | 背诵杜甫的诗 |
| 询问上下句 | 举头望明月的上一句是什么 |
返回示例
- 背诵一首唐诗
{
"globalId": "111941102723010069",
"intent": {
"code": 200401,
"intentName": "read",
"operateState": 1100,
"parameters": {
"author": "刘昚虚",
"name": "阙题",
"type": "诗",
"years": "唐代",
"content": "道由白云尽，春与青溪长。时有落花至，远随流水香。闲门向山路，深柳读书堂。幽映每白日，清辉照衣裳。"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "阙题 唐代 刘昚虚 道由白云尽，春与青溪长。时有落花至，远随流水香。闲门向山路，深柳读书堂。幽映每白日，清辉照衣裳。"
}
}
]
}
- 举头望明月的上一句是什么
{
"globalId": "121941117559710210",
"intent": {
"code": 200401,
"intentName": "sentence",
"operateState": 1100,
"parameters": {
"author": "李白",
"name": "静夜思",
"type": "诗",
"years": "唐代",
"content": "床前明月光，疑是地上霜。举头望明月，低头思故乡。"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "疑是地上霜"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| years | String | N | 年代 |
| author | String | N | 作者 |
| name | String | N | 诗名 |
| type | String | N | 诗词类型 |
| content | String | N | 诗词内容 |
operateState 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 1100：开始 1101：无解析内容的开始(如:诗词背诵) 2005：上一首 2006：下一首 |
拍照(200501)
技能描述
拍照功能是图灵提供的小能力，用于需要拍照指令的机器。
说法示例
1. 给我拍个照
2. 拍张照片
返回示例
- 给我拍个照
{
"globalId": "121940777859910227",
"intent": {
"code": 200501,
"intentName": "take_picture",
"operateState": 11000
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "拍照开始。"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 11000：进入拍照 |
跳舞(200701)
技能描述
模拟跳舞的一个小技能。
说法示例
1. 跳舞、跳个舞、跳个舞吧
返回示例
- 跳个舞吧
{
"globalId": "121907675556910284",
"intent": {
"code": 200701,
"intentName": "dance",
"operateState": 11000,
"parameters": {
"song": "",
"singer": ""
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "好的，我要开始啦！"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 11000：开始 11001：暂停 11002：继续 12003：上一个 12004：换一个 |
日期查询(200702)
技能描述
日期查询是图灵提供的一套查询日期的能力，包括对日期的查询、对阳历阴历的查询、对节日的查询、对星期的查询。
说法示例
| 指令 | 示例 |
|---|---|
| 查询日期 | 今天是几号 |
| 查询星期 | 今天是周几 |
| 查询节日 | 端午节是哪一天 |
| 查询阴历 | 八月二十五日的阴历 |
返回示例
- 今天是几号
{
"globalId": "121940731813110049",
"intent": {
"code": 200702,
"intentName": "date_query",
"operateState": 1010,
"parameters": {
"currentTime": 1589266518251,
"dateType": "date"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "今天是2020年5月12日。"
}
}
]
}
时间查询(200702)
技能描述
时间查询是图灵提供的查询时间的功能，可以查询现在的北京时间。
说法示例
1. 现在是几点
2. 几点了
返回示例
- 现在是几点
{
"globalId": "121940738997110346",
"intent": {
"code": 200702,
"intentName": "time",
"operateState": 1010,
"parameters": {
"currentTime": 1589266590094,
"dateType": "time"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "现在时间是2020年5月12日14点56分。"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 1010：进入技能并无上下文结束 |
闹钟(200710)
技能描述
闹钟是图灵提供的闹钟定制功能，可以解析设定闹钟的语句并返回需要设定的闹钟的时间、事件等参数给前端，前端通过返回的参数去进行闹钟的记忆和设置。
说法示例
1. 十分钟后叫我
2. 下午三点叫我起床
3. 每天下午三点叫我起床
4. 每周三下午三点叫我起床
5. 下午六点提醒我吃饭
返回示例
- 下午三点叫我起床
{
"globalId": "111940769176310288",
"intent": {
"code": 200710,
"intentName": "alarm",
"operateState": 1010,
"parameters": {
"memoContent": "起床",
"cycleType": 0,
"alarmType": "remind",
"endDate": "2020-05-13",
"timeLen": "",
"action": "add",
"alarmTag": "alarmClock",
"time": "15:00:00",
"startDate": "2020-05-13"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "好的，我会在5月13日的15点提醒你的。"
}
}
]
}
返回参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| cycleType | String | 是否重复： 0-不重复； 1-每天重复； 2-每周重复； 3-每月重复； |
| alarmType | String | 闹钟类型： alarmClock-闹钟； remind-提醒； countDown-倒计时； |
| endDate | String | 截止日期（yyyy-MM-dd） |
| timeLen | String | 距离当前的时间长度 |
| alarmTag | String | 闹钟标签 |
| time | String | 闹钟时间（HH:mm:ss） |
| startDate | String | 开始日期（yyyy-MM-dd） |
| action | String | 闹钟的操作类型: add-添加； delete-删除； |
| memoContent | String | 事件内容 |
打电话(200802)
技能描述
打电话功能是图灵提供的拨打电话的解析能力，可以给号码拨打，也可以给姓名拨打，图灵会返回相应的号码或姓名的解析结果。可配合电话速记技能使用，电话速记技能开通请联系商务。
说法示例
1. 打电话给100xx
2. 打电话给爸爸
返回示例
- 打电话给100xx
{
"globalId": "121940878465610237",
"intent": {
"code": 200802,
"intentName": "phone_call",
"operateState": 200201,
"parameters": {
"address_blank": false,
"address_list": [
{
"pinyin": "none none none none none",
"receiver": "",
"name": "100xx"
}
],
"is_nodirect": true,
"phone_number": "",
"people_name": "100xx",
"match_value": 1
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "正在拨打给100xx"
}
}
]
}
- 打电话给爸爸
{
"globalId": "111940880552610178",
"intent": {
"code": 200802,
"intentName": "phone_call",
"operateState": 200201,
"parameters": {
"address_blank": false,
"address_list": [
{
"pinyin": "ba ba",
"receiver": "",
"name": "爸爸"
}
],
"is_nodirect": true,
"phone_number": "",
"people_name": "爸爸",
"match_value": 1
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "正在拨打给爸爸"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| people_name | String | N | 姓名或机构名 |
| phone_number | String | N | 电话号码 |
| is_nodirect | bool | N | 是否直接拨打 |
| address_blank | bool | N | 云端通讯录是否为空 |
| match_value | int | N | 匹配到的联系人数量 |
| address_list | Array<ContactInfo> | N | 联系人数组，详见ContactInfo字段说明 |
ContactInfo 字段说明
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| name | String | 联系人名称 |
| receiver | String | 号码 |
| pinyin | String | 拼音 |
operateState 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 200201：进入打电话 |
笑话(201204)
技能描述
笑话技能是图灵提供的日常小技能，可以 让机器人讲一个笑话。笑话是文字的形式返回。
说法示例
1. 讲个笑话
返回示例
- 讲个笑话
{
"globalId": "111905929033510125",
"intent": {
"code": 201204,
"intentName": "joke",
"operateState": 1010
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "爸爸讲成语鹬蚌相争时，说：“蚌把鹬的嘴夹上以后，蚌说我今天不松嘴，明天不松嘴。太阳就会把你晒死的！”6岁的孩子听到这里，问爸爸：“蚌说话是不用嘴的吗?不用嘴能讲话吗?那它讲话时，嘴不就松开了吗？”"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 1010：讲笑话/技能内换一个 |
天气查询(201401)
技能描述
天气查询是图灵提供的一套天气查询能力，可以查询国内各地区的天气，并且可以查询今天、明天、后天等时间的天气，且具有上下文的能力。
天气查询的逻辑：
没有使用extra扩展参数请求时：当没有携带相应城市名称信息时，会反问用户在哪个城市，收到城市名称后，会报出当前天气。
当使用了extra扩展参数请求时：支持在每次请求时携带含有城市名、GPS经纬度、IP的相关信息。这时询问天气时，如果请求是“北京天气如何”，会返回北京的天气信息，如果请求是“今天天气怎么样”，会按照extra扩展参数中上传的信息返回相应天气信息。当请求中携带了上述信息时，会按照如下优先级查询天气：请求中携带地址>城市名>经纬度>IP。
说法示例
携带城市名称信息:
1. 深圳天气怎么样
2. 明天深圳天气怎么样
未携带城市名称信息:
a. 上海今天天气怎么样
b. 深圳
c. 明天
返回示例(携带城市名称信息)
- 深圳天气怎么样
{
"globalId": "121940474338510138",
"intent": {
"code": 201401,
"intentName": "ask_weather",
"operateState": 1010,
"parameters": {
"date": "2020-05-12",
"city": "深圳市",
"weather": {
"date": "2020-05-12",
"pm25": 17,
"nowTemp": "28℃",
"weatherDetails": [
{
"date": "周二",
"maxTemperature": 29,
"minTemperature": 23,
"temperature": "29 ~ 23℃",
"weather": "雷阵雨",
"maxWind": 1,
"wind": "持续无风向微风"
},
{
"date": "周三",
"maxTemperature": 30,
"minTemperature": 25,
"temperature": "30 ~ 25℃",
"weather": "小雨",
"maxWind": 1,
"wind": "持续无风向微风"
},
{
"date": "周四",
"maxTemperature": 30,
"minTemperature": 25,
"temperature": "30 ~ 25℃",
"weather": "多云",
"maxWind": 1,
"wind": "持续无风向微风"
},
{
"date": "周五",
"maxTemperature": 32,
"minTemperature": 26,
"temperature": "32 ~ 26℃",
"weather": "多云",
"maxWind": 1,
"wind": "持续无风向微风"
},
{
"date": "周六",
"maxTemperature": 33,
"minTemperature": 27,
"temperature": "33 ~ 27℃",
"weather": "多云转阵雨",
"maxWind": 1,
"wind": "持续无风向微风"
}
],
"currentCity": "深圳市",
"weatherServices": [
{
"des": "天气热，建议着短裙、短裤、短薄外套、T恤等夏季服装。",
"level": "热",
"title": "穿衣指数"
},
{
"des": "不宜洗车，未来24小时内有雨，如果在此期间洗车，雨水和路上的泥水可能会再次弄脏您的爱车。",
"level": "不宜",
"title": "洗车指数"
},
{
"des": "有降水，推荐您在室内进行健身休闲运动；若坚持户外运动，须注意携带雨具并注意避雨防滑。",
"level": "较不宜",
"title": "运动指数"
},
{
"des": "相对今天出现了较大幅度降温，较易发生感冒，体质较弱的朋友请注意适当防护。",
"level": "较易发",
"title": "感冒指数"
}
]
}
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "深圳市今天雷阵雨，23到29摄氏度，持续无风向微风。PM2.5指数17。天气热，建议着短裙、短裤、短薄外套、T恤等夏季服装。"
}
}
]
}
返回示例(未携带城市名称信息)
- 今天天气怎么样
{
"globalId": "121940479998010315",
"intent": {
"code": 201401,
"intentName": "ask_weather",
"operateState": 1101,
"parameters": {}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "请告诉我你在哪个城市。"
}
}
]
}
- 深圳
{
"globalId": "111940481829510110",
"intent": {
"code": 201401,
"intentName": "location",
"operateState": 1010,
"parameters": {
"date": "2020-05-12",
"city": "深圳市",
"weather": {
"date": "2020-05-12",
"pm25": 17,
"nowTemp": "28℃",
"weatherDetails": [
{
"date": "周二",
"maxTemperature": 29,
"minTemperature": 23,
"temperature": "29 ~ 23℃",
"weather": "雷阵雨",
"maxWind": 1,
"wind": "持续无风向微风"
},
{
"date": "周三",
"maxTemperature": 30,
"minTemperature": 25,
"temperature": "30 ~ 25℃",
"weather": "小雨",
"maxWind": 1,
"wind": "持续无风向微风"
},
{
"date": "周四",
"maxTemperature": 30,
"minTemperature": 25,
"temperature": "30 ~ 25℃",
"weather": "多云",
"maxWind": 1,
"wind": "持续无风向微风"
},
{
"date": "周五",
"maxTemperature": 32,
"minTemperature": 26,
"temperature": "32 ~ 26℃",
"weather": "多云",
"maxWind": 1,
"wind": "持续无风向微风"
},
{
"date": "周六",
"maxTemperature": 33,
"minTemperature": 27,
"temperature": "33 ~ 27℃",
"weather": "多云转阵雨",
"maxWind": 1,
"wind": "持续无风向微风"
}
],
"currentCity": "深圳市",
"weatherServices": [
{
"des": "天气热，建议着短裙、短裤、短薄外套、T恤等夏季服装。",
"level": "热",
"title": "穿衣指数"
},
{
"des": "不宜洗车，未来24小时内有雨，如果在此期间洗车，雨水和路上的泥水可能会再次弄脏您的爱车。",
"level": "不宜",
"title": "洗车指数"
},
{
"des": "有降水，推荐您在室内进行健身休闲运动；若坚持户外运动，须注意携带雨具并注意避雨防滑。",
"level": "较不宜",
"title": "运动指数"
},
{
"des": "相对今天出现了较大幅度降温，较易发生感冒，体质较弱的朋友请注意适当防护。",
"level": "较易发",
"title": "感冒指数"
}
]
}
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "深圳市今天雷阵雨，23到29摄氏度，持续无风向微风。PM2.5指数17。天气热，建议着短裙、短裤、短薄外套、T恤等夏季服装。"
}
}
]
}
API利用扩展参数请求
userInfo 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| requestIp | String | N | 请求ip |
location 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| city | String | N | 城市名 |
| longitude | String | N | 经度 |
| latitude | String | N | 维度 |
带extra扩展参数请求示例
- 今天天气怎么样
{
"data": {
"content": [{
"data": "今天天气怎么样"
}],
"userInfo": {
"uniqueId": "ai11223344556677",
"requestIP":"58.250.250.202"
},
"location": {
"city": "深圳",
"longitude": "113.9567842900",
"latitude": "22.5381904200"
}
},
"key": "9d10cca4ee******ac235461ae45e8ca",
"timestamp": "1505390837793"
}
返回参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| date | String | 时间(yyyy-MM-dd) |
| city | String | 城市 |
| weather | Weather | 天气信息，详细参考Weather字段说明 |
Weather 字段说明
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| currentCity | String | 当前城市 |
| date | String | 当前日期 |
| nowTemp | String | 现在温度 |
| pm25 | int | PM2.5指数 |
| weatherDetails | Array<WeatherDetail> | 一周天气信息，详细参考WeatherDetail字段说明 |
| weatherServices | Array<WeatherService> | 查询日期的穿衣指数、洗车指数、感冒指数、运动指数，详细参考WeatherService字段说明 |
WeatherDetail 字段说明
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| date | String | 星期 |
| maxTemperature | int | 最高温度 |
| minTemperature | int | 最低温度 |
| maxWind | int | 最大风力 |
| temperature | String | 温度区间 |
| weather | String | 天气 |
| wind | String | 风向和风力 |
WeatherService 字段说明
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| des | String | 指数描述 |
| level | String | 指数等级 |
| title | String | 指数名称 |
operateState 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 1101：查询地址 1010/1010：天气信息输出 |
四则运算(201501)
技能描述
四则运算是图灵提供的算数能力，可以进行简单的加减乘除运算，并且可以通过多轮对话进行多轮运算。
说法示例
单轮：
1. 一加一等于几
2. 二乘以三等于多少
多轮：
1. 一加二等于几
2. 再乘以三呢
单轮结果示例
- 一加一等于几
{
"globalId": "111907716712010055",
"intent": {
"code": 201501,
"intentName": "calculator",
"operateState": 1010,
"parameters": {
"answer": "2.0",
"caculate": "1+1"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "一加一等于二"
}
}
]
}
多轮返回示例
- 一加二等于几
{
"globalId": "121907718341610191",
"intent": {
"code": 201501,
"intentName": "calculator",
"operateState": 1010,
"parameters": {
"answer": "3.0",
"caculate": "1+2"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "一加二等于三"
}
}
]
}
- 再乘以三呢
{
"globalId": "111907719592110454",
"intent": {
"code": 201501,
"intentName": "calculator",
"operateState": 1010,
"parameters": {
"answer": "9.0",
"caculate": "3.0*3"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "三点零乘以三等于九"
}
}
]
}
字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| caculate | String | Y | 计算算式 |
| answer | string | Y | 计算结果 |
打开应用(201601)
技能描述
打开应用是图灵提供的打开应用的指令，图灵会返回打开后面的应用名称和应用标识，需要先上传应用列表。
说法示例
1. 打开日历
返回示例
- 打开日历
{
"globalId": "121940820635010106",
"intent": {
"code": 201601,
"intentName": "open_app",
"operateState": 200201,
"parameters": {
"app_name": "日历",
"app_list": [
{
"package": "",
"name": "日历"
}
],
"is_open": true
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "正在打开日历，请稍后。"
}
}
]
}
返回参数说明
| 参数 | 类型 | 说明 |
|---|---|---|
| app_name | String | app名称 |
| is_open | bool | 是否直接打开 |
| app_list | Array<AppInfo> | 应用信息对象，信息参考AppInfo字段 |
AppInfo 字段说明
| 字段名称 | 字段类型 | 字段说明 |
|---|---|---|
| name | String | app名称 |
| package | String | app包名称 |
operateState 字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 200201：打开应用 |
中英互译(201711)
技能描述
中英互译是图灵提供的机器翻译能力，可以进行中译英和英译中。
说法示例
1. 苹果用英语怎么说
2. 把我喜欢你翻译成英语
3. apple是什么意思
4. 把orange翻译成中文
返回示例
- 苹果用英语怎么说
{
"globalId": "111940693412010034",
"intent": {
"code": 201711,
"intentName": "translate",
"operateState": 1010,
"parameters": {
"originalText": "苹果",
"translation": "apple",
"model": "Chinese2English"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "苹果翻译成英文是：apple"
}
}
]
}
字段说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| originalText | String | Y | 要翻译的内容 |
| translation | String | Y | 翻译结果 |
| model | String | Y | 模式 [Chinese2English, English2Chinese] |
谁在叫(404003)
技能描述
谁在叫是图灵提供的趣味游戏，进入此游戏后，机器人会给孩子播放各类声音，然后孩子来听声音猜东西。此技能为多轮技能，不玩的时候记得退出哦。
使用说明
| 指令功能 | 指令词 |
|---|---|
| 进入语 | 谁在叫、我想玩谁在叫、进入谁在叫 |
| 正常回答 | 羊叫声、羊的叫声、羊 |
| 公布谜底 | 不知道、猜不出来、答案 |
| 再听一遍 | 再来一次、再说一遍 |
| 切换题目 | 换一个 |
| 退出游戏 | 不玩了、退出游戏、退出 |
多轮返回示例
- 我想玩谁在叫
{
"globalId": "121907241635810153",
"intent": {
"code": 404003,
"operateState": 12001
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "小朋友，欢迎你进入‘谁在叫’闯关游戏。一会我会发出一个声音，你来猜猜它是什么声音吧，如果不想玩了，可以跟我说退出或不想玩了。准备好哦，开始闯关喽！第1关："
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://download.turingapi.com/voice/059.mp3",
"identifier": "059"
}
},
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "猜出来这是什么声音了吗？想再听一遍就对我说：再来一次。不想玩了请对我说：退出。"
}
}
]
}
- 羊叫声
{
"globalId": "121907245594210409",
"intent": {
"code": 404003,
"operateState": 12005
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "太棒了，答案就是小绵羊叫,马上进入下一关。第2关："
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://download.turingapi.com/voice/056.mp3",
"identifier": "056",
"reply": "right"
}
}
]
}
- 不知道
{
"globalId": "111907247012910056",
"intent": {
"code": 404003,
"operateState": 12003
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "听好哦，我要公布答案了，答案是猫叫的声音。我们现在进入下一关吧。第3关："
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://download.turingapi.com/voice/080.mp3",
"identifier": "080"
}
}
]
}
- 再来一次
{
"globalId": "121907248353010226",
"intent": {
"code": 404003,
"operateState": 12002
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "再听一次哦，仔细听好哦"
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://download.turingapi.com/voice/080.mp3",
"identifier": "080"
}
}
]
}
- 换一个
{
"globalId": "121907249488310387",
"intent": {
"code": 404003,
"operateState": 12004
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "第4关："
}
},
{
"groupType": 0,
"resultType": "voice",
"values": {
"voice": "http://download.turingapi.com/voice/118.mp3",
"identifier": "118"
}
}
]
}
- 不玩了
{
"globalId": "111907250773210327",
"intent": {
"code": 404003,
"operateState": 1000
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "好的，退出游戏，我们玩点别的吧。"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | Int | Y | 12001：开始 12003：直接换下一个 12004：公布答案进入下一个 12005：回答内容 1000：退出 |
休眠(900101)
技能描述
休眠指令是图灵提供给用户的控制指令，图灵解析用户的语言并返回休眠指令给前端做处理。
说法示例
1. 睡觉吧
2. 再见
3. 拜拜
返回示例
- 再见
{
"globalId": "121906336045110188",
"intent": {
"code": 900101,
"intentName": "sleep",
"operateState": 1000,
"parameters": {
"action": "sleep"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "再见，我会想你的。"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | String | N | 1000：意图结束 |
屏幕亮度(900110)
技能描述
屏幕亮度技能主要是对屏幕亮度进行控制。
说法示例
1. 屏幕亮点、屏幕暗点
2. 增大屏幕亮度、减小屏幕亮度
3. 调高屏幕亮度、调低屏幕亮度
4. 屏幕调到最亮、屏幕调到最暗
5. 屏幕调亮、屏幕调暗
6. 屏幕太亮了、屏幕太暗了
返回示例
- 屏幕调到最亮
{
"globalId": "122623244179210266",
"intent": {
"code": 900110,
"intentName": "brightness",
"operateState": 11021,
"parameters": {
"setting_level": 1,
"type": "max"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "好的"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | int | Y | 11021：增大屏幕亮度/最亮/太暗了 11022：减小屏幕亮度/最暗/太亮了 |
| type | String | N | 屏幕调节类型： up：增大亮度/需要增加亮度（太暗了） down：减小亮度/需要减小亮度（太亮了） max：调到最亮 min：调到最暗 |
| setting_level | String | N | 操作命令字段，此处表示亮度值： 固定为1 |
电量查询(900110)
技能描述
用户可根据返回的code值进行电量的相关处理。
说法示例
1. 查询电量、电量查询
返回示例
- 查询电量
{
"globalId": "121941230960810294",
"intent": {
"code": 900110,
"intentName": "battery",
"operateState": 11030
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "好的。"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | int | Y | 11030:电量查询; |
音量控制(900110)
技能描述
音量控制技能主要是对音量进行控制。
说法示例
1. 增大音量、减小音量
2. 大点声音、小点声音
3. 将声音调节到最大、将声音调节到最小
4. 静音
返回示例
- 增大音量
{
"globalId": "111941246060010204",
"intent": {
"code": 900110,
"intentName": "volume_control",
"operateState": 11010,
"parameters": {
"setting_level": 1,
"type": "up"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "我稍微大声点。"
}
}
]
}
- 将声音调节到最大
{
"globalId": "121941249761810205",
"intent": {
"code": 900110,
"intentName": "volume_control",
"operateState": 11010,
"parameters": {
"setting_level": 1,
"type": "max"
}
},
"results": [
{
"groupType": 0,
"resultType": "text",
"values": {
"text": "调整到最大音量"
}
}
]
}
返回参数说明
| 参数 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| operateState | int | Y | 11010:增大音量; 11011:减小音量; 11012:静音; |
| type | String | N | 调节音量： up：上调; down：下调; max：最大; min：最小; mute：静音; |
| setting_level | String | N | 设置级别，默认为增大一格。 |
开机提示语(1000010)
技能描述
开机提示语是图灵提供的个性化开机能力，开发者可以在硬件上设置开机时先请求开机提示语接口，这时会返回给前端一段回复，回复语和回复时间可以在【“AI开放平台” - “机器人功能” - “开机提示”】处进行编辑。注意此时的type值为4，data值为osgreet。
请求示例
{
"data": {
"content": [{
"data": "osgreet",
"type": 4
}],
"userInfo": {
"uniqueId": "ai11223344556677"
}
},
"key": "ed474********faea1788",
"timestamp": "150******7793"
}
返回示例
{
"globalId": "121906473977010272",
"intent": {
"code": 1000010,
"operateState": 2001
},
"results": [
{
"groupType": 1,
"resultType": "text",
"values": {
"text": "这是测试的开机提示语"
}
}
]
}
主动交互(1000011)
技能描述
主动交互是图灵提供的个性化能力，当机器人在联网下的静默状态（如用户长时间没有和机器人进行交互）时，由机器人主动发起交互，可以在【“AI开放平台” - “机器人功能” - “主动交互语”】处设置相关交互语句，当达到条件后请求图灵主动交互接口时可返回设置的相应内容。注意此时的type值为4，data值为osactive。
请求示例
{
"data": {
"content": [{
"data": "osactive",
"type": 4
}],
"userInfo": {
"uniqueId": "ai11223344556677"
}
},
"key": "ed474********faea1788",
"timestamp": "150******7793"
}
请求参数说明
| 参数 | 说明 |
|---|---|
| data | 输入类型，具体说明如下 |
| type | type=4为主动交互 |
content - data 字段说明
| 参数 | 说明 |
|---|---|
| osgreet | 开机提示语 |
| osactive | 主动交互 |
| authorize | 口语评测授权 |
返回示例
{
"globalId": "111906440202810014",
"intent": {
"code": 1000011,
"operateState": 2001
},
"results": [
{
"groupType": 1,
"resultType": "text",
"values": {
"text": "小朋友你好，我们好久没聊天了哦，我想你了呢。"
}
}
]
}
主题对话
技能描述
主题对话是图灵提供给开发者的一套自定义多轮对话的工具，开发者可以基于主题对话的说明文档进行主题对话的编辑。
其他技能
图灵提供一些其他的技能，并没有在所有用户的标准技能界面展现，若您需要请与图灵的商务或项目同事进行沟通，然后由他们给您开通并提供详细的接入文档。
附录
功能码
| code | 说明 |
|---|---|
| 10000 | 系统状态(意图不明确,获取数据超时) |
| 10001 | 主题对话 |
| 10002 | 聊天(非儿童) |
| 10005 | 成语接龙 |
| 100000 | 儿童聊天 |
| 100102 | 英文对话 |
| 100302 | 知识库 |
| 200101 | 歌曲点播 |
| 200201 | 故事点播 |
| 200205 | 十万个为什么 |
| 200207 | 绕口令 |
| 200209 | 维基百科 |
| 200211 | 脑筋急转弯 |
| 200212 | 顺口溜 |
| 200301 | 动物叫声 |
| 200302 | 大自然的声音 |
| 200303 | 乐器的声音 |
| 200401 | 诗词背诵 |
| 200501 | 拍照 |
| 200701 | 跳舞 |
| 200702 | 日期查询/时间查询 |
| 200710 | 闹钟 |
| 200802 | 打电话 |
| 201204 | 笑话 |
| 201401 | 天气查询 |
| 201501 | 四则运算 |
| 201601 | 打开应用 |
| 201711 | 中英互译 |
| 404003 | 谁在叫 |
| 900101 | 主动退出 |
| 900101 | 休眠 |
| 900110 | 系统设置:屏幕亮度/电量查询/音量控制 |
| 1000010 | 开机提示语 |
| 1000011 | 主动交互 |
错误码
| code | 说明 |
|---|---|
| 40001 | 未找到用户信息 |
| 40002 | 请求内容缺失或过长 |
| 40004 | 权限验证失败,uniqueId超限制，请求次数超限 |
| 40005 | 没有勾选应用 |
| 40007 | 请求格式错误 |
| 40008 | uniqueId不合法 |
情绪ID
| emotionId | Sentiment |
|---|---|
| 10100 | 惊讶/surprise |
| 10200 | 狂喜/ecstacy |
| 10300 | 高兴/joy |
| 10400 | 信任/trust |
| 10500 | 接纳/acceptance |
| 10600 | 厌倦/boredom |
| 10800 | 感兴趣/interest |
| 10900 | 渴望/desire |
| 11000 | 期望/anticipation |
| 11200 | 警觉/vigilance |
| 20100 | 生气/anger |
| 20200 | 愤怒/rage |
| 20300 | 烦恼/annoyance |
| 20400 | 厌恶/disgust |
| 20500 | 不满/dissatisfied |
| 20600 | 昏睡/sleepy |
| 20800 | 惊恐/terror |
| 20900 | 恐惧/fear |
| 21000 | 悲伤/sadness |
| 21100 | 失望/disappointed |
| 21200 | 忧惧/apprehension |
| 21300 | 分心/distrastion |
| 21500 | 疑问/doubt |