必须先检索企业文档再生成回答，否则答案将依赖模型通用知识；需在方舟平台新建知识库并上传文件（≤20mb），绑定至推理接入点启用知识库增强，设置合理检索参数后通过调试工具或api验证retrieved_chunks是否非空。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在火山引擎AI Agent中实现企业专属知识库问答，必须让模型在生成回答前先从你上传的文档中检索出最相关的内容片段，再将这些内容作为上下文参与推理。这一步跳过会导致回答完全依赖模型通用知识，无法体现公司产品细节、服务流程或内部规范。
在方舟平台创建并配置知识库
登录火山引擎方舟控制台 → 在左侧导航栏点击【知识库】→ 点击【新建知识库】按钮。
填写知识库名称（建议含业务域，如“客服FAQ-2026Q3”），选择知识来源类型：支持上传本地文件（TXT/PDF/Word/Excel/PPT）或填写公开网页URL。单个文件请勿超过【20MB】，超大会触发静默失败且无报错提示。
上传完成后，系统自动进行文本切片与向量化处理，耗时取决于文档总页数，PDF类技术文档通常需1～3分钟。此时不要关闭页面，进度条卡在80%属正常，后台仍在解析表格和图表中的文字。
将知识库绑定到推理接入点
进入【推理接入点】列表 → 选择你要增强的接入点（如“客服对话API”）→ 点击【编辑】→ 展开【高级配置】→ 找到“知识库增强”开关并启用。
在下拉菜单中选择刚创建的知识库，设置【检索返回片段数】为3～5条，【相关性阈值】建议设为0.65。阈值过高会导致检索结果为空，过低则混入噪声信息，影响回答准确性。
保存配置后，该接入点所有后续API请求都会自动触发知识库检索。注意：此操作【不可逆】，若要停用需手动关闭开关并重新发布接入点，否则每次调用都产生知识库查询费用。
验证知识库是否生效
方法一：使用控制台内置的“调试工具”发起测试请求，在输入框中键入明确指向知识库内容的问题，例如“我们的SLA响应时效是几个工作日？”
方法二：调用API时在请求体中加入"enable_knowledge_search": true字段，观察返回JSON中的retrieved_chunks数组是否包含非空文本片段。
如果返回的retrieved_chunks为空数组，但问题明显属于知识库覆盖范围，请立即检查文档是否被正确解析——常见原因是PDF扫描件未OCR、Word中使用了文本框或艺术字、Excel表格未转为纯文本格式。
