# 华为语言理解
华为语言理解连接器基于华为云自然语言处理 NLP进行集成开发，包含"情感分析"、"文本分类"、"文档分类"、"意图理解"等执行动作。
#### 连接参数
华为语言理解连接器使用IAM认证，连接参数说明如[表1]所示。
 表1连接参数说明 
| 名称   | 必填 | 说明                                                                                                      | 示例值/默认值     |
|:---|:---|:---|:---|
| 连接名称 | 是  | 设置连接名称。                                                                                                 | 华为语言理解的连接   |
| 描述   | 否  | 对于连接的信息描述说明。                                                                                            | description |
| 租户名  | 是  | IAM用户所属账号信息。了解[账号与IAM用户的关系](https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html#section2)。 | domain      |
| 用户名  | 是  | IAM用户名。                                                                                                 | name        |
| 密码   | 是  | IAM用户的登录密码。                                                                                             | -           |
| 区域   | 是  | 服务所属区域。                                                                                                 | cn-north-4  |
   
#### 情感分析（基础版）
针对通用领域的用户评论进行情感分析。
- 输入参数 用户配置情感分析（基础版）执行动作，相关参数说明如[表2]所示。
   表2情感分析（基础版）输入参数说明 
  | 参数     | 必填 | 说明                                            |
  |:---|:---|:---|
  | 待分析的文本 | 是  | 待分析文本，仅支持中文和英文。限定400个字符以内，超过400字符，只检测前400个字符。 |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表3]。
   表3情感分析（基础版）输出参数说明 
  | 参数    | 说明           |
  |:---|:---|
  | 情感标签  | 1表示积极，0表示消极。 |
  | 置信度   | 识别结果的可靠程度。   |
  | 待分析文本 | 输入的待分析的文本。   |
     
  
#### 情感分析（领域版）
领域情感分析，针对电商，汽车领域，自适应领域（通用、电商、汽车）的用户评论进行情感分析。
- 输入参数 用户配置情感分析（领域版）执行动作，相关参数说明如[表4]所示。
   表4情感分析（领域版）输入参数说明 
  | 参数     | 必填 | 说明                                |
  |:---|:---|:---|
  | 待分析的文本 | 是  | 自适应/电商领域，支持输入200个字，汽车领域支持输入400个字。 |
  | 所属领域   | 否  | 有自适应，电商，汽车三种领域，可使用输入框或者下拉框输入方式。   |
     
  
 
- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表5]。
   表5情感分析（领域版）输出参数说明 
  | 参数    | 说明           |
  |:---|:---|
  | 情感标签  | 1表示积极，0表示消极。 |
  | 置信度   | 识别结果的可靠程度。   |
  | 待分析文本 | 输入的待分析的文本。   |
     
  
#### 属性级情感分析
本产品适用于评论文本的属性级正负面分析。
- 输入参数 用户配置属性级情感分析执行动作，相关参数说明如[表6]所示。
   表6属性级情感分析输入参数说明 
  | 参数     | 必填 | 说明                            |
  |:---|:---|:---|
  | 待分析的文本 | 是  | 待分析文本，仅支持中文。文本长度在1000个字符以内。   |
  | 领域类型   | 是  | 支持的领域类型，目前只支持手机领域，有下拉框和输入框模式。 |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表7]。
   表7属性级情感分析输出参数说明 
  | 参数             | 说明                                     |
  |:---|:---|
  | 待分析文本          | 输入待分析的文本。                              |
  | 文本情感标签分析结果     | 1表示积极，0表示消极。                           |
  | 置信度            | 识别结果的可靠程度。                             |
  | 挖掘列表           | 属性级情感挖掘列表。                             |
  | 属性类别           | 属性的类别。                                 |
  | 属性词            | 属性词，与对应的描述词至少出现其中之一，可能为null。           |
  | 描述词            | 描述词，与对应的属性词至少出现其中之一，可能为null。           |
  | 情感标签           | 情感标签，0：负向，1：正向。                        |
  | 置信度            | 属性分析结果可靠程度。                            |
  | 属性-描述词片段所对应的标签 | 属性-描述词片段所对应的标签如果分类为"其他"，则不给出标签，返回null。 |
     
  
 
#### 属性级情感分析（高级版）
本产品适用于评论文本的属性级正负面分析，文本长度不超过4096字符。
- 输入参数 用户配置属性级情感分析（高级版）执行动作，相关参数说明如[表8]所示。
   表8属性级情感分析（高级版）输入参数说明 
  | 参数     | 必填 | 说明                                |
  |:---|:---|:---|
  | 待分析的文本 | 是  | 待分析文本，仅支持中文，建议文本长度300个字符以内。       |
  | 领域类型   | 是  | 支持的领域类型，目前支持手机领域和汽车领域，有下拉框和输入框模式。 |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表9]。
   表9属性级情感分析（高级版）输出参数说明 
  | 参数      | 说明              |
  |:---|:---|
  | 待分析文本   | 输入待分析的文本。       |
  | 情感标签    | 1表示积极，0表示消极。    |
  | 置信度     | 识别结果的可靠程度。      |
  | 挖掘列表    | 属性级情感挖掘列表。      |
  | 属性类别    | 属性的类别。          |
  | 情感标签    | 情感标签，0：负向，1：正向。 |
  | 情感标签置信度 | 属性分析结果可靠程度。     |
  | 属性描述词   | 属性的描述词。         |
  | 观点描述词   | 观点的描述词。         |
  | 观点标签    | 观点的标签。          |
     
  
 
