weisijie 94a9f24a5d 1. 实现了 RAG AI Bridge 进程管理器,由 Java 端通过 ProcessBuilder 启动 Python 服务并以环境变量注入 LLM 配置,替代原有独立进程启动方式,统一了模型配置的下发链路; il y a 1 mois
..
.env.example daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; il y a 1 mois
README.md daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; il y a 1 mois
config.example.yaml daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; il y a 1 mois
requirements.txt daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; il y a 1 mois
server.py 94a9f24a5d 1. 实现了 RAG AI Bridge 进程管理器,由 Java 端通过 ProcessBuilder 启动 Python 服务并以环境变量注入 LLM 配置,替代原有独立进程启动方式,统一了模型配置的下发链路; il y a 1 mois
test_server.py daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; il y a 1 mois

README.md

RAG AI Bridge

该服务只生成 SQL/Cypher,不直接执行业务 SQL 或最终 Cypher。生成结果返回 Java 后,由现有 Guard 校验并执行。

启动

cd backend/rag-ai-bridge
python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt
copy config.example.yaml config.yaml
copy .env.example .env
# 修改 config.yaml 和 .env
python server.py

config.yaml 保存服务地址、模型名称、Neo4j 地址及只读策略等非敏感配置;.env 只保存 OPENAI_API_KEYNEO4J_PASSWORD。两者均为本地文件,不应提交。

配置优先级:系统环境变量 > .env > config.yaml > 内置默认值。没有 config.yaml 时服务仍会使用默认值启动,并输出复制示例文件的提示。缺少密钥时服务也能启动,GET /health 会分别返回 llmConfigured=falseneo4jConfigured=false

接口:

  • GET /health
  • POST /text2sql
  • POST /text2cypher

环境变量覆盖项包括:RAG_AI_BRIDGE_HOSTRAG_AI_BRIDGE_PORTLLM_PROVIDEROPENAI_MODELOPENAI_BASE_URLLLM_TEMPERATURELLM_TIMEOUTVANNA_ENABLEDTEXT2CYPHER_ENABLEDNEO4J_URINEO4J_USERNAMEREADONLY_SQLREADONLY_CYPHERDEFAULT_LIMIT