需调用火山引擎Knowledge Search服务并设置"enable_llm_generation": false和"return_raw_chunks": true,从raw_chunks字段获取原始文档片段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要在火山引擎知识检索中跳过大模型生成环节,直接拿到原始匹配文档片段,而不是被润色、总结或改写后的回答。这适用于需要核对原始出处、做人工研判、或对接下游结构化处理系统等场景。
确认使用的是私域知识库搜索而非联网搜索
联网搜索(webSearch)默认强制走大模型摘要生成流程,无法关闭回答生成;只有【私域知识库搜索(Knowledge Search)】支持纯原文返回模式。若你当前调用的是FunctionName为webSearch的接口,立即切换至Knowledge Search服务入口。
进入火山引擎控制台→「AI与大模型」→「知识库服务」→选择已创建的私域知识库实例,确保该实例已完成文档上传与Embedding构建(状态为“就绪”)。
API请求中禁用LLM生成层
在调用Knowledge Search的search接口时,必须显式设置参数:"enable_llm_generation": false。
该参数默认为true,一旦遗漏,系统仍将自动调用大模型对检索结果做重排+摘要,导致返回内容非原文。注意:此参数仅在Knowledge Search v2.3+版本生效,低于该版本需升级服务实例。
完整请求体关键字段示例:
{"query":"用户投诉响应时效标准","top_k":5,"enable_llm_generation":false,"return_raw_chunks":true}
获取并解析原始切片数据
启用return_raw_chunks:true后,响应体中将出现raw_chunks数组字段,每个元素包含:
– content:未经任何清洗、截断、改写的原始段落文本(含换行与标点)
– source_file_name:对应原始文档文件名
– page_number(若PDF/扫描件)或line_range(若文本类):精确定位到源文件位置
⚠️ 注意:chunks数组(含LLM重排摘要)与raw_chunks是两个独立字段,务必只读取后者。若代码中误取chunks[0].content,仍会拿到生成内容。
在Copilot插件中关闭知识增强生成
方法一:Obsidian + Copilot插件直连模式
打开Copilot设置→「Knowledge Base」→找到对应火山引擎知识库连接项→关闭「Enable AI summarization for search results」开关。
方法二:通过自定义Prompt硬性约束
在Copilot的「System Prompt」中追加指令:“所有知识库检索结果必须原样返回,禁止概括、缩写、补全、解释或添加任何额外信息。仅输出raw_chunks中的content字段内容,一行一段,不加标题、序号、说明。”
这一步必须做,否则Copilot底层仍会默认触发LLM后处理——即使API已关掉生成,插件层可能二次加工。
验证返回是否为纯原文
第一步:发起一次明确可定位的查询,例如输入“《客户服务SOP_V3.2》第4.1条原文”。
第二步:比对返回内容与你上传的原始PDF中对应章节的逐字一致性,特别检查数字、单位、括号、顿号是否完全一致。
第三步:查看响应头中X-Volc-Search-Mode值是否为raw_chunk_only,是则确认走通纯原文链路。
若发现返回内容出现“根据文档可知…”“综上所述…”等引导句式,说明某一层(API参数/插件设置/Agent编排)仍有LLM生成未关闭,需逐层回溯排查。

















