Repolode
Azure-Samples

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. 1

    Baixe o código do projeto com azd

    azd init -t rag-postgres-openai-python
  2. 2

    Entre na sua conta do Azure

    azd auth login
  3. 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