j9九游会登录/ 应用平台 appstage/ api参考/ / / 查询知识数据集详情
更新时间:2025-08-04 gmt 08:00

查询知识数据集详情-j9九游会登录

功能介绍

该接口用于查询知识数据集详情。

调用方法

请参见。

uri

get https://aiae.appstage.myhuaweicloud.com/v1/knowledge-datasets/{data_set_id}

表1 路径参数

参数

是否必选

参数类型

描述

data_set_id

string

参数解释:

知识数据集id,获取方式:

1.创建知识数据集接口返回值即为知识数据集id。

2.进入ai原生应用引擎,在左侧导航栏选择“知识中心 > 知识库”,选择页面右上角的“... > 知识数据集”,在数据集列表中,单击数据集名称,进入详情页即可获取数据集id。

约束限制:

不涉及。

取值范围:

只能由英文字母、数字以及“-”组成,且长度为36个字符。

默认取值:

不涉及。

请求参数

表2 请求header参数

参数

是否必选

参数类型

描述

authorization

string

参数解释:

鉴权信息。获取平台api key,并为api key添加前缀bearer,得到标准鉴权信息,例如bearer sk-74e4157***。api key获取方法请参见创建api key

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应body参数

参数

参数类型

描述

data

knowledgedatasetdetail object

参数解释:

知识数据集详情。

取值范围:

不涉及。

表4 knowledgedatasetdetail

参数

参数类型

描述

data_set_versions

array of kdsversioninfo objects

参数解释:

知识数据集版本配置信息列表。

取值范围:

列表最大长度100。

index_configs

array of kdsindexconfiginfo objects

参数解释:

知识数据集索引配置信息列表。

取值范围:

列表最大长度100。

表5 kdsversioninfo

参数

参数类型

描述

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。

表6 kdsindexconfiginfo

参数

参数类型

描述

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

参数解释:

索引向量化配置。

取值范围:

不涉及。

表7 indexvectorconfig

参数

参数类型

描述

long_text_solution

string

参数解释:

知识数据集切片长文本处理方式。

取值范围:

枚举值:

truncate_mode(截断模式:如果分片的token长度超过向量化模型的token数,则自动对超长部分进行截断处理)。

smart_mode(智能模式:如果分片的token长度超过向量化模型的token数,则知识库向量化失败)。

default_mode(默认模式:如果分片的token长度超过向量化模型的token数,则知识库向量化失败)。

状态码:400

表8 响应body参数

参数

参数类型

描述

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

请求错误。

错误码

请参见错误码

相关文档

网站地图