查询知识库详情(Token认证)
功能介绍
该接口用于查询知识库详情信息,包括名称、描述、状态、检索方式、数据集信息等。
调用方法
请参见如何调用API。
URI
GET https://aiae.appstage.myhuaweicloud.com/v1/unidata/knowledge-bases/{knowledge_base_id}
请求参数
| 
        参数  | 
      
        是否必选  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|---|
| 
        X-Auth-Token  | 
      
        是  | 
      
        String  | 
      
        参数解释: 用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。  | 
     
响应参数
状态码:200
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        data  | 
      
        KnowledgeBaseDetail object  | 
      
        知识库详情信息。  | 
     
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        last_updated_date  | 
      
        String  | 
      
        参数解释: 最近更新时间。 取值范围: 格式为:yyyy-mm-dd hh:mm:ss,如2024-11-21 11:36:55。  | 
     
| 
        last_updated_by_user_id  | 
      
        String  | 
      
        参数解释: 最近一次更新人ID。 取值范围: 不涉及。  | 
     
| 
        last_updated_by_user_name  | 
      
        String  | 
      
        参数解释: 最近一次更新人名称。 取值范围: 不涉及。  | 
     
| 
        last_updated_by_nick_name  | 
      
        String  | 
      
        参数解释: 最新一次更新人昵称。 取值范围: 不涉及。  | 
     
| 
        tenant_id  | 
      
        String  | 
      
        参数解释: 租户ID。 取值范围: 不涉及。  | 
     
| 
        tenant_name  | 
      
        String  | 
      
        参数解释: 租户名称。 取值范围: 不涉及。  | 
     
| 
        dept_code  | 
      
        String  | 
      
        参数解释: 部门编码。 取值范围: 不涉及。  | 
     
| 
        created_date  | 
      
        String  | 
      
        参数解释: 创建日期。 取值范围: 不涉及。  | 
     
| 
        created_by_user_id  | 
      
        String  | 
      
        参数解释: 创建人ID。 取值范围: 不涉及。  | 
     
| 
        created_by_user_name  | 
      
        String  | 
      
        参数解释: 创建人名称。 取值范围: 不涉及。  | 
     
| 
        created_by_nick_name  | 
      
        String  | 
      
        参数解释: 创建人昵称。 取值范围: 不涉及。  | 
     
| 
        deleted  | 
      
        Boolean  | 
      
        参数解释: 是否删除。 取值范围: 不涉及。  | 
     
| 
        id  | 
      
        String  | 
      
        参数解释: 知识库ID。 取值范围: 不涉及。  | 
     
| 
        name  | 
      
        String  | 
      
        参数解释: 知识库名称。 取值范围: 不涉及。  | 
     
| 
        description  | 
      
        String  | 
      
        参数解释: 知识库描述。 取值范围: 不涉及。  | 
     
| 
        rag_type  | 
      
        String  | 
      
        参数解释: 知识库RAG类型。 取值范围: 可以为空,为空则使用默认值。 枚举值: 
  | 
     
| 
        retrieval_config  | 
      
        RetrievalConfig object  | 
      
        参数解释: 数据库检索配置。 取值范围: 不涉及。  | 
     
| 
        scope  | 
      
        String  | 
      
        参数解释: 知识库范围类型。 取值范围: 
  | 
     
| 
        embed_database  | 
      
        String  | 
      
        参数解释: 向量数据库名称。 取值范围: 不涉及。  | 
     
| 
        db_invoke_api  | 
      
        String  | 
      
        参数解释: 知识库调用API。 取值范围: 不涉及。  | 
     
| 
        status  | 
      
        String  | 
      
        参数解释: 知识库状态。 取值范围: 枚举值: 
  | 
     
| 
        retrieval_status  | 
      
        String  | 
      
        参数解释: 知识库检索状态。 取值范围: 不涉及。  | 
     
| 
        schedule_type  | 
      
        String  | 
      
        参数解释: 调度类型。 取值范围: 不涉及。  | 
     
| 
        schedule_config_id  | 
      
        String  | 
      
        参数解释: 周期性调度配置ID。 取值范围: 不涉及。  | 
     
| 
        schedule_status  | 
      
        String  | 
      
        参数解释: 周期性调度状态。 取值范围: 生效、暂停。  | 
     
| 
        llama_index  | 
      
        Boolean  | 
      
        参数解释: 标记是否由LlamaIndex生成。 取值范围: 不涉及。  | 
     
