Interface de Chat para Consulta de Base de Dados PostgreSQL - Fluxo de trabalho n8n

Analistas de negócio que necessitam de insights rápidos sobre dados sem escrever SQL complexo.
Engenheiros de Dados à procura de modelos eficientes do n8n para arquiteturas RAG avançadas.
Programadores interessados em implementar agentes de IA personalizados e poderosos usando o ecossistema especializado de nós do n8n.
Utilizadores que procuram uma solução de fluxo de trabalho n8n robusta para recuperação complexa de dados e relatórios.

Este fluxo de trabalho avançado do n8n transforma perguntas em linguagem natural em consultas SQL funcionais, executadas contra uma base de dados PostgreSQL. Resolve o desafio de necessitar de conhecimento especializado em SQL para recuperação de dados, alavancando um Agente de Funções da OpenAI. Este fluxo de trabalho específico do n8n utiliza múltiplas ferramentas especializadas (nós do n8n para Postgres) para garantir que o SQL gerado seja preciso, tenha conhecimento do esquema e seja contextualmente relevante. Ao combinar as capacidades de conversação do conjunto de nós LangChain no n8n com ferramentas robustas de ligação à base de dados, esta automação fornece uma aplicação contínua e poderosa da plataforma n8n para tarefas complexas centradas em dados. Este modelo pronto a usar do n8n reduz drasticamente o tempo de desenvolvimento para implementar funcionalidades de chat com a base de dados.

Este fluxo de trabalho abrangente do n8n alavanca o poder dos agentes LangChain e da integração PostgreSQL para criar uma ferramenta de análise de dados conversacional.

1. Iniciação (Gatilho n8n): O processo começa com o gatilho do n8n When chat message received (Quando a mensagem de chat é recebida). Isto inicia a conversa sempre que um utilizador envia uma mensagem para a interface de chat ou webhook definidos.


2. Orquestração (Nó de Agente de IA n8n): A mensagem do utilizador é passada para o nó AI Agent do n8n, configurado como um Agente de Funções da OpenAI (OpenAI Functions Agent). Este agente analisa o pedido, referencia o nó Chat History (Histórico de Chat) do n8n para contexto conversacional e determina o curso de ação necessário com base nas suas instruções de sistema (atuando como assistente de BD).


3. Utilização de Ferramentas: O agente seleciona um dos três nós especializados do n8n para PostgreSQL (ferramentas) para recolher informações ou executar ações:

1. Execução dos Dados: O nó do n8n PostgreSQL executa a consulta SQL contra a base de dados conectada. Os resultados são então devolvidos ao AI Agent.


2. Geração de Resposta: Usando os dados obtidos e o raciocínio fornecido pelo nó conectado OpenAI Chat Model (Modelo de Chat da OpenAI) do n8n, o agente formula uma resposta concisa em linguagem natural, completando o ciclo e enviando a resposta de volta ao utilizador através do mecanismo de gatilho inicial do n8n.

Para implementar este poderoso fluxo de trabalho do n8n, siga estes passos:

1. Importar: Copie o código JSON fornecido e cole-o na sua instância do n8n usando a função 'Import from JSON' (Importar de JSON).


2. Credenciais do PostgreSQL: Localize os nós do n8n Execute SQL Query, Get DB Schema and Tables List e Get Table Definition. Deve atualizar as credenciais PostgreSQL associadas (por exemplo, 'Your Postgresql Database Credentials') com os detalhes específicos da ligação à sua base de dados.


3. Credenciais da OpenAI: Selecione o nó OpenAI Chat Model do n8n e ligue as suas credenciais de API da OpenAI. Este nó n8n requer acesso para usar modelos como o gpt-4o-mini.


4. Configuração: Reveja a mensagem de sistema do nó AI Agent do n8n para garantir que a persona e as instruções estão alinhadas com as suas necessidades operacionais.


5. Ativação: Assim que as credenciais estiverem configuradas, ative o fluxo de trabalho do n8n. Pode agora usar o webhook fornecido pelo gatilho do n8n When chat message received para começar a conversar com a sua base de dados.

When chat message received (gatilho n8n): Este é o ponto de entrada do gatilho da automação no n8n. Função: Escuta as mensagens de chat recebidas para iniciar o processo de consulta da base de dados. Configuração Chave: Utiliza um webhook para lidar com a entrada e saída do chat.
AI Agent (nó n8n): A unidade de controlo central que utiliza o openAiFunctionsAgent. Função: Orquestra todo o processo—interpretando a intenção do utilizador, gerindo o prompt do sistema (Assistente de BD) e chamando a ferramenta de nó correta do n8n para Postgres.
OpenAI Chat Model (nó n8n): Fornece a capacidade de modelo de linguagem grande necessária. Função: Potencia a tomada de decisão do agente e a geração de SQL. Configuração Chave: Utiliza o modelo altamente eficiente gpt-4o-mini.
Chat History (nó n8n): Uma implementação de 'Memory Buffer Window'. Função: Mantém o contexto da conversa ao longo de múltiplas interações, permitindo perguntas de seguimento.
Execute SQL Query (nó n8n Postgres): Ferramenta utilizada pelo Agente de IA. Função: Executa a consulta SQL gerada pela IA contra a base de dados PostgreSQL.
Get DB Schema and Tables List (nó n8n Postgres): Ferramenta utilizada pelo Agente de IA. Função: Recupera uma lista de todas as tabelas e esquemas, fornecendo o contexto essencial necessário para a IA gerar SQL preciso e com prefixo de esquema neste fluxo de trabalho do n8n.

• Get Table Definition (nó n8n Postgres): Ferramenta utilizada pelo Agente de IA. Função: Obtém informações detalhadas sobre colunas (tipos, restrições, etc.) para tabelas específicas para ajudar a IA a construir consultas complexas.