新增切片知识点
更新时间：2026-05-26
POST
https://qianfan.baidubce.com/v2/knowledgeBase?Action=AddKeypoints
本接口插入知识点到指定知识库的文档切片中，返回请求ID标识。
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
Headers 参数
除公共头域外，无其它特殊头域
Body 参数
chunkId
string
切片ID。 知识库文件中特定文本片段的唯一标识，需通过依次进入目标知识库、对应文件详情页，在切片列表中获取切片ID。
必选
keypoints
array
待插入的知识点列表，单条知识点长度不超过384字符，数量范围为[1, 16]
通过此接口新增的知识点默认类型为自定义
必选
显示子属性
隐藏子属性
items
string
请求结构
POST /v2/knowledgeBase?Action=AddKeypoints HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"knowledgeBaseId": "882181a4-****-30f2614e57ea",
"chunkId": "882181a4-****-30f2614e57ea",
"keypoints": ["https://www.****.com", "物流相关"]
}示例代码
请求示例
curl --location 'https://qianfan.baidubce.com/v2/knowledgeBase?Action=AddKeypoints' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer bce-v3/ALTAK-******VwdRiskoq/5fe76a06b6c27aa3bc51a82507075435269f681a' \
--data '{
"knowledgeBaseId": "58d5ad28-****-4ce9-8d26-149680c1932e",
"chunkId": "4b9168f4-8b37-***-80c4-72b82309d529",
"keypoints": [
"这里是第一条知识点内容",
"这里是第二条知识点内容"
]
}'返回响应
Headers 参数
除公共头域外，无其它特殊头域
返回参数
requestId
string
请求ID
可选
JSON
{
"requestId": "11436ff4-7192-4d82-86a4-3739ca4f1ab5"
}JSON
{
"code": "InvalidRequestArgumentError",
"message": "Parameter 'keypoints' must not be empty",
"requestId": "9c1389e8-1567-430e-a5d4-a21ea4748ab8"
}评价此篇文章