#### 实体级情感分析
实体级情感分析，本接口用于检测指定实体（entity）在文本（content）中的正负面分析，适用于金融方面公司实体正负面新闻的分析。
- 输入参数 用户配置实体级情感分析执行动作，相关参数说明如[表10]所示。
   表10实体级情感分析输入参数说明 
  | 参数     | 必填 | 说明                                         |
  |:---|:---|:---|
  | 待分析的文本 | 是  | 待分析文本，仅支持中文，限定512个字符以内，超过512字符，只检测前512个字符。 |
  | 待分析的实体 | 是  | 待分析实体名称。                                   |
  | 领域类型   | 是  | 支持的领域类型，目前支持金融领域，有下拉框和输入框模式。               |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表11]。
   表11实体级情感分析输出参数说明 
  | 参数    | 说明                   |
  |:---|:---|
  | 待分析文本 | 输入待分析的文本。            |
  | 实体名称  | 输入的实体名称。             |
  | 情感标签  | 0表示负面，1表示非负面，2表示不相关。 |
  | 置信度   | 分析实体结果可靠程度。          |
     
  
 
#### 文本分类
针对广告领域的自动分类，判断是否是广告。
- 输入参数 用户配置文本分类执行动作，相关参数说明如[表12]所示。
   表12文本分类输入参数说明 
  | 参数     | 必填 | 说明                                            |
  |:---|:---|:---|
  | 待分析的文本 | 是  | 待分析文本，仅支持中文和英文，限定400个字符以内，超过400字符，只检测前400个字符。 |
  | 检测类型   | 否  | 支持的检测类型，目前支持广告检测，有下拉框和输入框模式。                  |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表13]。
   表13文本分类输出参数说明 
  | 参数    | 说明          |
  |:---|:---|
  | 待分析文本 | 输入待分析的文本。   |
  | 分析结果  | 1为广告，0为非广告。 |
  | 置信度   | 分类结果的可靠程度。  |
     
  
 
#### 文档分类
文档分类接口对用户输入的文本自动分类，给文本具体的分类。用户只要提供待处理的文本，而不用关注具体实现。主要应用场景：新闻内容分类，广告识别等。
- 输入参数 用户配置文档分类执行动作，相关参数说明如[表14]所示。
   表14文档分类输入参数说明 
  | 参数      | 必填 | 说明                                            |
  |:---|:---|:---|
  | 待分析文档内容 | 是  | 待分析文档内容，长度限定10000个字符以内，超过10000个字符截取前10000个字符。 |
  | 文本语言类型  | 否  | 支持的文本语言类型，目前只支持zh（中文），默认zh，有下拉框和输入框模式。        |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表15]。
   表15文档分类输出参数说明 
  | 参数   | 说明         |
  |:---|:---|
  | 文档标签 | 输入的文档标签。   |
  | 置信度  | 分类结果的可靠程度。 |
     
  
 
#### 意图理解
针对天气类、报时、新闻类、笑话类、翻译类、提醒类、闹钟类、音乐类8个领域进行意图理解。意图理解包括对用户的问题，陈述进行领域识别以及对所对应领域所包含的实体进行抽取。
- 输入参数 用户配置意图理解执行动作，相关参数说明如[表16]所示。
   表16意图理解输入参数说明 
  | 参数     | 必填 | 说明                                      |
  |:---|:---|:---|
  | 待分析的文本 | 是  | 待分析文本，长度在32个字符以内，文本长度超过32字符时，只检测前32个字符。 |
  | 文本语言类型 | 否  | 支持的文本语言类型，目前只支持zh（中文），默认zh，有下拉框和输入框模式。  |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表17]。
   表17意图理解输出参数说明 
  | 参数            | 说明                        |
  |:---|:---|
  | 置信度           | 分析结果的可信程度。                |
  | 意图标签          | 文本的意图标签。                  |
  | 拆解结果          | 意图的拆解结果。                  |
  | 待分析文本         | 输入的意图文本。                  |
  | 实体类型          | 实体的类型。                    |
  | 实体文本长度        | 实体的文本长度。                  |
  | 同义词或者其他标准表达的词 | 同义词或者其他标准表达的词，默认为原始的word。 |
  | 返回待分析文本       | 返回待分析的文本。                 |
  | 错误码           | 调用失败时的错误码，调用成功时无此字段。      |
  | 错误信息          | 调用失败时的错误信息，调用成功时无此字段。     |