开启知识图谱功能

本文档介绍如何在 WeKnora 中启用并验证知识图谱（Neo4j）功能，帮助你完成从环境准备到前端配置的全流程。

前置条件

快速入门参见知识图谱

在项目根目录的 .env 文件中新增或修改以下变量：

NEO4J_ENABLE=true
NEO4J_URI=bolt://neo4j:7687
NEO4J_USERNAME=neo4j
NEO4J_PASSWORD=your_strong_password
# 可选：NEO4J_DATABASE=neo4j

说明：

项目附带 Neo4j 组件，可直接用以下命令启动：

bash

docker-compose --profile neo4j up -d

常见验证命令：

bash

docker ps | grep neo4j

开发环境中 Neo4j 的启动方式参见开发指南

为了让新的环境变量生效，重启后端与前端：

bash

make stop && make start
# 或者
docker compose up -d --build

确保后端日志中出现 neo4j 初始化成功的提示。

保存后，系统会在文档入库阶段自动触发实体与关系抽取任务。

在知识库或对话页面中上传文档后，前端应展示图谱可视化入口；对话时系统会自动根据意图查询图谱并返回补充信息。

无法连接 Neo4j：确认网络可达、NEO4J_URI 与用户名密码正确，并检查 Neo4j 容器日志
未生成节点：确认知识库已开启实体/关系抽取，且上传的文档已完成解析；查看后端日志中是否有抽取任务异常
查询无结果：尝试在 Neo4j 控制台执行 CALL db.schema.visualization; 查看 schema 是否存在，必要时重新导入文档

更多排查建议参见常见问题

完成以上步骤后，知识图谱功能即成功启用，可结合 RAG 及 Agent 流程提升问答质量。