| 
        data_sets  | 
      
        Array of KnowledgeBaseLinkDataSetDetail objects  | 
      
        参数解释: 知识库关联的数据集信息。 取值范围: 不涉及。  | 
     
| 
        schedule_config  | 
      
        ScheduledTaskConfig object  | 
      
        参数解释: 周期性调度配置。 取值范围: 不涉及。  | 
     
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        retrieval_modes  | 
      
        Array of strings  | 
      
        参数解释: 检索模式,用于设置知识库检索召回时的检索方式。 约束限制: 不涉及。 取值范围: 可传多个值。枚举值: 
 默认取值: 不涉及。  | 
     
| 
        retrieval_hybrid_mode  | 
      
        String  | 
      
        参数解释: 此参数用于指定混合检索的模式。 “retrieval_modes”选择SEMANTIC_RETRIEVAL和FULL_TEXT_RETRIEVAL时,为混合检索。 约束限制: “retrieval_modes”选择SEMANTIC_RETRIEVAL和FULL_TEXT_RETRIEVAL。 取值范围: 支持RRF,枚举值:RRF。 默认取值: 不涉及。  | 
     
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        last_updated_date  | 
      
        String  | 
      
        参数解释: 最近更新时间。 取值范围: 格式为:yyyy-mm-dd hh:mm:ss,如2024-11-21 11:36:55。  | 
     
| 
        last_updated_by_user_id  | 
      
        String  | 
      
        参数解释: 最近一次更新人ID。 取值范围: 不涉及。  | 
     
| 
        last_updated_by_user_name  | 
      
        String  | 
      
        参数解释: 最近一次更新人名称。 取值范围: 不涉及。  | 
     
| 
        last_updated_by_nick_name  | 
      
        String  | 
      
        参数解释: 最新一次更新人昵称。 取值范围: 不涉及。  | 
     
| 
        tenant_id  | 
      
        String  | 
      
        参数解释: 租户ID。 取值范围: 不涉及。  | 
     
| 
        tenant_name  | 
      
        String  | 
      
        参数解释: 租户名称。 取值范围: 不涉及。  | 
     
| 
        dept_code  | 
      
        String  | 
      
        参数解释: 部门编码。 取值范围: 不涉及。  | 
     
| 
        created_date  | 
      
        String  | 
      
        参数解释: 创建日期。 取值范围: 不涉及。  | 
     
| 
        created_by_user_id  | 
      
        String  | 
      
        参数解释: 创建人ID。 取值范围: 不涉及。  | 
     
| 
        created_by_user_name  | 
      
        String  | 
      
        参数解释: 创建人名称。 取值范围: 不涉及。  | 
     
| 
        created_by_nick_name  | 
      
        String  | 
      
        参数解释: 创建人昵称。 取值范围: 不涉及。  | 
     
| 
        deleted  | 
      
        Boolean  | 
      
        参数解释: 是否删除。 取值范围: 不涉及。  | 
     
| 
        id  | 
      
        String  | 
      
        参数解释: 关联ID。 取值范围: 不涉及。  | 
     
| 
        knowledge_base_id  | 
      
        String  | 
      
        参数解释: 知识库ID。 取值范围: 不涉及。  | 
     
| 
        data_set_id  | 
      
        String  | 
      
        参数解释: 知识数据集ID。 取值范围: 不涉及。  | 
     
| 
        data_set_version  | 
      
        String  | 
      
        参数解释: 知识数据集版本。 取值范围: 不涉及。  | 
     
| 
        data_set_index_config_id  | 
      
        String  | 
      
        参数解释: 知识数据集索引配置ID。 取值范围: 不涉及。  | 
     
| 
        vector_table_id  | 
      
        String  | 
      
        参数解释: 向量表ID。 取值范围: 不涉及。  | 
     
| 
        graph_id  | 
      
        String  | 
      
        参数解释: 图ID。 取值范围: 不涉及。  | 
     
| 
        data_set_name  | 
      
        String  | 
      
        参数解释: 数据集名称。 取值范围: 不涉及。  | 
     
| 
        data_type  | 
      
        String  | 
      
        参数解释: 数据类型。 取值范围: 不涉及。  | 
     
| 
        data_set_index_config_name  | 
      
        String  | 
      
        参数解释: 知识数据集索引配置名称。 取值范围: 不涉及。  | 
     
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        cycle_type  | 
      
        String  | 
      
        参数解释: 定时任务周期类型。 取值范围: 枚举值: 
  | 
     
