# 知识溯源 - AddCite
#### 功能介绍
知识溯源接口
#### URI
POST /v1/{project_id}/applications/{application_id}/uni-search/multimodal/rac
表1路径参数 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| project_id     | 是    | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0022.html)。 **约束限制：** 不涉及 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及 |
| application_id | 是    | String | **参数解释：** 应用ID，获取方法请参见[获取应用ID](https://support.huaweicloud.com/api-koosearch/koosearch_06_0021.html)。 **约束限制：** 字符串 **取值范围：** 1～64个字符，只能包含数字、字母、中划线和下划线，且必须以字母开头。 **默认取值：** 不涉及 |
   
#### 请求参数
表2请求Header参数 
| 参数      | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| traceid | 否    | String | **参数解释：** 请求唯一标识 **约束限制：** 不涉及 **取值范围：** 0\~64位 **默认取值：** 不涉及 |
   
表3请求Body参数 
| 参数     | 是否必选 | 参数类型                                                  | 描述                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| query  | 是    | String                                                | **参数解释：** 用户Query **约束限制：** 不涉及 **取值范围：** 长度不能超过4096个字符。 **默认取值：** 不涉及 |
| answer | 是    | String                                                | **参数解释：** 生成文本整句 **约束限制：** 不涉及 **取值范围：** 1\~4096个字符。 **默认取值：** 不涉及     |
| docs   | 是    | Array of [DocItem] objects | **参数解释：** 引用列表 **约束限制：** 不涉及 **取值范围：** 1\~40个引用 **默认取值：** 不涉及          |
   
 表4DocItem 
| 参数       | 是否必选 | 参数类型                                                | 描述                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| metadata | 是    | [DocMetaData] object | **参数解释：** 召回文档的信息 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及          |
| type     | 否    | String                                              | **参数解释：** 引用类型 **约束限制：** 0\~40位取值范围 **取值范围：** 不涉及 **默认取值：** Document |
   
 表5DocMetaData 
| 参数       | 是否必选 | 参数类型   | 描述                                                                                                                                                                       |
|:---|:---|:---|:---|
| chunk_id | 是    | String | 参数解释： 文段的唯一id 约束限制： 不涉及 默认取值： 不涉及 |
| title    | 是    | String | 参数解释： 引用标题 约束限制： 不涉及 默认取值： 不涉及    |
| content  | 否    | String | 参数解释： 引用内容 约束限制： 不涉及 默认取值： 不涉及    |
| doc_name | 是    | String | 参数解释： 引用文档名称 约束限制： 不涉及 默认取值： 不涉及  |
| type     | 否    | String | 参数解释： 引用类型 约束限制： 不涉及 默认取值： 不涉及    |
   
#### 响应参数
**状态码：200**
表6响应Body参数 
| 参数    | 参数类型              | 描述                                                                                                                       |
|:---|:---|:---|
| index | Array of integers | **参数解释：** answer关联的引用序号 **取值范围：** 0\~5个 |
   
**状态码：400**
表7响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                            |
|:---|:---|:---|
| error_code | String | **参数解释：** [错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。 **取值范围：** 不涉及 |
| error_msg  | String | **参数解释：** 错误描述。 **取值范围：** 不涉及                                                                |
   
**状态码：500**
表8响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                            |
|:---|:---|:---|
| error_code | String | **参数解释：** [错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。 **取值范围：** 不涉及 |
| error_msg  | String | **参数解释：** 错误描述。 **取值范围：** 不涉及                                                                |
   
#### 请求示例
请求体
```
/v1/{project_id}/applications/{application_id}/uni-search/multimodal/rac
{
  "query" : "总体业务流程大致是怎么样的？",
  "answer" : "1. **平台签约**：平台客户签订e企付协议，由客户经理录入客户信息、收款信息、支付工具、支付方式、收费等档案信息。",
  "docs" : [ {
    "type" : "Document",
    "metadata" : {
      "title" : "第二章 业务流程 第一节 总体业务流程",
      "content" : "选择结算账户、支付方式进行支付，并填写相关收支申报信息，向境外收款企业进行付款。\n3、支付结果查询\n企业网银、企业手机银行提供客户自助查询支付明细功能、指令查询功能，满足客户对账需求。",
      "doc_name" : "产品手册.doc",
      "chunk_id" : "6a7b8d101d464fe093212bc2b6baf725"
    }
  }, {
    "type" : "Document",
    "metadata" : {
      "title" : "第二章 业务流程 第二节 合作方准入、签约及协议维护(1)",
      "content" : "支付结果查询\n企业网银、企业手机银行提供客户自助查询支付明细功能、指令查询功能，满足客户对账需求",
      "doc_name" : "产品手册.doc",
      "chunk_id" : "30a1b1edef1049a6b3311a3a622ff920"
    }
  }, {
    "type" : "Document",
    "metadata" : {
      "title" : "第二章 业务流程 第二节 合作方准入、签约及协议维护(2)",
      "content" : "支付结果查询\n企业网银、企业手机银行提供客户自助查询支付明细功能、指令查询功能，满足客户对账需求",
      "doc_name" : "产品手册.doc",
      "chunk_id" : "3a364d93684b4e4f8a1b18c954728c63"
    }
  } ]
}
```
#### 响应示例
**状态码：200**
引用响应
```
{
  "index" : [ 1 ]
}
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 引用响应   |
| 400 | 请求参数错误 |
| 500 | 内部错误   |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-koosearch/ErrorCode.html)。