langchain_data_agent — NL2SQL Data Agent CLI

Main

Practical guardrails for NL2SQL agents

Use read-only credentials until you have eval coverage, and log generated SQL + result shape for audits.

README excerpt (verbatim)

+  ╔╦╗╔═╗╔╦╗╔═╗  ╔═╗╔═╗╔═╗╔╗╔╔╦╗
+   ║║╠═╣ ║ ╠═╣  ╠═╣║ ╦║╣ ║║║ ║
+  ═╩╝╩ ╩ ╩ ╩ ╩  ╩ ╩╚═╝╚═╝╝╚╝ ╩

[ Natural Language → SQL Query Agent ]

A natural language to SQL (NL2SQL) platform built on LangGraph and Azure OpenAI. This multi-agent system automatically routes user questions to the appropriate database backend and generates optimized SQL queries and results.

Built on top of LangChain's SQLDatabase with extended support for Azure AD authentication, Cosmos DB, and built-in dialect validation.

Features

• Multi-Database Support: PostgreSQL, Azure SQL, Azure Synapse, Azure Cosmos DB, Databricks SQL, and Google BigQuery
• Intent Detection: Automatically routes queries to the correct data agent based on question context
• Multi-Turn Conversations: Follow-up questions with context awareness (e.g., "What's the average?" after a query)
• SQL Validation: Safe query execution with sqlglot-based validation across all dialects
• Data Visualization: Generate charts and graphs from query results using natural language (e.g., "show me a bar chart")
• Configurable Agents: YAML-based configuration for adding new data sources
• A2A Protocol: Agent-to-Agent interoperability for integration with other A2A-compliant systems

Architecture

Intent Detection Flow

Routes user questions to the appropriate data agent based on context.

Data Agent Flow

Generates, validates, and executes SQL queries with retry logic.

Documentation

• Database Setup
• Configuration
• Data Visualization
• A2A Protocol