| 
        run_time  | 
      
        String  | 
      
        参数解释: 定时任务执行时间。 取值范围: 格式为:HH:mm:ss,如:18:30:00。  | 
     
| 
        week_day  | 
      
        String  | 
      
        参数解释: 定时任务执行日期。 约束限制: “cycle_type”为“WEEK”时需传入。 取值范围: 枚举值: 
  | 
     
| 
        execute_immediately  | 
      
        Boolean  | 
      
        参数解释: 定时任务是否立即执行一次。 取值范围: true或false。  | 
     
| 
        version_refresh_mode  | 
      
        String  | 
      
        参数解释: 版本刷新模式。 取值范围: 枚举值: 
  | 
     
状态码:400
| 
        参数  | 
      
        参数类型  | 
      
        描述  | 
     
|---|---|---|
| 
        error_code  | 
      
        String  | 
      
        参数解释: 异常错误码。 取值范围: 不涉及。  | 
     
| 
        error_msg  | 
      
        String  | 
      
        参数解释: 异常错误信息。 取值范围: 不涉及。  | 
     
请求示例
无
响应示例
状态码:200
知识库详情响应信息。
{
  "data" : {
    "last_updated_date" : "2025-07-25T11:49:38.000+00:00",
    "last_updated_by_user_id" : "f0e1c67f3ee445cb938fb86bfbdf2255",
    "last_updated_by_user_name" : "developer",
    "last_updated_by_nick_name" : "developer",
    "tenant_id" : "1015192394",
    "tenant_name" : "developer",
    "dept_code" : "1015192394",
    "created_date" : "2025-07-24T09:23:17.000+00:00",
    "created_by_user_id" : "f0e1c67f3ee445cb938fb86bfbdf2255",
    "created_by_user_name" : "developer",
    "created_by_nick_name" : "developer",
    "deleted" : false,
    "id" : "febb587f-20fb-4ec2-8431-f5b8858fecde",
    "name" : "测试_0724_003",
    "description" : "0725第二次修改",
    "rag_type" : "VECTOR_RAG",
    "retrieval_config" : {
      "retrieval_modes" : [ "SEMANTIC_RETRIEVAL" ]
    },
    "scope" : "PRIVATE",
    "dimension" : null,
    "community_auth_codes" : [ ],
    "embed_database" : "CLICK_HOUSE",
    "db_invoke_api" : "EMBEDDING_API",
    "status" : "NORMAL",
    "retrieval_status" : "DISABLE",
    "schedule_type" : "ONCE",
    "schedule_config_id" : null,
    "schedule_status" : null,
    "llama_index" : true,
    "type" : "KB1",
    "data_sets" : [ {
      "last_updated_date" : "2025-07-24T09:23:17.000+00:00",
      "last_updated_by_user_id" : "f0e1c67f3ee445cb938fb86bfbdf2255",
      "last_updated_by_user_name" : "developer",
      "last_updated_by_nick_name" : "developer",
      "tenant_id" : "1015192394",
      "tenant_name" : "developer",
      "dept_code" : "1015192394",
      "created_date" : "2025-07-24T09:23:17.000+00:00",
      "created_by_user_id" : "f0e1c67f3ee445cb938fb86bfbdf2255",
      "created_by_user_name" : "developer",
      "created_by_nick_name" : "developer",
      "deleted" : false,
      "id" : "0de4dd75-35f0-4f62-9bb5-1a044a18205d",
      "knowledge_base_id" : "febb587f-20fb-4ec2-8431-f5b8858fecde",
      "data_set_id" : "3971729f-6f0d-4219-b228-6a8d9df6e8da",
      "data_set_version" : "v2025-07-16T14:14:23Z",
      "data_set_index_config_id" : "b723287c-ccd7-460e-bbe0-2af6bf486f44",
      "vector_table_id" : "707a8872-2420-4ac7-a3d1-64121265e546",
      "data_set_name" : "测试0716_001",
      "data_type" : "TEXT",
      "data_set_index_config_name" : "test_0716",
      "vector_database_type" : "ELASTICSEARCH",
      "full_text_database_type" : "ELASTICSEARCH"
    } ],
    "schedule_config" : null
  }
}
 状态码
| 
        状态码  | 
      
        描述  | 
     
|---|---|
| 
        200  | 
      
        知识库详情响应信息。  | 
     
| 
        400  | 
      
        请求错误。  | 
     
错误码
请参见错误码。