LangStudio 智能SQL生成助手应用流将自然语言问题转化为 SQL 并执行,返回数据库查询结果,无需 SQL 知识即可查询数据库。模板基于阿里云 RDS MySQL,适用于金融、教育、医疗等需要快速数据查询的场景。
背景信息
智能SQL生成助手应用流将自然语言问题转化为 SQL 并执行,用户无需了解 SQL 即可查询数据库。模板集成阿里云 RDS MySQL,适用于金融、教育、医疗等需要快速数据查询的场景,开发者可按需扩展定制。
前提条件
智能SQL生成助手应用流支持使用阿里云RDS MySQL数据库,您需要先完成数据库的创建。具体操作,请参见云数据库RDS-操作指南。
1. (可选)部署LLM模型
智能SQL生成助手应用流需要用到LLM模型服务,若您已有符合要求的模型服务,且服务支持OpenAI API,则可跳过此步骤,直接使用现有服务。本文以大模型DeepSeek-R1为例,您可以前往快速开始 > ModelGallery进行部署。更多部署详情,请参见一键部署DeepSeek-V4、DeepSeek-R1模型、模型部署及训练。
2. 创建连接
2.1 创建LLM服务连接
本文创建的LLM模型服务连接基于快速开始 > Model Gallery中部署的模型服务(EAS服务)。更多其他类型的连接及详细说明,请参见连接配置。
进入LangStudio,选择工作空间后,单击进入LangStudio。在连接 > 模型服务页签下单击新建连接,创建通用LLM模型服务连接。
关键参数说明:
参数 | 说明 |
模型名称 | 当通过Model Gallery进行模型部署时,可通过模型详情页(在Model Gallery页单击模型卡片)查看模型名称的获取方法,详情请参见创建连接-模型服务。 |
服务提供方 |
|
2.2 创建数据库连接
在连接 > 数据库页签下单击新建连接,创建RDS MySQL数据库连接。
关键参数说明:
参数 | 说明 |
host/port | 获取host(内网地址)和port(内网端口),请参见查看和管理实例连接地址和端口。 |
database | 创建数据库时设置的数据库名称。 |
username/password | 创建数据库账号时设置的账号和密码。 |
3. 创建并运行应用流
进入LangStudio,选择工作空间后,单击进入LangStudio。在应用流页签下单击新建应用流,创建智能SQL生成助手应用流。
启动运行时:单击右上角选择运行时并在下拉列表中选择已创建的运行时。如果没有可选的运行时,您可以在大模型应用开发(LangStudio)页面的运行时页签创建。请注意:专有网络配置需选择前提条件中创建RDS MySQL实例时的专有网络,或确保已选的专有网络和RDS MySQL实例所在的专有网络已经互通。
重要在进行Python节点解析或查看更多工具时,需要保证运行时已启动。
开发应用流。

应用流中的其余配置保持默认或根据实际需求进行配置,关键节点配置如下:
获取创建表的DDL:获取并生成数据库表的基本信息(DDL语句)。
connection_name:输入2.2 创建数据库连接中创建的连接名称。请确保输入的名称与已创建的连接名称完全一致。
大模型节点:将用户问题以及上述DDL节点生成的数据库表信息传递给大语言模型,生成SQL代码。
模型设置:选择2.1 创建LLM服务连接中创建的连接。
对话历史:是否启用对话历史,将历史对话信息作为输入变量。
执行SQL:执行大语言模型节点返回的SQL,并返回查询结果。
connection_name:输入2.2 创建数据库连接中创建的连接名称。请确保输入的名称与已创建的连接名称完全一致。
关于各节点组件详情,请参见预置组件说明。
调试/运行:单击右上角运行,开始执行应用流。关于应用流运行时的常见问题,请参见常见问题。
运行结果示例:用户输入查询请求"请帮我查询一下 gender=Male 时的全部员工信息",系统自动生成 SQL 语句
SELECT * FROM employees WHERE gender = 'Male',执行后返回 employees 表中所有 gender 为 Male 的记录(包含 id、gender、age、hire_date、position 等字段)。查看链路:单击生成答案下的查看链路,查看Trace详情或拓扑视图。
在 Trace 详情 页面,可查看完整调用链路的瀑布图,包括各 Span 的耗时和层级关系。单击瀑布图中的某个 Span(如 nl2sql-pfchen-001),右侧 Span 详情 面板将展示该 Span 的应用名、接口名、spanId、状态码等信息,以及输入输出数据(如
chat_history中的用户问题和final_data中生成的 SQL 语句)。
4. 部署应用流
在应用流开发页面,单击右上角部署,将应用流部署为EAS服务。部署参数其余配置保持默认或根据实际需求进行配置,关键参数配置如下:
资源部署 > 实例数:配置服务实例数。本文部署仅供测试使用,因此实例数配置为1。在生产阶段,建议配置多个服务实例,以降低单点故障的风险。
专有网络 > VPC:配置RDS MySQL实例所在的专有网络,或确保已选的专有网络和RDS MySQL实例所在的专有网络已经互通。
更多部署详情,请参见应用流部署。
5. 调用服务
部署成功后,跳转到PAI-EAS,在在线调试页签下配置并发送请求。请求Body中的Key与应用流中“开始节点”中的参数"对话输入"字段一致,本文使用默认字段question。
在在线调试页签下,请求 Body 中填写 JSON 内容 {"question": "请帮我查询一下 gender=Male 时的全部员工信息"},单击发送请求后,右侧响应区域返回 Status Code: 200,响应 Body 中包含系统自动生成的 SQL 语句 SELECT * FROM employees WHERE gender = 'Male' 及对应的员工查询结果数据。
更多调用方式(如API调用)及详细说明,请参见应用流部署-调用服务。