火山引擎API_Key绑定模型后如何接入知识库问答？

必须先创建知识库并配置推理接入点绑定，否则API调用无法读取私有文档；创建知识库需上传脱敏文档并建向量索引；绑定时启用上下文增强、选择知识库、设相关性阈值0.65及返回片段数3；调用后验证响应是否含知识库原文引用。

要在火山引擎上让API Key绑定的模型支持知识库问答，必须先完成知识库创建和推理接入点配置，否则调用时模型无法读取私有文档内容。

创建企业知识库

进入火山方舟控制台 → 点击左侧「知识库」→「新建知识库」。

填写知识库名称（如“客服FAQ_v2”）、描述，上传PDF/Word/Markdown等格式的业务文档；上传后系统自动解析文本并建立向量索引。

【注意：文档中若含敏感信息（如手机号、身份证号），需提前脱敏，否则检索结果可能触发安全拦截】

将知识库绑定到已有的推理接入点

在火山方舟控制台 → 左侧导航栏点击「在线推理」→「推理接入点」→ 找到你已创建的接入点（例如名称为“DeepSeek-R1-FAQ”）→ 点击右侧「编辑」。

滚动到「高级配置」区域 → 展开「上下文增强」→ 勾选「启用知识库检索」→ 在下拉菜单中选择刚创建的企业知识库 → 设置相关性阈值为0.65（低于此值的片段不送入模型）→ 输入「返回片段数量」为3（最多补充3段上下文）→ 保存配置。

这一步做完后，该接入点后续所有API调用都会自动携带知识库检索结果作为system prompt的一部分。

调用时验证知识库是否生效

方法一：使用curl命令快速测试

执行以下命令（替换YOUR_API_KEY、YOUR_ENDPOINT_ID、YOUR_QUESTION）：

curl -X POST "https://ark.cn-beijing.volces.com/api/v1/chat/completions" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_ENDPOINT_ID",
"messages": [
{"role": "user", "content": "YOUR_QUESTION"}
]
}'

方法二：在Postman中新建请求，URL填入https://ark.cn-beijing.volces.com/api/v1/chat/completions，Headers添加Authorization和Content-Type，Body选raw→JSON，粘贴同上结构的JSON体。

收到响应后检查返回内容是否包含知识库中的原文关键词或业务术语——若出现“根据您提供的《售后服务政策》第3条……”这类引用说明已成功接入。