知识库
更新时间：2025-08-04
知识库
用于存储和管理各类知识文档，以用于构建基于RAG(Retrieval-augmented generation) 的大模型应用。开发者可快速搭建并查看效果。例如，一个医疗知识库可以提供详细的药物使用指导，确保大模型总结时获得正确的健康建议信息。
如何创建知识库
-
在千帆AppBuilder个人空间-知识库页面，点击知识库列表上方的【创建知识库】
- 导入文件并配置好切片策略，点击【确认创建】
如何进行切片命中测试
命中测试可用于测试、获取最佳知识库配置，辅助知识问答效果的调优。选中某个知识库点击进入，选择【命中测试】
如何使用知识库
在自主规划Agent中使用
能力扩展点击「+」，选中知识库后在应用的对话中进行调试即可。
在工作流Agent中使用知识库
选择知识库节点，添加好知识库后配置上下游参数，进行调试即可
通过API/SDK使用知识库
接口能力概览
| 接口名称 | 接口描述 |
|---|---|
| 知识库检索 | 从指定的知识库中进行自定义检索。 |
| 创建知识库 | 为当前用户创建知识库。 |
| 更新知识库 | 更新指定知识库。 |
| 删除知识库 | 删除指定知识库。 |
| 知识库详情 | 获取指定知识库详情。 |
| 知识库列表 | 获取知识库列表。 |
| 知识库文件上传 | 上传文件到知识库。 |
| 知识库url导入 | 导入url到知识库。 |
| 删除知识库文档 | 删除知识库中的指定文档。 |
| 查询知识库文档列表 | 查询指定知识库中的文档列表。 |
| 新增知识库切片 | 为当前知识库中指定文档新增切片。 |
| 更新知识库切片 | 更新指定切片内容。 |
| 删除知识库切片 | 删除指定切片。 |
| 查询知识库切片详情 | 获取指定切片详情。 |
| 查询知识库切片列表 | 获取指定切片详情。 |
上传文件到知识库
接口描述
上传文件到知识库
请求示例
JSON
1curl --location --request POST 'http://qianfan.baidubce.com/v2/knowledgeBase?Action=UploadDocuments' \
2--header 'Authorization: Bearer <AppBuilder API Key>' \
3--form 'file= 文件二进制流' \
4--form 'payload="{ \"id\":\"4bcfc08f-0f30-4acd-95ec-2bedecc8f795\", \"source\": { \"type\": \"file\" }, \"contentFormat\": \"rawText\", \"processOption\": { \"template\": \"custom\", \"parser\": { \"choices\": [\"layoutAnalysis\"] }, \"chunker\": { \"choices\": [\"separator\"], \"separator\": { \"separators\": [\"。\"], \"targetLength\": 400, \"overlapRate\": 0.25 }, \"prependInfo\": [\"title\", \"filename\"] }, \"knowledgeAugmentation\": { \"choices\": [\"faq\",\"spokenQuery\"] } }}"'响应示例
JSON
1HTTP/1.1 200 OK
2{
3 "requestId": "46017562-637f-402a-9000-cfe535986d5d",
4 "documentId": "ee50852a-57ed-44aa-9b8a-6cb7156cf79c"
5}知识库检索
接口描述
从指定的知识库中进行自定义检索。可支持检索策略、过滤条件配置、重排序匹配分阈值、切片上下文扩展等配置。查看具体参数
请求示例
JSON
1curl --location 'http://qianfan.baidubce.com/v2/knowledgebases/query' \
2--header 'Authorization: Bearer <AppBuilder API Key>' \
3--header 'Content-Type: application/json' \
4--data '{
5 "type": "fulltext",
6 "query": "党的二十大报告讲了哪些内容",
7 "knowledgebase_ids": ["c17f9dca-9b38-4dd3-aae6-4cc19c2088e8"],
8 "metadata_filters": {
9 "filters": [
10 {
11 "operator": "==",
12 "field": "doc_id",
13 "value": "b4541f76-e8b1-46e3-8b20-a535ab73a149"
14 }
15 ],
16 "condition": "or"
17 },
18 "pipeline_config": {
19 "id": "pipeline_001",
20 "pipeline": [
21 {
22 "name": "step1",
23 "type": "elastic_search",
24 "threshold": 0.1,
25 "top": 400,
26 "pre_ranking": {
27 "bm25_weight": 0.25,
28 "vec_weight": 0.75,
29 "bm25_b": 0.75,
30 "bm25_k1": 1.5,
31 "bm25_max_score": 50
32 }
33 },
34 {
35 "name": "step2",
36 "type": "ranking",
37 "inputs": ["step1"],
38 "model_name": "ranker-v1",
39 "top": 20
40 },
41 {
42 "name": "step3",
43 "type": "small_to_big"
44 }
45 ]
46 },
47 "top": 1,
48 "skip": 0,
49 "rank_score_threshold": 0.5
50}'响应示例
JSON
1{
2 "chunks": [
3 {
4 "chunk_id": "1f073ffe-3186-4df1-8020-934501892c5a",
5 "knowledgebase_id": "c17f9dca-9b38-4dd3-aae6-4cc19c2088e8",
6 "document_id": "b4541f76-e8b1-46e3-8b20-a535ab73a149",
7 "document_name": "msg",
8 "meta": {
9 "coord": "{\"box\": [[56, 179, 482, 72]], \"page_num\": [24, 25], \"parent_list\": [\"1\、\政\策\顶\层\设\计\指\明\方\向 \\n\", \"\（\二\）\主\要\机\遇 \\n\", \"\二\、2023 \年\宏\观\经\济\展\望 \\n\", \"\图\目\录 \\n\"], \"parent_last\": 1061}",
10 "page_nums": [
11 24,
12 25
13 ],
14 "tokens": 452,
15 "word_count": 588,
16 "title": "msg",
17 "para_format": "txt",
18 "para_type": "text",
19 "chart_img_key_id": "",
20 "left_neighbors": [
21 "83b1a508-3df6-4f1b-aad9-c9d3730bb609"
22 ],
23 "right_neighbors": [
24 "50ed7057-4a4a-4b50-80fe-d20b5cd684c2"
25 ]
26 },
27 "chunk_type": "paragraph",
28 "content": " \n（1）党的二十大报告 \n二十大报告为未来五年的高质量发展制定了战略方向。做出了以下几点战略部署：1）着力构建新发展格局。\n2）着力提高全要素生产率。3）着力提升产业链供应链韧性和安全水平。4）着力推进城乡融合发展和区域协调\n发展。5）着力构建高水平社会主义市场经济体制。6）着力推进高水平对外开放。7）着力推动绿色低碳发展。",
29 "create_time": "2025-08-04T22:49:32.327000",
30 "update_time": "2025-08-04T22:49:32.327000",
31 "retrieval_score": 0.0,
32 "rank_score": 0.5597112774848938,
33 "locations": {
34 "page_num": [
35 24,
36 25
37 ],
38 "box": [
39 [
40 56,
41 112,
42 482,
43 25
44 ]
45 ]
46 },
47 "children": [
48 {
49 "chunk_id": "9a0ede81-e2ad-43ac-82c0-07ed96535d15",
50 "knowledgebase_id": "c17f9dca-9b38-4dd3-aae6-4cc19c2088e8",
51 "document_id": "b4541f76-e8b1-46e3-8b20-a535ab73a149",
52 "document_name": "msg",
53 "meta": {
54 "title": "msg"
55 },
56 "chunk_type": "sentence",
57 "content": " \n（1）党的二十大报告 \n二十大报告为未来五年的高质量发展制定了战略方向。做出了以下几点战略部署：1）着力构建新发展格局。",
58 "create_time": "2025-08-04T22:49:32.327000",
59 "update_time": "2025-08-04T22:49:32.327000",
60 "retrieval_score": 45.635006,
61 "rank_score": 0.7578274865456178,
62 "children": []
63 }
64 ],
65 "neighbour_chunks": [
66 {
67 "chunk_id": "83b1a508-3df6-4f1b-aad9-c9d3730bb609",
68 "knowledgebase_id": "c17f9dca-9b38-4dd3-aae6-4cc19c2088e8",
69 "document_id": "b4541f76-e8b1-46e3-8b20-a535ab73a149",
70 "document_name": "msg",
71 "meta": {
72 "coord": "{\"box\": [[501, 390, 17, 7]], \"page_num\": [23, 24, ], \"parent_list\": [\"\（3\）\\n\", \"2\、\国\内 \\n\", \"\（\一\）\主\要\问\题\和\挑\战 \\n\", \"\二\、2023 \年\宏\观\经\济\展\望 \\n\", \"\图\目\录 \\n\"], \"parent_last\": 1045}",
73 "page_nums": [
74 23,
75 24
76 ],
77 "tokens": 455,
78 "word_count": 592,
79 "title": "msg",
80 "para_format": "txt",
81 "para_type": "text",
82 "chart_img_key_id": "",
83 "left_neighbors": [
84 "a990f209-9b7a-4d0c-bdce-6ee5913edd45"
85 ],
86 "right_neighbors": [
87 "1f073ffe-3186-4df1-8020-934501892c5a"
88 ]
89 },
90 "chunk_type": "paragraph",
91 "content": " \n2018 年，国务院办\n公厅印发《关于保持基础设施领域补短板力度的指导意见》。\n政策深度报告 \n（二）主要机遇 \n1、政策顶层设计指明方向 \n",
92 "create_time": "2025-08-04T22:49:32.326000",
93 "update_time": "2025-08-04T22:49:32.326000",
94 "retrieval_score": 0.0,
95 "rank_score": 0.0,
96 "locations": {
97 "page_num": [
98 23,
99 24
100 ],
101 "box": [
102 [
103 56,
104 474,
105 142,
106 12
107 ]
108 ]
109 },
110 "children": [],
111 "original_chunk_id": "1f073ffe-3186-4df1-8020-934501892c5a",
112 "original_chunk_offset": -1
113 },
114 {
115 "chunk_id": "50ed7057-4a4a-4b50-80fe-d20b5cd684c2",
116 "knowledgebase_id": "c17f9dca-9b38-4dd3-aae6-4cc19c2088e8",
117 "document_id": "b4541f76-e8b1-46e3-8b20-a535ab73a149",
118 "document_name": "msg",
119 "meta": {
120 "coord": "{\"box\": [[56, 179, 482, 72]], \"page_num\": [25], \"parent_list\": [\"\（4\）2023 \年\政\府\工\作\报\告 \\n\", \"1\、\政\策\顶\层\设\计\指\明\方\向 \\n\", \"\（\二\）\主\要\机\遇 \\n\", \"\二\、2023 \年\宏\观\经\济\展\望 \\n\", \"\图\目\录 \\n\"], \"parent_last\": 1065}",
121 "page_nums": [
122 25
123 ],
124 "tokens": 421,
125 "word_count": 548,
126 "title": "msg",
127 "para_format": "txt",
128 "para_type": "text",
129 "chart_img_key_id": "",
130 "left_neighbors": [
131 "1f073ffe-3186-4df1-8020-934501892c5a"
132 ],
133 "right_neighbors": [
134 "a4a87e25-25e5-4c9a-8ce6-39abaff6fdf3"
135 ]
136 },
137 "chunk_type": "paragraph",
138 "content": "财政方面强调“积极的财政政策要加力提效”，\n进一步加大减税缴费、发行政府专项债券等积极财政政策的实施力度。稳增长目标以扩大内需和促进科技创新\n作为两个抓手，通过促进消费和产业转型升级实现高质量的稳增长。报告重点强调了布局三大领域工作：数字\n化转型、国资国企改革及促进民营经济发展、吸引和利用外资。 ",
139 "create_time": "2025-08-04T22:49:32.327000",
140 "update_time": "2025-08-04T22:49:32.327000",
141 "retrieval_score": 0.0,
142 "rank_score": 0.0,
143 "locations": {
144 "page_num": [
145 25
146 ],
147 "box": [
148 [
149 56,
150 407,
151 482,
152 87
153 ]
154 ]
155 },
156 "children": [],
157 "original_chunk_id": "1f073ffe-3186-4df1-8020-934501892c5a",
158 "original_chunk_offset": 1
159 }
160 ]
161 }
162 ],
163 "total_count": 1
164}