请求数据 - 对话系统接口API

**简要描述：**

- 该文档的用于记录对话系统接收的参数信息

## 必选参数

>请求必须包含如下两个参数，输入问题为本次交互用户所说的句子，而用户id用于维护上下文，使得系统能够进行多轮对话。
如对于实体机器人，用户id可以是机器人sn；对于微信、app等个人终端，用户id可以是每个用户的唯一标识。
接口响应版本请填写3.0，为最新接口版本

|字段名|类型|字段说明|备注|
|:----    |:---|:----- |:----- |
|sentence|string|输入问题||
|uid|string|用户id||
|data_version|float|接口响应版本|请填写3.0|

## 可选参数

>如下为每次接口请求可与上述必选参数一同发送的信息，更多的信息能够提升对话系统的能力。

|字段名称|类型|字段说明|备注|
|:---- |:---|:----- |:----- |
|type|string|输入问题的类型|可选项:text\|event 默认为‘text’ 通常如实体机器人会有事件，系统已定义事件可参考平台使用说明|
|command|string|指令|可选项: 'reset' ’clear_context‘ 'reset_dialog' 'start_collaboration' 'stop_collaboration' 'req_collaboration' 'stop_notify_collaboration' 'resume_notify_collaboration' 'deactivate_auto_engage' 'activate_auto_engage'，默认为空|
|from|string|数据来源|可选项: bot handler wechat test 默认为bot|
|state |dict|用户状态|默认为{} 详见下面用户状态说明|
|info|dict|信息|默认为{} 详见下面信息说明|

### 用户状态

>播放状态会将闲聊型回答播放设定为false
人机协作状态下将不再发起人机协作请求
对话状态详见相关功能-对话状态设置

|一级字段|二级字段|类型|字段说明|备注|
|:---- |:----- |:---|:----- |:----- |
|state ||dict|用户状态|默认为{}
||talking|bool|是否处于播放状态|默认为False
||cooperation|bool|是否处于人机协作状态|默认为False
||dialog_state|string|对话状态|默认为空

### 信息

>信息支持用户信息及机器人信息的输入，输入的信息将对应到用户画像及机器画像中，并在对话过程中使用，可参考平台使用说明

|一级字段|二级字段|三级字段|类型|字段说明|备注|
|:---- |:---|:----- |:---|:----- |:----- |
|info|| |dict|信息|默认为{}
||human| |list|用户信息|默认为[]
|||identity_id|string|用户唯一性标识|默认为'unk'
|||talking|bool|是否为说话人|默认为False
|||sex|string|性别|可选项:‘男’\|'女'\|‘不明’ 默认为'不明'
|||age|string|年龄|默认为-1
|||name|string|姓名|默认为'’
|||firstname|string|名|默认为'‘
|||lastname|string|姓|默认为'’
|||profession|string|职业|默认为''
|||job_title|string|头衔|默认为''
|||respectname|string|尊称|默认为''
|||face_feature|list|人脸特征|可选项:'眼镜'\|'墨镜'\|'胡子' 默认为[]
|||emotion|list|情感|默认为[]
||robot||dict|机器人信息|默认为{}
|||location|dict|位置信息|默认为{} 含naviPosName(位置名)等字段