# 华为语言生成
华为语言生成连接器基于华为云自然语言处理 NLP进行集成开发，包含"文本摘要（基础版）"、"文本摘要（领域版）"、"诗歌生成"三个执行动作。
#### 连接参数
华为语言生成连接器使用IAM认证，连接参数说明如[表1]所示。
 表1连接参数说明 
| 名称   | 必填 | 说明                                                                                                      | 示例值/默认值                                      |
|:---|:---|:---|:---|
| 连接名称 | 是  | 设置连接名称。                                                                                                 | 华为语言生成的连接                                    |
| 描述   | 否  | 对于连接的信息描述说明。                                                                                            | description                                  |
| 租户名  | 是  | IAM用户所属账号信息。了解[账号与IAM用户的关系](https://support.huaweicloud.com/productdesc-iam/iam_01_0023.html#section2)。 | domain                                       |
| 用户名  | 是  | IAM用户名。                                                                                                 | name                                         |
| 密码   | 是  | IAM用户的登录密码。                                                                                             | -                                            |
| 项目ID | 是  | 系统为用户自动生成的项目ID，单击"我的凭证 \> API凭证"，根据项目获取。                                                                | e9993fc787\*\*\*\*\*\*\*\*\*\*\*\*a340f9c0f4 |
| 站点   | 是  | 站点。                                                                                                     | iam.cn-north-4.myhuaweicloud.com             |
   
#### 文本摘要（基础版）
在不改变文档原意的情况下总结出文档的主要内容。可应用于新闻摘要生成、文献摘要生成、搜索结果片段生成、商品评论摘要生成等场景。
接口功能及调用方法请参考[文本摘要（基础版）](https://support.huaweicloud.com/api-nlp/nlp_03_0013.html)。
- 输入参数 用户配置文本摘要（基础版）执行动作，相关参数说明如[表2]所示。
   表2文本摘要（基础版）输入参数说明 
  | 参数        | 必填 | 说明                                                                                             |
  |:---|:---|:---|
  | 文本标题      | 否  | 文本标题，长度不超过1000字。                                                                               |
  | 文本正文      | 是  | 文本正文，长度不超过1000字。                                                                               |
  | 文本语言类型    | 否  | 支持的文本语言类型，目前支持中文（zh）和英文(en)，默认为中文。有下拉框和输入框模式。                                                  |
  | 生成摘要的长度限制 | 否  | 生成摘要的长度限制。数值长度 \> 1，则返回结果为字数不小于该值且最接近该值的摘要。0 \<= 数值长度\<= 1，则返回结果为长度百分比不小于该值且最接近该值的摘要。默认数值为0.3。 |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表3]。
   表3文本摘要（基础版）输出参数说明 
  | 参数   | 说明                        |
  |:---|:---|
  | 摘要结果 | 根据文本请求体，返回摘要结果。调用失败时无此字段。 |
     
  
 
#### 文本摘要（领域版）
在不改变文档原意的情况下总结出文档的主要内容。可应用于新闻摘要生成、文献摘要生成、搜索结果片段生成、商品评论摘要生成等场景。
文本摘要（基础版）和文本摘要（领域版）基于不同算法实现，对相同文本，基础版和领域版的结果有所差别。根据测试数据，领域版效果一般优于基础版。
接口功能及调用方法请参考[文本摘要（领域版）](https://support.huaweicloud.com/api-nlp/nlp_03_0071.html)。
- 输入参数 用户配置文本摘要（领域版）执行动作，相关参数说明如[表4]所示。
   表4文本摘要（领域版）输入参数说明 
  | 参数        | 必填 | 说明                                                                                      |
  |:---|:---|:---|
  | 文本标题      | 否  | 文本标题，长度不超过1000字。                                                                        |
  | 文本正文      | 是  | 文本正文，长度不超过1000字。                                                                        |
  | 文本语言类型    | 否  | 支持的文本语言类型，目前支持中文（zh）。有下拉框和输入框模式。                                                        |
  | 生成摘要的长度限制 | 否  | 生成摘要的长度限制。数值长度 \> 1，则返回结果为字数不小于该值且最接近该值的摘要。 0 \<= 数值长度 \<= 1，则返回结果为长度百分比不小于该值且最接近该值的摘要。 |
  | 领域类型      | 否  | 支持的领域类型，取值如下（目前只支持通用领域），默认为通用领域，0：通用领域，有下拉框和输入框模式。                                      |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表5]。
   表5文本摘要（领域版）输出参数说明 
  | 参数   | 说明                        |
  |:---|:---|
  | 摘要结果 | 根据文本请求体，返回摘要结果。调用失败时无此字段。 |
     
  
 
#### 诗歌生成
根据用户输入的诗歌主题，自动赋诗。生成的诗歌种类多样，言简意深，对仗工整，平仄协调。用户不仅可以指定诗歌类型（五言绝句、七言绝句，五言律诗，七言律诗），而且还可以指定是否生成藏头诗，能够满足用户在不同节日、场景的需求。
接口功能及调用方法请参考[诗歌生成](https://support.huaweicloud.com/api-nlp/nlp_03_0070.html)。
- 输入参数 用户配置诗歌生成执行动作，相关参数说明如[表6]所示。
   表6诗歌生成输入参数说明 
  | 参数   | 必填 | 说明                                                                                                                                                                                                                                                                                                                                                                                                   |
  |:---|:---|:---|
  | 诗歌标题 | 是  | 诗歌标题，仅支持中文，长度为1-10个字符。                                                                                                                                                                                                                                                                                                                                                                               |
  | 诗歌正文 | 是  | 诗歌类型，有下拉框和输入框模式。取值如下： - 0：五言绝句  - 1：七言绝句  - 2：五言律诗  - 3：七言律诗   |
  | 藏头诗  | 是  | 藏头诗，有下拉框和输入框模式。取值如下： - 取值为是，为藏头诗。  - 取值为否，非藏头诗。默认取值为否。                                                                                                                                                    |
     
  

- 输出参数 用户可以在之后的执行动作中调用该输出参数，输出参数说明请参考[表7]。
   表7诗歌生成输出参数说明 
  | 参数    | 说明                         |
  |:---|:---|
  | 生成的诗歌 | 根据文本请求体，返回生成的诗歌。调用失败时无此字段。 |