LangChain SelfQueryRetriever未生成完整查询参数的问题排查

• 内部提示词模板引导不足
  SelfQueryRetriever自带预设提示词模板，若模板未明确要求LLM考虑所有相关元数据字段，或对genre字段的描述不够突出，会导致LLM在该上下文下忽略genre。可通过代码查看当前模板：

  print(retriever.llm_chain.prompt.template)
  

  检查模板是否完整说明genre的用途，以及是否明确指示需匹配所有与用户查询相关的元数据字段。

• 元数据字段定义不清晰
  初始化SelfQueryRetriever时传入的metadata_field_info中，genre字段的描述可能过于简略（仅定义名称和类型），未明确其作为内容类型过滤的作用。LLM无法识别该字段与用户查询的关联性，自然不会生成对应过滤条件。

• 小参数LLM的上下文注意力限制
  gemma3:4b属于小参数模型，SelfQueryRetriever的提示词比直接调用时更长（包含元数据定义、格式要求等），模型可能因上下文窗口有限，注意力未覆盖到genre字段的信息，导致遗漏过滤条件。可尝试简化提示词冗余内容，或更换参数更大的模型测试。

• 输出解析或约束逻辑问题
  SelfQueryRetriever内部可能存在输出校验或过滤逻辑，误将生成的genre条件剔除。可通过打印Retriever生成的原始查询（而非最终过滤结果），确认LLM是否实际生成了genre条件，再排查后续解析环节是否出错。

内容的提问来源于stack exchange，提问作者codependent