Skip to content

数据库与持久化

Coze 数据库提供轻量级的数据表能力,支持智能体通过自然语言或工作流读写结构化信息。典型场景包括记账、工单、报名表、设备巡检记录等。


创建数据表

  1. 在智能体编排页点击 数据库+ 创建数据表。
  2. 选择「自定义表格」或从官方模板复制。
  3. 配置以下信息:
    • 表名 / 描述:便于识别用途。
    • 查询模式
      • 单用户模式:按渠道隔离数据,用户只能访问自己创建的记录,适合个人助手。
      • 多用户模式:同一渠道共享数据,适合团队协作;系统会自动添加 uuid 字段标记用户。
    • 字段定义:指定字段名、描述、数据类型(String / Integer / Number / Time / Boolean),并决定是否必填。

数据库结构示意


在提示词中操作数据库

Coze 支持 NL2SQL:模型会根据提示词自动生成增删改查语句。

示例提示词片段:

markdown
## 数据操作
- 记录用户的消费:写入字段 {amount}、{category}、{date}。
- 查询当日消费:返回 {date} 对应的总金额。

配置完成后,用户可以使用自然语言插入或查询数据;调试面板右上角可以直接查看表内记录。

自然语言查询示意


与插件 / 工作流结合

  • 在工作流中可使用「数据库」节点执行精细化查询或更新,必要时传入 uuid 等字段保证多用户隔离。
  • 结果可写入变量或消息卡片,实现流程化处理。

异常与调试

  • 若写入失败,请确认必填字段是否缺失、数据类型是否匹配。
  • 多用户模式下,在工作流使用数据表时记得传递 uuid 字段。
  • 通过「试运行」或调试详情查看 SQL 日志,快速定位问题。