文档中心

AgentKit

请输入

Knowledge

GetKnowledgeBase - 查询知识库信息

查询知识库信息。

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：GetKnowledgeBase

要执行的操作，取值：GetKnowledgeBase。

Version string 必选示例值：2025-10-30

API的版本，取值：2025-10-30。

KnowledgeId string 必选示例值：kb-4yds45****

知识库ID。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

AssociatedRuntimes object[] 示例值：--

关联的运行时列表。

Id string 示例值：r-ye9tu7****

运行时ID。

Name string 示例值：runtime-01

运行时名称。

CreateTime string 示例值：2025-09-17T10:00:00+8:00

知识库创建时间。

Description string 示例值：sample description.

知识库描述。

KnowledgeId string 示例值：kb-4yds45****

知识库ID。

LastUpdateTime string 示例值：2025-09-17T10:00:00+8:00

知识库更新时间。

Name string 示例值：my_knowledge

知识库名称。

ProjectName string 示例值：default

运行时所属项目。

ProviderKnowledgeId string 示例值：kb-ye7s2g****

已导入的知识库ID。

ProviderType string 示例值：VIKINGDB_KNOWLEDGE

知识库平台类型，取值：

VIKINGDB_KNOWLEDGE：Viking 知识库

Region string 示例值：cn-beijing

知识库所属区域。

Status string 示例值：Ready

知识库状态，取值：

Importing：导入中。

ImportFailed：导入失败。

Ready：成功。

Deleting：删除中。

DeleteFailed：删除失败。

Deleted：资源失效。

Error：错误。

Trn string 示例值：trn:agentkit:cn-beijing:210000:knowledge:kb-****

火山引擎唯一资源ID。

VpcConfig object 示例值：--

VPC私网配置。

SubnetIds string[] 示例值：["subnet-1234567890"]

子网ID列表。

VpcId string 示例值：vpc-257gqcdfvx6n****

VPC ID。

请求示例

POST https://agentkit.cn-beijing.volcengineapi.com?Action=GetKnowledgeBase&Version=2025-10-30 HTTP/1.1​
Content-Type: application/json​
{​
  "PageNumber": 1​
}​
​

返回示例

{​
  "ResponseMetadata": {​
    "RequestId": "202106111445100102252431000052****",​
    "Action": "GetKnowledgeBase",​
    "Version": "2025-10-10",​
    "Service": "agentkit",​
    "Region": "cn-beijing"​
  },​
  "Result": {​
    "AssociatedRuntimes": {​
      "Id": "r-ye9tu7****",​
      "Name": "runtime-01"​
    }​
    "CreateTime": "2025-09-16T10:00:00Z",​
    "Description": "",​
    "KnowledgeId": "kb-4yds45****",​
    "LastUpdateTime": "2025-09-16T10:05:00Z",​
    "Name": "my_knowledge",​
    "ProjectName": "default",​
    "ProviderKnowledgeId": "kb-travel-001",​
    "ProviderType": "VIKINGDB_KNOWLEDGE",​
    "Region": "cn-beijing",​
    "Name": "my_knowledge",​
    "Trn": "trn:agentkit:cn-beijing:210000:knowledge:kb-****",​
    "Status": "Ready",​
    "VpcConfig": {​
      "SubnetIds": ["subnet-1234567890"],​
      "VpcId": "vpc-257gqcdfvx6n****"​
    }​
  }​
}​

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MissingParameter.KnowledgeId	The required parameter KnowledgeId is not supplied.	参数KnowledgeId不能为空。

最近更新时间：2025.12.16 10:09:03

这个页面对您有帮助吗？

有用

无用