data-agent-tutorial

手把手教你从零打造能查数据库的 Text2SQL 智能体

这是一个从零开始构建 Text2SQL 智能体的实战教程项目，基于 Kotlin 语言实现。它解决的核心问题是：如何将自然语言查询准确转换为 SQL 并安全执行。项目提供了完整的实现路径，涵盖 StateGraph 状态编排、双重 RAG（检索增强生成）来提升表结构理解和查询生成准确性、关系图谱辅助理解数据库 schema、HITL（人工确认）机制确保关键操作可控、SQL 自动纠错功能提升鲁棒性，以及 Python Docker 沙盒执行环境保障查询安全。此外，还实现了 A2A 协议与 SSE 流式交互，支持智能体间的通信和实时响应。作为教程，它强调实战，代码结构清晰，适合希望深入理解 Text2SQL 智能体架构的开发者学习参考。