weisijie abd9fbdac0 1. 实现了结构化数据 Text2SQL RAG 检索能力,新增 Schema 画像、关系发现、查询上下文构建与 SQL 结果修复链路; 1 månad sedan
..
.env.example daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; 1 månad sedan
README.md daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; 1 månad sedan
config.example.yaml daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; 1 månad sedan
requirements.txt daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; 1 månad sedan
server.py abd9fbdac0 1. 实现了结构化数据 Text2SQL RAG 检索能力,新增 Schema 画像、关系发现、查询上下文构建与 SQL 结果修复链路; 1 månad sedan
test_server.py daf96216ee 1. 实现了统一 RAG 检索编排,支持文档、知识库、结构化数据与知识图谱多源召回; 1 månad sedan

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