知识 Nexus 集成
自v1.0.0-rc3 起，AI 智能体可以通过内置的 knowledge_nexus_search 工具，在提示词中直接查询 Knowledge Nexus 空间。这样就能基于 Nexus 中维护的内部文档、FAQ 和知识库作答，无需配置自定义工具。
WTOCRM 自带的知识库（PDF、手工上传的文件）请继续使用知识库模块。Nexus 是补充方案——适合组织已经维护了独立知识库、并希望在智能体中复用的场景。
前置条件
- 已部署 WTO Nexus，且 WTOCRM 所在网络可访问。
- Nexus 中至少创建了一个空间，且其中已有完成索引的文档。
- 你的角色拥有编辑智能体的权限（
agents.manage）。
把空间关联到智能体
- 在
Agents → [智能体名称]打开智能体详情。 - 进入 集成 → 知识 Nexus。
- 点击空间选择器。WTOCRM 会通过 core-service 代理查询 Nexus API，并列出可用空间。
- 勾选该智能体可以查询的空间。
- 保存。
智能体如何使用 Nexus
智能体的工具列表中会自动出现名为knowledge_nexus_search 的工具。当用户提出的问题很可能能在知识库中找到答案时，模型会调用该工具：
预期行为
- 有据可依： 如果找到的片段直接回答了问题，智能体会引用该信息。
- 存在缺口： 如果知识库未覆盖该情况，智能体会说明未找到具体信息并追问更多背景，而不是凭空编造（需配合校准良好的提示词）。
- 返回为空： 如果检索没有结果，智能体会继续对话，但不引用知识库。
何时用 Nexus、何时用 WTOCRM 知识库
两者并不互斥——同一个智能体可以同时使用。
排查
如果已关联但智能体没有使用 Nexus：- 确认关联。 重新打开智能体详情，对应空间应处于勾选状态。
- 检查权限。 智能体需要对已关联资源具备
agents.read。 - 确认空间是否已有索引文档。 空间为空或文档仍在处理中时，工具会返回空结果。
- 检查提示词。 如果系统提示词过于刚性（例如“只根据你已知的内容回答”），智能体可能不会调用该工具。请调整提示词，明确何时需要查询外部知识库。
- 查看处理器日志。
wto-ai-processor-community服务会记录工具调用，可用于确认工具是否真的被调用。