자체 문서를 바탕으로 답변하고 출처를 인라인 인용으로 표시하는 Azure 호스팅 RAG 가속기입니다.
Azure-Samples/rag-postgres-openai-python
pgvector 검색과 OpenAI 모델을 사용해 PostgreSQL 테이블의 행에 관한 자연어 질문에 답하고 Azure에 배포할 수 있는 RAG 채팅 앱입니다.
- 스타
- 508
- 포크
- 1,060
- 열린 이슈
- 63
- 마지막 커밋
- 어제
어떤 프로젝트인가요?
PostgreSQL 데이터베이스 테이블의 행에 관한 질문에 답하는 웹 기반 채팅 애플리케이션입니다. React와 FluentUI 프런트엔드, Python FastAPI 백엔드로 구성되어 있습니다. 검색 시 pgvector 벡터 검색과 PostgreSQL 전문 검색을 함께 사용하고, Reciprocal Rank Fusion(RRF)으로 두 결과 목록을 병합합니다.
OpenAI function calling을 통해 사용자 질문을 쿼리 필터 조건으로 변환할 수 있습니다. 예를 들어 "30달러보다 저렴한 등산 장비?"라는 질문은 가격에 대한 SQL WHERE 절로 변환됩니다. 쿼리 임베딩은 OpenAI embedding API로 생성합니다.
Azure Developer CLI를 사용해 Azure에 배포하도록 설계된 프로젝트입니다. 앱은 Azure Container Apps에서, 데이터베이스는 Azure Database for PostgreSQL Flexible Server에서, 모델은 Azure OpenAI에서 실행되며 인증에는 managed identity를 사용합니다. OpenAI.com 또는 Ollama 모델을 사용해 로컬에서 실행할 수도 있습니다.
핵심 기능
- 01RRF를 통해 pgvector 벡터 검색과 PostgreSQL 전문 검색을 결합하는 하이브리드 검색
- 02OpenAI function calling으로 자연어 쿼리를 SQL 필터 조건으로 변환
- 03OpenAI embedding API를 사용해 쿼리 임베딩 생성
- 04azd를 통해 Azure Container Apps 및 Azure PostgreSQL Flexible Server에 배포
- 05모델 제공자로 Azure OpenAI, OpenAI.com, Ollama 지원
활용 사례
- PostgreSQL에 저장된 제품 카탈로그를 대상으로 질의응답 채팅 구축
- Azure에서 관계형 테이블 데이터를 대상으로 RAG 프로토타이핑
- pgvector 하이브리드 검색과 LLM function calling을 결합하는 방법 학습
빠른 시작
- 1
azd로 프로젝트 코드를 다운로드합니다
azd init -t rag-postgres-openai-python - 2
Azure 계정에 로그인합니다
azd auth login - 3
리소스를 프로비저닝하고 코드를 배포합니다
azd up
사용 전 알아둘 점
- Azure에 배포하는 것이 권장되는 사용 방식이며, Container Apps, Azure OpenAI, PostgreSQL, Azure Monitor 사용에는 종량제 비용이 발생합니다.
- README에서는 먼저 배포할 것을 권장합니다. 로컬 개발은 직접 구성해야 하는 OpenAI 모델에 의존하기 때문입니다.
포함된 컬렉션
토픽
자주 묻는 질문
- rag-postgres-openai-python은(는) 무엇인가요?
- pgvector 검색과 OpenAI 모델을 사용해 PostgreSQL 테이블의 행에 관한 자연어 질문에 답하고 Azure에 배포할 수 있는 RAG 채팅 앱입니다. PostgreSQL 데이터베이스 테이블의 행에 관한 질문에 답하는 웹 기반 채팅 애플리케이션입니다. React와 FluentUI 프런트엔드, Python FastAPI 백엔드로 구성되어 있습니다. 검색 시 pgvector 벡터 검색과 PostgreSQL 전문 검색을 함께 사용하고, Reciprocal Rank Fusion(RRF)으로 두 결과 목록을 병합합니다.
- rag-postgres-openai-python은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- rag-postgres-openai-python은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- rag-postgres-openai-python은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. rag-postgres-openai-python의 마지막 커밋은 2026년 11월 6일입니다.
- rag-postgres-openai-python은(는) 어디에 사용할 수 있나요?
- PostgreSQL에 저장된 제품 카탈로그를 대상으로 질의응답 채팅 구축 Azure에서 관계형 테이블 데이터를 대상으로 RAG 프로토타이핑 pgvector 하이브리드 검색과 LLM function calling을 결합하는 방법 학습
- rag-postgres-openai-python는 어떻게 설치하나요?
- azd로 프로젝트 코드를 다운로드합니다: azd init -t rag-postgres-openai-python Azure 계정에 로그인합니다: azd auth login 리소스를 프로비저닝하고 코드를 배포합니다: azd up
- rag-postgres-openai-python은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/Azure-Samples/rag-postgres-openai-python
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
생성형 AI로 대화 및 문서 데이터를 분석하고, 채팅 탐색과 자동 생성 인사이트 대시보드를 제공하는 Azure 기반 솔루션 액셀러레이터입니다.
Microsoft Agent Framework와 Azure AI Foundry를 기반으로 여러 전문 AI 에이전트가 사용자가 지정한 조직 업무를 계획하고 실행하는 Azure 기반 레퍼런스 액셀러레이터입니다.
DuckDB 또는 PostgreSQL에 문서를 저장하고 검색하는 Retrieval-Augmented Generation용 Python 툴킷입니다.
managed identity를 사용해 Azure OpenAI를 호출하고 azd로 Azure Container Apps에 배포하는 Python 채팅 웹 앱입니다.
문서에서 이중 시간 지식 그래프를 구축하고 RAG 검색, 온톨로지 기반 추론, 에이전트용 MCP 접근을 지원하는 셀프 호스팅 Rust 지식 베이스