支持多意图改写落域，当落域为家电控制时进行指令提取，多个家电控制意图则以数组的形式返回结果。
接口地址
POST https://api.listenai.com/v1/makes
请求参数说明
| 名称 | 类型 | 说明 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| model | string | 模型 | 是 | - | 可选值: spark-interface-1.0 |
| task | string | 任务 | 是 | - | 可选值: interpret |
| messages | Array<message> | 用户提问 | 是 | - | |
| message.role | string | 角色 | 是 | - | 可取值：user ；user表示用户的提问; |
| message.content | string | 文本内容 | 是 | - | 用户提问内容 |
| inputs | object | 可选参数 | 是 | - | |
| inputs.device_list | string | 设备列表 | 是 | - | 设备列表，格式为设备ID:设备描述;.. |
响应参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| _ | Array<domain> | - |
| _.text | string | 用户输入文本 |
| _.skill | string | 落域技能 |
| _.intent | string | 用户意图 |
| _.data | object | NLP结果，当skill为家电控制时有值 |
| data.control_type | string | 控制类型，unicast表示单控，groupcast表示组控 |
| data.action | string | 控制指令，格式为 "指令类型:属性:属性值" |
| data.device | Array | 设备id列表 |
| data.desc | string | 设备描述 |
| data.datetime | string | 13位时间戳，表示命令发送的时间 |
data.action参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| action | string | 包含指令类型、属性和属性值的字符串，格式为 "指令类型:属性:属性值:属性单位"，如 set:brightness:MID,set:temperature:16:摄氏度 |
data.action中指令类型可能的取值
| 指令类型 | 说明 |
|---|---|
| set | 设置属性 |
| adjustUp | 调高属性 |
| adjustDown | 调低属性 |
| turnOn | 打开设备 |
| turnOff | 关闭设备 |
| query | 查询属性 |
| cancel | 取消属性 |
data.action中属性可能的取值
| 属性 | 说明 |
|---|---|
| brightness | 亮度 |
| colorTemperature | 色温 |
| color | 颜色 |
| mode | 模式 |
| on/off | 开关状态 |
data.action中属性值可能的取值
| 属性值 | 说明 |
|---|---|
| MID | 亮度适中 |
| MIN | 亮度最低 |
| MAX | 亮度最高 |
| 数字（1-10） | 亮度档位 |
| 数字（1-100） | 亮度数值 |
| 灯光的常见颜色 | 颜色设置，格式为红色#255,0,0 |
| 智能灯的常见模式 | 模式设置 |
data.action中属性单位可能的取值
| 属性值 | 说明 |
|---|---|
| 摄氏度 | 温度单位 |
| K | 色温单位 |
| 百分比 | 调节档次 |
| 级 | 调节档次 |
| 格 | 调节档次 |
| 档 | 调节档次 |
请求示例
curl --request POST \
--url https://api.listenai.com/v1/makes \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REQUEST_TOKEN' \
--data '{
"model": "spark-interface-1.0",
"task": "interpret",
"messages": [
{ "role": "user", "content": "打开楼下灯以及十分钟后打开二楼灯" }
],
"inputs": {
"device_list": "1:花园次卧写字台灯;2:车库厨房写字台格栅灯;3:3层次卧茶几格栅灯;4:1层厕所灶台灯带;162层保姆房茶几灯;6:楼上主卫写字台灯;7:二层主卧工作区线条灯;8:2层主卫灶台灯带;93楼门口鱼缸格栅灯;101层卫生间写字台灯;11:二层电视灯带;12:阁楼玄关钢琴格栅灯;13:二层厨房写字台轨道灯;14:二楼主卫电脑桌筒灯;15:二层卫生间灯;16:一楼次卧灶台格栅灯;17:二层卧室电脑桌灯;18:三楼阳台钢琴轨道灯;20:沟通头灯;21:厕所电视灯;22:2楼主卫餐桌灯;23:三层主卫工作区射灯;24:一层卫生间茶几线条灯;25:草坪办公室灯;26:二楼茶室狗头灯;27:3层主卫写字台灯;28:一楼主卫灶台灯;29:三层办公室梳妆台灯;30:一楼厨房写作区灯;31:3层主卫梳妆台线条灯;33:车库儿童房灶台灯;34:2楼主卫灯;35:3层客厅电脑桌灯;36:客厅窗帘;"
}
}'
响应示例
[
{
"text": "打开楼下灯",
"skill": "家电操控",
"intent": "灯",
"data": {
"action": "turnOn",
"devices": [],
"desc": "楼下灯",
"control_type": "groupcast",
"datetime": ""
}
},
{
"text": "十分钟后打开二楼灯",
"skill": "家电操控",
"intent": "灯",
"data": {
"action": "turnOn",
"devices": [],
"desc": "二楼灯",
"control_type": "groupcast",
"datetime": "1745824744000"
}
}
]
请求示例
curl --location 'https://api.listenai.com/v1/makes' \
--header 'Authorization: Bearer YOUR_REQUEST_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"model": "spark-interface-1.0",
"task": "interpret",
"messages": [
{
"role": "user",
"content": "亮度调到75的保姆房的轨道灯再帮我查查明天的天气"
}
],
"inputs": {
"device_list": "1:花园次卧写字台灯;2:车库厨房写字台格栅灯;3:3层次卧茶几格栅灯;4:1层厕所灶台灯带;162层保姆房茶几灯;6:楼上主卫写字台灯;7:二层主卧工作区线条灯;8:2层主卫灶台灯带;93楼门口鱼缸格栅灯;101层卫生间写字台灯;11:二层电视灯带;12:阁楼玄关钢琴格栅灯;13:二层厨房写字台轨道灯;14:二楼主卫电脑桌筒灯;15:二层卫生间灯;16:一楼次卧灶台格栅灯;17:二层卧室电脑桌灯;18:三楼阳台钢琴轨道灯;20:沟通头灯;21:厕所电视灯;22:2楼主卫餐桌灯;23:三层主卫工作区射灯;24:一层卫生间茶几线条灯;25:草坪办公室灯;26:二楼茶室狗头灯;27:3层主卫写字台灯;28:一楼主卫灶台灯;29:三层办公室梳妆台灯;30:一楼厨房写作区灯;31:3层主卫梳妆台线条灯;33:车库儿童房灶台灯;34:2楼主卫灯;35:3层客厅电脑桌灯;36:客厅窗帘;"
}
}'
响应示例
[
{
"text": "亮度调到75的保姆房的轨道灯",
"skill": "家电操控",
"intent": "灯",
"data": {
"action": "set:brightness:75",
"devices": ["1", "2", "3", "5", "7", "8", "9", "10", "11", "12", "14", "15", "16", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "29", "31", "32", "33", "34", "35", "36", "37", "38", "39", "40", "41", "42", "43", "44", "45", "47", "48", "49", "50", "52"],
"desc": "保姆房轨道灯",
"control_type": "unicast",
"datetime": ""
}
},
{
"text": "查询明天的天气",
"skill": "通用技能",
"intent": "天气"
}
]
请求示例
curl --location 'https://api.listenai.com/v1/makes' \
--header 'Authorization: Bearer YOUR_REQUEST_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"model": "spark-interface-1.0",
"task": "interpret",
"messages": [
{
"role": "user",
"content": "把客厅灯调到红色"
}
],
"inputs": {
"device_list": "1:花园次卧写字台灯;2:车库厨房写字台格栅灯;3:3层次卧茶几格栅灯;4:1层厕所灶台灯带;162层保姆房茶几灯;6:楼上主卫写字台灯;7:二层主卧工作区线条灯;8:2层主卫灶台灯带;93楼门口鱼缸格栅灯;101层卫生间写字台灯;11:二层电视灯带;12:阁楼玄关钢琴格栅灯;13:二层厨房写字台轨道灯;14:二楼主卫电脑桌筒灯;15:二层卫生间灯;16:一楼次卧灶台格栅灯;17:二层卧室电脑桌灯;18:三楼阳台钢琴轨道灯;20:沟通头灯;21:厕所电视灯;22:2楼主卫餐桌灯;23:三层主卫工作区射灯;24:一层卫生间茶几线条灯;25:草坪办公室灯;26:二楼茶室狗头灯;27:3层主卫写字台灯;28:一楼主卫灶台灯;29:三层办公室梳妆台灯;30:一楼厨房写作区灯;31:3层主卫梳妆台线条灯;33:车库儿童房灶台灯;34:2楼主卫灯;35:3层客厅电脑桌灯;36:客厅窗帘;"
}
}'
响应示例
[
{
"text": "把客厅灯调到红色",
"skill": "家电操控",
"intent": "灯",
"data": {
"action": "set:color:红色#255,0,0",
"devices": [],
"desc": "客厅灯",
"control_type": "groupcast",
"datetime": ""
}
}
]
请求示例
curl --location 'https://api.listenai.com/v1/makes' \
--header 'Authorization: Bearer YOUR_REQUEST_TOKEN' \
--header 'Content-Type: application/json' \
--data '{
"model": "spark-interface-1.0",
"task": "interpret",
"messages": [
{
"role": "user",
"content": "创建一个春天的模式"
}
],
"inputs": {
"device_list": "1:花园次卧写字台灯;2:车库厨房写字台格栅灯;3:3层次卧茶几格栅灯;4:1层厕所灶台灯带;162层保姆房茶几灯;6:楼上主卫写字台灯;7:二层主卧工作区线条灯;8:2层主卫灶台灯带;93楼门口鱼缸格栅灯;101层卫生间写字台灯;11:二层电视灯带;12:阁楼玄关钢琴格栅灯;13:二层厨房写字台轨道灯;14:二楼主卫电脑桌筒灯;15:二层卫生间灯;16:一楼次卧灶台格栅灯;17:二层卧室电脑桌灯;18:三楼阳台钢琴轨道灯;20:沟通头灯;21:厕所电视灯;22:2楼主卫餐桌灯;23:三层主卫工作区射灯;24:一层卫生间茶几线条灯;25:草坪办公室灯;26:二楼茶室狗头灯;27:3层主卫写字台灯;28:一楼主卫灶台灯;29:三层办公室梳妆台灯;30:一楼厨房写作区灯;31:3层主卫梳妆台线条灯;33:车库儿童房灶台灯;34:2楼主卫灯;35:3层客厅电脑桌灯;36:客厅窗帘;"
}
}'
响应示例
[
{
"text": "创建一个春天的模式",
"skill": "场景模式",
"intent": "场景名"
}
]