扣子数据库读写工作流自动化实战案例

在Coze Studio搭建工作流时，若要让智能体具备持久记忆并实现完整业务闭环，对数据库的增删改查是必需环节。关键洞察：你无需手动编写SQL即可完成基础读写，但遇到精确条件控制、批量操作或跨表逻辑时，必须结合数据库节点与SQL自定义节点。本文基于2026年6月最新平台界面与功能实测，所有路径、字段命名均与当前Coze Studio一致，可放心参考。

准备工作：创建数据库与数据表

操作路径：进入Coze Studio → 工作空间 → 资源库 → 点击右上角"+资源" → 选择"数据库" → 填写数据表名称（例如book_inventory）与描述 → 进入字段配置页。

接下来添加四个核心字段：【book_id】（类型选文本，设为主键）、【title】（文本）、【author】（文本）、【stock】（数字）。特别提醒：主键字段禁止为空，且必须唯一。否则后续"更新"或"删除"操作会失败，或误操作多条记录，后果严重。

保存后，该表即绑定到当前Bot或应用，可在任意工作流中直接调用。

新增数据：通过自然语言触发入库

创建工作流 → 先添加"开始"节点 → 在其配置中添加输入变量user_input（类型选Text）。

接着添加"大模型"节点 → 在提示词中明确要求结构化输出。示例写法："请从用户输入中提取书名、作者、库存数量，以JSON格式输出，字段名为title、author、stock。信息不全时，stock默认填1。"

再添加"新增数据"节点 → 将其连接至"大模型"节点输出 → 配置时选择book_inventory表 → 字段映射：将大模型输出的title拖到title字段，author拖到author字段，stock拖到stock字段。关键点：【book_id字段必须手动填写值，强烈建议使用{{uuid()}}函数生成唯一ID】。留空会导致插入失败，且无错误提示。另外，uuid()直接在字段值框中输入即可，无需加引号。

查询数据：支持模糊匹配与分页返回

查询有两种方式，按需选择。

方法一：使用"查询数据"节点（适合简单条件）
添加"查询数据"节点 → 选择book_inventory表 → 在"筛选条件"中点击"+添加条件" → 字段选title，操作符选"包含"，值填{{start.user_input}} → 开启"返回全部匹配项" → 设置"查询上限"为20（避免一次性拉取过多数据导致卡顿）。

方法二：使用"SQL自定义"节点（适合复杂逻辑）
添加"SQL自定义"节点 → 输入SQL语句：SELECT title, author, stock FROM book_inventory WHERE title LIKE '%' || {{start.user_input}} || '%'。注意：Coze的SQL中，字符串拼接用||，而非加号，使用+会直接报错。

无论采用哪种方式，查询结果必须连至"结束"节点，并在"结束"节点中勾选"返回数据"，否则前端无法收到响应。

更新与删除：必须带精准定位条件

此处最容易出错，请严格按步骤操作。

第一步：先用"查询数据"节点锁定目标记录
配置"查询数据"节点，条件设为title = {{start.user_input}} → 开启"仅返回第一条" → 将输出的book_id保存为变量target_id。此步确保操作对象唯一且精确。

第二步：执行更新
添加"更新数据"节点 → 表选book_inventory → "更新条件"中字段选book_id，操作符选"="，值填{{target_id}} → "设置字段"中将stock改为{{target_id.stock + 1}}（示例为每次加1本库存）。

第三步：执行删除
添加"删除数据"节点 → 表选book_inventory → "删除条件"中字段选book_id，操作符选"="，值填{{target_id}}。最后强调：【删除操作不可逆，且无二次确认弹窗，务必确保target_id来源绝对可靠】。