Acelerador de RAG hospedado no Azure que usa seus documentos como base para um assistente de chat e responde com citações inline das fontes.
Azure-Samples/rag-postgres-openai-python
Aplicativo de chat RAG que responde a perguntas em linguagem natural sobre linhas de uma tabela PostgreSQL, usando busca com pgvector e modelos da OpenAI, com implantação no Azure.
- Estrelas
- 508
- Forks
- 1,060
- Issues abertas
- 63
- Último commit
- há 22 horas
O que é?
Este projeto é um aplicativo de chat web que responde a perguntas sobre as linhas de uma tabela em um banco de dados PostgreSQL. Ele conta com um frontend em React e FluentUI e um backend em Python com FastAPI. A recuperação de dados combina busca vetorial com pgvector e busca de texto completo do PostgreSQL, mesclando as duas listas de resultados com Reciprocal Rank Fusion (RRF).
As perguntas dos usuários podem ser convertidas em condições de filtro de consulta por meio do function calling da OpenAI. Assim, uma pergunta como "Equipamentos de escalada por menos de US$ 30?" se transforma em uma cláusula SQL WHERE sobre o preço. Os embeddings das consultas são gerados pela API de embeddings da OpenAI.
O projeto foi desenvolvido para ser implantado no Azure com o Azure Developer CLI. O app é executado no Azure Container Apps, o banco de dados no Azure Database for PostgreSQL Flexible Server e os modelos no Azure OpenAI, com autenticação por identidade gerenciada. Também é possível executá-lo localmente com modelos do OpenAI.com ou do Ollama.
Recursos principais
- 01Busca híbrida que combina busca vetorial com pgvector e busca de texto completo do PostgreSQL por meio de RRF
- 02O function calling da OpenAI converte consultas em linguagem natural em condições de filtro SQL
- 03Embeddings das consultas gerados pela API de embeddings da OpenAI
- 04Implantação no Azure Container Apps e no Azure Database for PostgreSQL Flexible Server com azd
- 05Compatível com Azure OpenAI, OpenAI.com e Ollama como provedores de modelos
Casos de uso
- Criar um chat de perguntas e respostas sobre um catálogo de produtos armazenado no PostgreSQL
- Prototipar aplicações RAG sobre dados de tabelas relacionais no Azure
- Aprender a combinar busca híbrida com pgvector e function calling de LLM
Início rápido
- 1
Baixe o código do projeto com azd
azd init -t rag-postgres-openai-python - 2
Entre na sua conta do Azure
azd auth login - 3
Provisione os recursos e implante o código
azd up
Antes de usar
- A opção prevista é implantar no Azure, o que gera custos conforme o uso para Container Apps, Azure OpenAI, PostgreSQL e Azure Monitor.
- O README recomenda fazer a implantação primeiro, pois o desenvolvimento local depende de modelos da OpenAI que você precisa configurar por conta própria.
Em coleções
Tópicos
Perguntas frequentes
- O que é rag-postgres-openai-python?
- Aplicativo de chat RAG que responde a perguntas em linguagem natural sobre linhas de uma tabela PostgreSQL, usando busca com pgvector e modelos da OpenAI, com implantação no Azure. Este projeto é um aplicativo de chat web que responde a perguntas sobre as linhas de uma tabela em um banco de dados PostgreSQL. Ele conta com um frontend em React e FluentUI e um backend em Python com FastAPI. A recuperação de dados combina busca vetorial com pgvector e busca de texto completo do PostgreSQL, mesclando as duas listas de resultados com Reciprocal Rank Fusion (RRF).
- rag-postgres-openai-python é gratuito? Qual é a licença?
- rag-postgres-openai-python é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- rag-postgres-openai-python ainda é mantido?
- Manutenção ativa. O último commit de rag-postgres-openai-python foi em 6 de nov. de 2026.
- Para que posso usar rag-postgres-openai-python?
- Criar um chat de perguntas e respostas sobre um catálogo de produtos armazenado no PostgreSQL Prototipar aplicações RAG sobre dados de tabelas relacionais no Azure Aprender a combinar busca híbrida com pgvector e function calling de LLM
- Como instalar rag-postgres-openai-python?
- Baixe o código do projeto com azd: azd init -t rag-postgres-openai-python Entre na sua conta do Azure: azd auth login Provisione os recursos e implante o código: azd up
- Onde consigo rag-postgres-openai-python?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Azure-Samples/rag-postgres-openai-python
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Acelerador de solução baseado no Azure que analisa dados de conversas e documentos com IA generativa, oferecendo exploração por chat e dashboards de insights gerados automaticamente.
Um acelerador de referência baseado no Azure, no qual vários agentes de IA especializados planejam e executam tarefas organizacionais definidas pelo usuário, usando Microsoft Agent Framework e Azure AI Foundry.
Toolkit em Python para Retrieval-Augmented Generation que armazena e pesquisa documentos no DuckDB ou PostgreSQL.
Um app de chat web em Python que chama o Azure OpenAI com identidade gerenciada e é provisionado e implantado no Azure Container Apps via azd.
Uma base de conhecimento em Rust auto-hospedada que cria um grafo de conhecimento bitemporal a partir de documentos, com busca RAG, raciocínio orientado por ontologias e acesso via MCP para agentes.