文本转 SQL

文本转 SQL 节点（类型 22）把自然语言转成 SQL，可选是否立即执行。常用于问数链路中的「生成查询」一步；业务侧问数仍应优先走授权列表通道，见 智能问数。

入口：在 AI 流程编排 设计器中拖入「文本转SQL」。

节点属性

与设计器属性面板标签一致：

属性	名字	说明
模型	model_id	对话/文本生成模型
提示词	prompt	自然语言问题、表范围与生成约束；可 @ 上游字段
是否执行	is_execute	开：生成后尝试执行；关：只产出 SQL
是否输出	is_output	是否向下游暴露结果

输出字段

名字	说明
sql	生成的 SQL 文本
success	是否成功
message	说明或错误信息
context	附加上下文
event	事件信息
tables	涉及表信息
forms	涉及表单信息

配置步骤

1. 选模型，在提示词中写清业务问题与允许的表/库范围。
2. 需要只审查 SQL 时关闭「是否执行」。
3. 执行场景务必限制权限与表白名单，避免任意 SQL。
4. 完善 语义配置（术语）与 参考数据（示例 SQL / 规则）；表结构不足时配合元数据检索或在提示词中给出 schema。

常见问题

• SQL 乱猜表名：补齐表 display_name / 字段标签，补充语义术语与参考数据，收紧提示词中的表范围。
• 执行失败：先关执行只看 sql，再单独用只读账号验证。
• 参考/术语未生效：对应菜单中记录须「启用」；执行端自动注入，节点面板无需再勾选。

相关文档

• AI 流程编排
• 智能问数
• 语义配置
• 参考数据
• 模型管理