Agente SQL de IA com Visualização Dinâmica de Dados usando Quickchart.io - Fluxo de trabalho n8n

• Analistas de Dados e profissionais de Business Intelligence que procuram automatizar a consulta conversacional de dados.


• Equipas que necessitam de representações visuais e dinâmicas dos resultados das consultas à base de dados SQL.


• Programadores que procuram modelos n8n avançados para integrar agentes LangChain e IA generativa (OpenAI) com fontes de dados.


• Utilizadores que procuram um fluxo de trabalho n8n poderoso que lide com árvores de decisão complexas e execução de sub-fluxos de trabalho.

Este poderoso fluxo de trabalho n8n transforma um Agente SQL conversacional padrão numa ferramenta abrangente de visualização de dados. Ao combinar o poder de consulta do Agente SQL LangChain com as capacidades de geração de saída estruturada da OpenAI (especificamente usando gpt-4o e definições de Schema JSON), este modelo n8n decide automaticamente se é necessário um gráfico para apoiar a resposta da consulta à base de dados.

O problema central resolvido é colmatar a lacuna entre os dados brutos retornados por uma consulta SQL e gráficos significativos e fáceis de digerir. O fluxo de trabalho cria dinamicamente a configuração Chart.js necessária e renderiza a imagem usando Quickchart.io, fornecendo uma resposta visual mais rica juntamente com a explicação textual do Agente de IA. Este fluxo de trabalho n8n é altamente eficaz para promover uma análise de dados mais rápida em qualquer equipa.

Este fluxo de trabalho n8n avançado opera num processo conversacional de várias etapas:

1. Acionamento e Extração: O acionador (trigger) do n8n é ativado ao receber uma mensagem de chat através do nó n8n When chat message received. O Extrator de Informação (alimentado por um nó n8n OpenAI Chat Model) limpa a consulta do utilizador, removendo quaisquer instruções explícitas relacionadas com gráficos, garantindo que a questão central chega ao Agente SQL.


2. Execução do Agente SQL: A questão extraída é passada para o nó n8n Agente de IA (configurado como Agente SQL). Este agente liga-se à base de dados PostgreSQL, executa o SQL necessário e fornece uma saída de texto conversacional contendo a análise dos dados. O histórico da conversa é mantido usando o nó n8n Window Buffer Memory.


3. Decisão de Visualização: O nó n8n Classificador de Texto - Gráfico necessário? analisa tanto o pedido original do utilizador como a saída de dados do Agente SQL. Utilizando um Classificador de Modelo de Chat OpenAI, este nó n8n determina se os dados seriam melhor compreendidos com um gráfico (chart_required).


4. Caminho Somente Texto: Se o classificador considerar um gráfico desnecessário (por exemplo, um único ponto de dados), o nó n8n Definir saída de Texto formata a resposta do agente, concluindo a execução do fluxo de trabalho n8n.


5. Caminho de Geração de Gráfico (Sub-fluxo de Trabalho): Se for necessário um gráfico, os dados são passados para um nó n8n Executar Fluxo de Trabalho, que inicia o caminho do sub-fluxo de trabalho de geração de gráficos.


6. Geração de JSON Estruturado: Dentro do sub-fluxo de trabalho, o nó n8n OpenAI - Gerar definição de Gráfico (um Pedido HTTP para a OpenAI) recebe os dados brutos e o pedido do utilizador. Utiliza uma definição de Schema JSON rigorosa para o Chart.js, alavancando a funcionalidade de saída estruturada da OpenAI para gerar um objeto de configuração de gráfico formatado na perfeição.


7. Montagem do URL Quickchart: O nó n8n Definir resposta pega no JSON Chart.js gerado pela OpenAI e insere-o num URL Quickchart.io, criando uma ligação de imagem dinâmica.


8. Saída Final: O nó n8n Definir saída de Texto + Gráfico funde a resposta de texto original do Agente SQL com o URL da imagem Quickchart recém-gerado (formatado como uma ligação de imagem Markdown), fornecendo uma resposta visual rica ao utilizador através deste poderoso modelo n8n.

Para implementar este modelo de fluxo de trabalho n8n específico com sucesso, siga estes passos:

1. Importar o Fluxo de Trabalho n8n: Copie o código JSON fornecido e importe-o diretamente para a sua instância n8n auto-hospedada ou na nuvem.


2. Configurar Credenciais:

1. Preparação da Base de Dados (Se utilizar os dados de exemplo): O exemplo de fluxo de trabalho referencia uma credencial de base de dados 'Coffee Sales Postgres' e foi concebido para consultar dados de um conjunto de dados de vendas de café. Atualize as credenciais da base de dados e o Prefix Prompt dentro do nó n8n AI Agent se o seu esquema for diferente.


2. Ativar o Acionador n8n: Certifique-se de que o nó de acionamento n8n When chat message received está ativo para que o fluxo de trabalho n8n possa escutar as consultas recebidas dos utilizadores. Este fluxo de trabalho n8n está pronto a ser executado.

Este fluxo de trabalho n8n complexo alavanca vários tipos de nós n8n especializados para atingir o seu objetivo:

When chat message received (Acionador n8n):
Função: Inicia a execução do fluxo de trabalho n8n ao receber uma mensagem de utilizador na interface de chat integrada.
Configuração Principal: Configurado como um endpoint de webhook público.
Agente de IA (nó n8n Agente LangChain):
Função: O componente central para a interação com a base de dados. Traduz perguntas em linguagem natural em consultas SQL executáveis, executa-as na base de dados PostgreSQL conectada e formata os resultados de forma conversacional.
Configuração Principal: Utiliza o tipo sqlAgent. Inclui um Prefix Prompt extenso que instrui o modelo a focar-se em retornar respostas, evitar jargão de programador e lidar adequadamente com a sintaxe SQL (por exemplo, aspas para nomes de tabelas).
Classificador de Texto - Gráfico necessário? (nó n8n Classificador de Texto LangChain):
Função: Decide o caminho subsequente do fluxo de trabalho n8n com base no contexto. Classifica a necessidade de visualização.
Configuração Principal: Define duas categorias de saída: chartrequired e chartnotrequired com base em saber se os dados são multidimensionais ou um valor único.
OpenAI - Gerar definição de Gráfico com Saída Estruturada (nó n8n Pedido HTTP):
Função: Este é um passo crucial no fluxo de trabalho n8n. Chama a API da OpenAI (gpt-4o-2024-08-06) e exige explicitamente que o formato da resposta seja um objeto JSON em conformidade com um esquema Chart.js rigoroso. Isto garante que a saída é utilizável pelo Quickchart.io.
Configuração Principal: Utiliza responseformat com um Schema JSON detalhado que define propriedades obrigatórias como type, data e options (incluindo escalas e plugins).
Definir resposta (nó Set n8n):
Função: Constrói o URL final do Quickchart.io ao codificar a saída JSON da definição do gráfico do nó n8n anterior e ao anexá-la ao URL base.
Configuração Principal: Utiliza uma expressão: ="https://quickchart.io/chart?width=200&c=" + encodeURIComponent($json.choices[0].message.content).
Set Text + Chart output (nó Set n8n):
* Função: Funde a resposta de texto original do Agente SQL com o URL da imagem Quickchart recém-gerado (formatado como um link de imagem Markdown), fornecendo uma resposta visual rica ao utilizador através deste poderoso modelo n8n.