rag-postgres-openai-python

用大白话问数据库表,直接出答案还带出处

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 搜索知识 🍴 复刻 1060 🐛 待处理 64 👀 关注 117
GitHub ↗
GitHub 星标 ★ 512
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费,需自部署,Azure服务费用另计

项目预览

rag-postgres-openai-python 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类搜索知识
开发团队Azure-Samples
定价模式🏷️完全免费
价格说明开源免费,需自部署,Azure服务费用另计
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言Python
技术栈/模型ai-azd-templates,azd-templates,azure-container-apps,azure-openai,containers,fastapi,openai,pgvector,postgres,postgresql,python
GitHub 星标★ 512
上线时间2024-05-14 00:00:00
代码更新2026-11-14
仓库体积8.2 MB
本站数据更新2026-11-15
维护状态活跃
收录时间2026-10-02
浏览次数1

项目介绍

这是一个基于 Python 的 RAG 示例应用,用于对数据库表中的行进行自然语言问答。它把 PostgreSQL(配合 pgvector 扩展)作为向量存储,用 Azure OpenAI 生成嵌入和回答,后端用 FastAPI 提供接口,前端是简单的聊天页面。项目解决的是「让业务数据表变得可对话」的问题:用户不用写 SQL,直接用中文或英文提问,系统会先检索相关行,再让大模型基于检索结果生成答案,并附上引用来源。核心能力包括:自动把表数据向量化并存入 pgvector、混合检索(向量+关键词)、流式回答、引用溯源,以及通过 azd 模板一键部署到 Azure Container Apps 和 PostgreSQL Flexible Server。适合作为企业内数据问答的起步模板,也方便二次开发成自己的 RAG 应用。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-02 · 当前星标 ★ 512

使用教程

难度:进阶 约 70 分钟 部署方式:本地构建 5 步

环境要求

  • Python 3.10+
  • Node.js
  • PostgreSQL
  • 模型凭据

安装与启动步骤

  1. 1装后端依赖

    前后端分开装。

    pip install -r requirements-dev.txt
  2. 2以可编辑方式装后端

    这样才能改代码生效。

    python -m pip install -e src/backend
  3. 3初始化数据库

    先建表再灌示例数据。

    python ./src/backend/fastapi_app/setup_postgres_database.py
  4. 4灌示例数据

    没有数据问不出东西。

    python ./src/backend/fastapi_app/setup_postgres_seeddata.py
  5. 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

下一篇:CORTEX-AI-SUPER-RAG

同类项目推荐

ragapp 开源

拖拽式搭建企业级智能问答,让 RAG 应用即插即用

The easiest way to use Agentic RAG in any enterprise

★ 4441 2026-08-09
Educational_RAG_System 开源

教育问答一步到位:精准检索+流式回答

End-to-end educational RAG system: dual-engine retrieval (BM25 + BGE-M3 hybrid vecto···

★ 34 2026-08-09
search2ai 开源

给大模型插上联网搜索,实时问答不求人

Self-hosted search gateway for AI agents. Unified search, news and page extraction w···

★ 1288 2026-09-16
my-rag 开源

导入文档建知识库,自然语言问答带权限隔离

我的rag系统,可以用于导入知识库进行知识问答,可集成第三方mcp,也做了权限隔离等

★ 157 2026-10-25
akb 开源

给 AI 智能体一个可检索、可共享的组织记忆库

AKB — Agent Knowledgebase. Organizational memory for AI agents: vault-scoped docs /···

★ 168 2026-09-12
awesome-prompt-engineering 开源

一页清单收齐提示工程工具论文平台,快速入门不迷路

A curated list of resources, tools, papers, and platforms for prompt engineering in ···

★ 255 2026-09-15
bkmr 开源

本地优先的语义书签管理,让人类和 AI 代理都能快速检索知识。

Knowledge Management for Humans and Agents

★ 268 2026-08-09
coco-app 开源

搜索记录协作一屏搞定,不再来回切换

Coco AI App - Search, Connect, Collaborate, Personal AI Search and Assistant, all in···

★ 728 2026-08-09
Awesome-Text2SQL 开源

一站式搞定自然语言转SQL,从入门到实战资源全在这

Curated tutorials and resources for Large Language Models, Text2SQL, Text2DSL、Text···

★ 3783 2026-08-09