创建知识库
更新时间：2024-11-13
接口描述
为当前用户创建知识库
在线调试
百度智能云千帆提供了 API在线调试平台-示例代码 ，用于帮助开发者调试接口，平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用。
权限说明
Authorization需要填写密钥
接口定义
| Path | /v2/knowledgeBase?Action=CreateKnowledgeBase |
|---|---|
| Method | POST |
| Content-Type | application/json |
| Authorization | 请求签名(此签名为应用工作台密钥) |
请求结构
POST /v2/knowledgeBase?Action=CreateKnowledgeBase HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"name": "knowledge_base_name",
"description": "knowledge_base description",
"config": {
"index": {
"type": "bes" # public | bes
"esUrl": "host:port",
"username": "",
"password": ""
}
}
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| name | string | 是 | 知识库名称 |
| description | string | 否 | 知识库描述 |
| config | dict | 是 | 知识库配置 |
| config \ index | dict | 是 | 知识库存储配置 |
| config \ index \ type | string | 是 | 知识库索引存储配置 (public | bes ) |
| config \ index \ esUrl | string | type=bes 时是 | bes 访问地址 |
| config \ index \ username | string | type=bes 时是 | bes 用户名 |
| config \ index \ password | string | type=bes 时是 | bes 密码 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段 | 类型 | 必然存在 | 说明 |
|---|---|---|---|
| requestId | string | 是 | requestId |
| id | string | 是 | 知识库id |
| name | string | 是 | 知识库名称 |
| description | string | 是 | 知识库描述 |
| config \ index | dict | 是 | 知识库配置 |
| config \ index \ type | string | 是 | 知识库索引存储配置 (public | bes | vdb) |
| config \ index \ esUrl | dict | 是 | bes 访问地址 |
示例
请求curl 示例
curl --location 'https://qianfan.baidubce.com/v2/knowledgeBase?Action=CreateKnowledgeBase' \
--header 'Authorization: Bearer authorization string' \
--header 'Content-Type: application/json' \
--data '{
"name": "knowledge_base",
"description": "knowledge_base description",
"config": {
"index": {
"type": "public",
"esUrl": "",
"username": "",
"password": ""
}
}
}'正确响应示例
HTTP/1.1 200 OK
{
"requestId": "a6057d42-57b0-4097-8439-a86ab98694c0",
"id": "5e12955f-6b45-4f54-b2b6-84369f068a3d",
"name": "knowledge_base",
"description": "knowledge_base description",
"config": {
"index": {
"type": "public",
"esUrl": ""
}
}
}错误响应示例
HTTP/1.1 400
{
"code": "InvalidRequestArgumentError",
"message": "index type invalid",
"requestId": "20123341-d278-4a43-b04c-db5bc68c4769"
}