查询知识数据集详情
功能介绍
该接口用于查询知识数据集详情。
调用方法
请参见如何调用API。
URI
GET https://aiae.appstage.myhuaweicloud.com/v1/knowledge-datasets/{data_set_id}
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
data_set_id | 是 | String | 参数解释: 知识数据集id,获取方式: 1.创建知识数据集接口返回值即为知识数据集id。 2.进入AI原生应用引擎,在左侧导航栏选择“知识中心 > 知识库”,选择页面右上角的“... > 知识数据集”,在数据集列表中,单击数据集名称,进入详情页即可获取数据集id。 约束限制: 不涉及。 取值范围: 只能由英文字母、数字以及“-”组成,且长度为36个字符。 默认取值: 不涉及。 |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
Authorization | 是 | String | 参数解释: 鉴权信息。获取平台API Key,并为API Key添加前缀Bearer,得到标准鉴权信息,例如Bearer sk-74e4157***。API Key获取方法请参见创建API Key。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
参数 | 参数类型 | 描述 |
|---|---|---|
data | KnowledgeDataSetDetail object | 参数解释: 知识数据集详情。 取值范围: 不涉及。 |
参数 | 参数类型 | 描述 |
|---|---|---|
data_set_versions | Array of KdsVersionInfo objects | 参数解释: 知识数据集版本配置信息列表。 取值范围: 列表最大长度100。 |
index_configs | Array of KdsIndexConfigInfo objects | 参数解释: 知识数据集索引配置信息列表。 取值范围: 列表最大长度100。 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 参数解释: 数据集版本id。 取值范围: 由数字、字母和中划线组成,长度36。 |
version | String | 参数解释: 数据集版本号。 取值范围: 格式为:vyyyy-mm-ddThh:mm:ssZ,如v2024-11-21T11:36:55Z。 |
created_date | String | 参数解释: 数据集版本创建时间。 取值范围: 格式为:yyyy-mm-dd hh:mm:ss,如2024-11-21 11:36:55。 |
last_updated_date | String | 参数解释: 数据集版本最近更新时间。 取值范围: 格式为:yyyy-mm-dd hh:mm:ss,如2024-11-21 11:36:55。 |
参数 | 参数类型 | 描述 |
|---|---|---|
id | String | 参数解释: 索引id。 取值范围: 由数字、字母和中划线组成,长度36。 |
name | String | 参数解释: 索引名称。 取值范围: 由中英文、数字、“_”组成,长度为[2-50]。 |
description | String | 参数解释: 索引描述。 取值范围: 不涉及。 |
data_set_id | String | 参数解释: 知识数据集id。 取值范围: 由数字、字母和中划线组成,长度36。 |
vector_model_service_key | String | 参数解释: 向量化模型的service_key。 取值范围: 不涉及。 |
index_vector_config | IndexVectorConfig object | 参数解释: 索引向量化配置。 取值范围: 不涉及。 |
参数 | 参数类型 | 描述 |
|---|---|---|
long_text_solution | String | 参数解释: 知识数据集切片长文本处理方式。 取值范围: 枚举值: TRUNCATE_MODE(截断模式:如果分片的token长度超过向量化模型的token数,则自动对超长部分进行截断处理)。 SMART_MODE(智能模式:如果分片的token长度超过向量化模型的token数,则知识库向量化失败)。 DEFAULT_MODE(默认模式:如果分片的token长度超过向量化模型的token数,则知识库向量化失败)。 |
状态码:400
参数 | 参数类型 | 描述 |
|---|---|---|
error_code | String | 参数解释: 异常错误码。 取值范围: 不涉及。 |
error_msg | String | 参数解释: 异常错误信息。 取值范围: 不涉及。 |
请求示例
无
响应示例
状态码:200
操作成功,返回数据集详情。
{
"data" : {
"data_set_versions" : [ {
"id" : "askdjh28e62-xxxxxxxxx-a15be0d63812",
"version" : "v2024-11-21T11:36:55Z",
"created_date" : "2024-11-11 19:36:57",
"last_updated_date" : "2024-11-21 19:36:57"
} ],
"index_configs" : [ {
"id" : "d3f28e62-xxxxxxx-a15be0d638a2",
"name" : "索引配置名称",
"description" : "索引配置",
"data_set_id" : "d3f28e62-3a81-4018-a48f-a15be0d638a2",
"vector_model_service_key" : "service_key",
"index_vector_config" : {
"long_text_solution" : "TRUNCATE_MODE"
}
} ]
}
} 状态码:400
请求错误。
{
"error_code" : "AIAE.40001001",
"error_msg" : "参数xxxx不合法。"
} 状态码
状态码 | 描述 |
|---|---|
200 | 操作成功,返回数据集详情。 |
400 | 请求错误。 |
错误码
请参见错误码。

