[Bug]:[问题反馈] deeptutor 1.6.8:Tencent IMA 知识库添加到伙伴后,检索未获得可核对内容与来源
Do you need to file an issue?
- I have searched the existing issues and this bug is not already filed.
- I believe this is a legitimate bug, not just a question or feature request.
Describe the bug
通过官方 PyPI 在 Windows 独立虚拟环境中安装 deeptutor 1.6.8,使用 Tencent IMA 知识库“宝宝小学”。
该知识库在知识中心可见,在已有伙伴“熊猫数学伙伴”的添加候选列表中也可见。完成“复制进工作区”后,伙伴资料库已显示“宝宝小学 · 知识库”。
但在伙伴聊天中请求检索三年级数学乘法相关教材,并要求提供摘要、可核对的原文及来源后,回复未提供检索内容、教材原文、文档标题或来源标识。
伙伴回复自述进行了两次查询,并称“工具执行完成,但没有返回文本内容”。目前没有取得本轮原始工具调用日志,因此不能确认实际调用次数、原始返回结果及故障环节,也不能据此认定知识库没有相关内容。
环境:
- 操作系统:Windows
- 安装来源:官方 PyPI,非 GitHub 源码部署
- deeptutor:1.6.8
- Python:3.12.10
- 使用独立虚拟环境
- pip check:No broken requirements found.
- 知识库类型:Tencent IMA
- 测试日期:2026 年 9 月 17 日
补充证据:
- GET /api/knowledge-bases 曾返回 200 OK。
- 添加前的接口响应中,该库的 rag_provider 为 ima,available 为 true,status 为 ready。
- 上述响应不是添加后的实时分配状态,也不能证明远端检索成功。
- rag、kb_files、knowledge_frontier、read_source 已勾选,但勾选不代表本轮实际调用成功。
- 知识中心显示 0 篇文档;由于 IMA 是连接型知识库,这不能单独作为远端知识库不可用的证据。
请协助核查:
- 伙伴资料库添加状态是否正确保存,并被聊天会话读取。
- 本轮是否实际执行 rag,以及目标知识库和查询参数是否正确。
- IMA 请求及原始响应是否正常。
- 检索响应转为工具文本时,是否出现内容丢失或空结果、异常未明确传递的问题。
如需补充日志,请告知 Windows / PyPI 安装环境中的日志位置、采集方法及所需时间范围。我会脱敏后提供。
当前仅记录本环境一次测试会话中的现象,尚未验证稳定复现,根因未确认。 证据截图说明:
- 检索回复截图:未提供可核对的内容与来源。回复中的工具调用描述属于伙伴聊天自述,非原始执行日志。
- 添加后的伙伴资料库截图:显示“宝宝小学 · 知识库”。
Steps to reproduce
- 在 Windows 上通过官方 PyPI,将 deeptutor 1.6.8 安装到独立虚拟环境并启动。
- 在知识中心确认已配置的 Tencent IMA 知识库“宝宝小学”可见。
- 打开已有伙伴“熊猫数学伙伴”,进入“配置”下的“资料库”。
- 点击“添加”,选择“宝宝小学”,点击“复制进工作区 (1)”。
- 确认伙伴资料库中显示“宝宝小学 · 知识库”。
- 在伙伴聊天中请求: 请从“宝宝小学”知识库检索三年级数学中与乘法有关的教材内容,提供摘要、可核对的原文,以及工具实际返回的文档标题、来源标识或页码;如果没有命中、工具不可用或调用报错,请如实说明,不要使用网页搜索或通用知识替代。
- 观察到伙伴回复未提供可核对的检索内容与来源。
预期结果: 检索成功时,返回相关内容及可用来源信息;无命中、调用失败或返回为空时,明确区分这些状态,提供可诊断提示。
实际结果:
Expected Behavior
伙伴添加 Tencent IMA 知识库后,应能使用该知识库执行检索。
如果检索命中,应返回与查询相关的内容摘要、可核对的原文,以及服务实际提供的文档标题、来源标识或页码;服务未提供的信息不应编造。
如果检索未命中、工具未实际执行、调用失败或响应内容为空,应明确区分这些情况,给出可诊断的提示,而不是仅表示执行完成却没有可核对内容。
不应使用网页搜索或通用知识代替指定知识库的检索结果。
Related Module
Dashboard
Configuration Used
运行环境:
- 操作系统:Windows
- 安装方式:通过官方 PyPI 安装,使用独立虚拟环境,非 GitHub 源码部署
- deeptutor 版本:1.6.8
- Python 版本:3.12.10
- pip check 结果:No broken requirements found.
知识库与伙伴配置:
- 知识库类型:Tencent IMA
- 知识库名称:宝宝小学
- 使用已有伙伴:熊猫数学伙伴
- 已通过伙伴配置中的“资料库 → 添加 → 复制进工作区”添加该知识库
- 添加后,伙伴资料库显示“宝宝小学 · 知识库”
- 已勾选工具:rag、kb_files、knowledge_frontier、read_source
说明: 工具勾选状态仅表示配置已启用,不证明本轮实际执行成功。 问题发生在伙伴聊天中的知识库检索环节,具体故障模块尚未确认。 未附密钥、令牌或其他认证信息。
Logs and screenshots
目前尚未取得本轮原始工具调用日志或 IMA 原始响应。
聊天回复未提供内容摘要、可核对的教材原文、文档标题或来源标识。回复中关于“两次调用”和“工具执行完成,但没有返回文本内容”的描述,属于伙伴聊天自述,不是原始执行日志。
证据截图说明:
- 检索回复截图:未获得可核对的内容与来源。
- 添加后伙伴资料库截图:显示“宝宝小学 · 知识库”。
- 添加候选列表截图:“宝宝小学”可见且可选。
- 工具勾选配置截图:相关工具已勾选;该图拍摄于添加前。
已有接口观察: GET /api/knowledge-bases 曾返回 200 OK;添加前的响应中,该库的 rag_provider 为 ima,available 为 true,status 为 ready。这不是添加后的实时分配状态,也不能证明远端检索成功。
如需进一步排查,请告知 Windows / PyPI 安装环境中的日志位置、采集方法及所需时间范围,我会脱敏后补充。
Additional Information
- DeepTutor 版本:deeptutor 1.6.8
- 操作系统:Windows,具体版本暂未记录
- Python 版本:3.12.10
- Node.js 版本:未确认
- 浏览器:具体名称及版本暂未记录
- 相关问题:暂未提供关联的问题编号
其他信息:
- 通过官方 PyPI 安装,使用独立虚拟环境,非 GitHub 源码部署。
- pip check 返回:No broken requirements found.
- 知识库类型:Tencent IMA。
- 当前仅记录本环境一次测试会话中的现象,尚未验证稳定复现,根因未确认。
Source: HKUDS/DeepTutor