
rag-postgres-openai-python
用大白话问数据库表,直接出答案还带出处
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 512
使用教程
环境要求
- Python 3.10+
- Node.js
- PostgreSQL
- 模型凭据
安装与启动步骤
-
1装后端依赖
前后端分开装。
pip install -r requirements-dev.txt -
2以可编辑方式装后端
这样才能改代码生效。
python -m pip install -e src/backend -
3初始化数据库
先建表再灌示例数据。
python ./src/backend/fastapi_app/setup_postgres_database.py -
4灌示例数据
没有数据问不出东西。
python ./src/backend/fastapi_app/setup_postgres_seeddata.py -
5起前后端
两个进程都要跑。
python -m uvicorn fastapi_app:create_app --factory --reload
如何确认成功
起服务后能在网页里提问,回答基于数据库表中的真实行且能在回答里看到引用的字段
注意事项
- 它演示的是让模型对关系库里的表行做问答,前后端都齐。
- 做法是把表结构与示例行转成检索上下文,不是让模型直接写查询。
- 初始化脚本要按顺序跑,先建表再灌数据。
- 示例数据量小,换真实库要先评估检索成本。
核心亮点
- 开箱即用的 azd 模板,一条命令部署到 Azure Container Apps + PostgreSQL Flexible Server,省去手工配环境
- 检索结果带引用溯源,回答里能点开看到是哪几行数据支撑的,方便核对
- 用 pgvector 做向量检索,和业务表放在同一个 PostgreSQL 里,不用额外维护向量数据库
不足之处
- 强绑定 Azure OpenAI 和 Azure 容器服务,换到其他云或本地模型需要改不少代码
- 示例数据规模小,没有给出大数据量下的索引调优和性能测试参考
适用场景
- 企业内部把产品、订单等业务表做成自然语言问答入口
- 快速搭建一个带引用溯源的 RAG 原型验证想法
- 作为教学示例学习 FastAPI + pgvector + Azure OpenAI 的完整链路
替代项目
langchain-postgres、pgvector-python
上一篇:HippoRAG
同类项目推荐
ragapp
开源
拖拽式搭建企业级智能问答,让 RAG 应用即插即用
The easiest way to use Agentic RAG in any enterprise
Educational_RAG_System
开源
教育问答一步到位:精准检索+流式回答
End-to-end educational RAG system: dual-engine retrieval (BM25 + BGE-M3 hybrid vecto···
search2ai
开源
给大模型插上联网搜索,实时问答不求人
Self-hosted search gateway for AI agents. Unified search, news and page extraction w···
my-rag
开源
导入文档建知识库,自然语言问答带权限隔离
我的rag系统,可以用于导入知识库进行知识问答,可集成第三方mcp,也做了权限隔离等
akb
开源
给 AI 智能体一个可检索、可共享的组织记忆库
AKB — Agent Knowledgebase. Organizational memory for AI agents: vault-scoped docs /···
awesome-prompt-engineering
开源
一页清单收齐提示工程工具论文平台,快速入门不迷路
A curated list of resources, tools, papers, and platforms for prompt engineering in ···
bkmr
开源
本地优先的语义书签管理,让人类和 AI 代理都能快速检索知识。
Knowledge Management for Humans and Agents
coco-app
开源
搜索记录协作一屏搞定,不再来回切换
Coco AI App - Search, Connect, Collaborate, Personal AI Search and Assistant, all in···
Awesome-Text2SQL
开源
一站式搞定自然语言转SQL,从入门到实战资源全在这
Curated tutorials and resources for Large Language Models, Text2SQL, Text2DSL、Text···