対話型Text-to-SQLによるデータ分析とプロット生成 - n8n ワークフロー

この高度なn8nワークフローは、自然言語によるリクエストをPostgreSQLに対する実行可能なSQLクエリに変換します。AIエージェントやメモリを含む複数のn8nノードステップを使用し、可視化のための構造化データを提供します。強力なn8nテンプレートです。

ワークフロープレビュー

自動化の準備はいいですか?

このn8nワークフローテンプレートをダウンロードして、今すぐ使い始めましょう。

こんな方におすすめ


  • 手動でSQLを書かずにデータベースを照会したいデータアナリストおよびBI(ビジネスインテリジェンス)ユーザー。

  • 対話型のデータインタラクションツールを構築する開発者。

  • n8nワークフロー内でのAIエージェントの連鎖やデータ処理の高度な例を探しているn8nスペシャリスト。

  • Text-to-SQL自動化のための堅牢なn8nテンプレートソリューションを求めるすべての人。

概要

「対話型Text-to-SQL」n8nワークフローは、自然言語による対話と構造化されたデータベースクエリの橋渡しという複雑な問題を解決します。大規模言語モデル(LLM)とPostgreSQLの機能を統合することにより、ユーザーはこのn8nワークフローでデータについて質問するだけでよくなります。まず、ワークフローはセットアップ時にデータベーススキーマのメタデータをインテリジェントに抽出します。ユーザーが専用のn8nトリガー経由でクエリを送信すると、主要なAIエージェントがテキストを正確なSQLクエリに変換します。このクエリはデータベースに対して実行され、その結果は2番目のAIエージェントに渡されます。この2番目のエージェントはクエリ結果を処理し、可視化(曲線やプロットなど)に適した構造化された出力を生成します。このデュアルエージェントアプローチにより、正確なデータ取得と、それに続く意味のある可視化指示の両方が保証され、このn8nノード構成は非常に強力になります。

仕組み

この強力な自動化は、「セットアップ」と「実行」という2つの明確なフェーズで動作します。

セットアップフェーズ(手動トリガー)


  1. n8nワークフローは、「ワークフローをテスト」クリック時のn8nトリガーで開始され、スキーマ抽出プロセスが開始されます。

  2. データベース内の全テーブルを一覧表示およびスキーマ抽出器のn8nノードステップがPostgreSQLに接続し、メタデータを取得します。

  3. このメタデータは整形され、JSONに変換され、ローカルにファイルを保存n8nノード経由でローカルに保存され、AIエージェントに必要なコンテキストが作成されます。

実行フェーズ(チャットトリガー)


  1. チャットトリガーn8nトリガーノードがユーザー入力(自然言語クエリ)を待ち受けます。

  2. 事前に保存されたデータベーススキーマがロードされ、スキーマデータとチャット入力を結合n8nノードを使用してチャット入力と結合されます。

  3. 結合された入力とスキーマは、ウィンドウバッファメモリn8nノードによって提供される会話履歴と共に、AIエージェント(Deepseek-chat搭載)に供給されます。

  4. AIエージェントがリクエストを処理し、生成されたSQLクエリを含む構造化された応答を出力します。

  5. SQLクエリを抽出n8nノードがSQL文字列を分離します。

  6. If(もしも)n8nノード(クエリの存在を確認)がSQL出力を検証します。有効であれば、最終SQL結果Postgres n8nノードがクエリを実行します。

  7. 生のデータ結果が整形され、2次的なプロットエージェントn8nノードに渡されます。

  8. プロットエージェントは、Deepseek-chat LLMと構造化出力パーサーを使用して、表形式データを構造化されたプロット指示(例:JSONデータポイントや曲線定義)に変換します。

  9. 最後に、最終出力を準備n8nノードによって結果がマージ・準備され、ユーザーにクエリ結果情報と可視化データの両方が提供されます。

インストールガイド

この包括的なn8nワークフローをデプロイするには、次の手順に従ってください。


  1. n8nワークフローのインポート: 提供されたJSONデータをコピーし、ワークフロータブから直接n8nインスタンスにインポートします。「新規」ボタンを使用し、「JSONからインポート」を選択してください。

  2. 認証情報の設定:

PostgreSQL: テーブルを一覧表示スキーマ抽出器、および最終SQL結果の各n8nノードインスタンスに対してPostgreSQLの認証情報を設定する必要があります。認証情報が関連するデータベースへの読み取りアクセス権を持っていることを確認してください。
AI/LLM: Deepseek-chatのn8nノードインスタンスの認証情報を設定します(または、OpenAI互換のLLM接続に置き換え、APIキーが有効であることを確認してください)。

  1. 初期スキーマ設定: チャットトリガーを使用する前に、「ワークフローをテスト」クリック時n8nトリガーを使用して、上流のフローを一度実行してください。これにより、スキーマ抽出n8nノードシーケンスが実行され、AIエージェントがアクセスするために必要なスキーマファイルがローカルに保存されます。

  2. ワークフローの有効化: 主要なチャットトリガーが有効になっていることを確認してください(Webhook URLが表示されるはずです)。

  3. テスト: チャットトリガーにリンクされたチャットインターフェースを使用して、データベースに対する対話形式のクエリをテストします。

ノード詳細

チャットトリガー (n8nトリガー): 対話型入力の主要なエントリーポイントです。このn8nトリガーは、外部チャットインタラクションに基づいてプロセス全体を開始します。
Deepseek-chat (LLM): 主要なAIエージェントが複雑なText-to-SQL翻訳を実行するために使用する中核となるLLMエンジンです。
AIエージェント (LangChain n8nノード): Deepseek LLM、ロードされたデータベーススキーマ、およびウィンドウバッファメモリを活用して、正確なSQLクエリを策定する意思決定プロセスを調整します。
Postgres (n8nノード): 3つの主要な場所で使用されます。


  1. 最初にすべてのテーブルと列のスキーマを抽出するため。

  2. AIによって生成されたSQLクエリ(最終SQL結果)を実行するため。

クエリの存在を確認 (If n8nノード): 重要なフロー制御ステップ。主要なAIエージェントが有効なクエリ文字列を正常に生成した場合にのみ、後続のデータベース実行が行われることを保証します。
プロットエージェント (LangChain n8nノード): 実行されたSQLから得られた結果データを受け取り、視覚的表現に適した構造化JSONに変換する専門の二次エージェントです。確実な出力形式のために構造化出力パーサーn8nノードを使用します。

  • ウィンドウバッファメモリ (LangChain n8nノード): 会話のコンテキストを維持し、このn8nワークフローの現在のセッション内でのフォローアップ質問をAIエージェントが理解できるようにします。

関連するn8nワークフロー

有料

ノード: 15 ノード
更新済み: 12月 26 2025
すべて表示
作成者
hippolyte-hu
hippolyte-hu

特徴*