从0到1搭建扣子数据库，保姆级教程！

扣子提供了类似传统软件开发中数据库的功能，允许用户以表格结构存储数据。

这种数据存储方式非常适合组织和管理结构化数据，例如客户信息、产品列表、订单记录等。

那在扣子平台开发智能体如何正确使用数据库，对于小白来说，很有必要学一下扣子数据库知识，这篇文章展开讲一讲。

首先，在空间-资源库里面创建数据库，可以看到两种数据库创建方式，即扣子数据库和火山数据库。

这里声明一下，如果关联火山数据库，需要在火山引擎侧创建云数据库MySQL版，并且，会产生相应的费用。

包括云数据库 MySQL 版产品费用和公网 IP 费用，由各个产品收取。

扣子官方数据库，提供了类似传统软件开发中数据库的功能，允许用户以表格结构存储数据。这对于小白想学智能体的人来说，非常友好。

所以，解析来我们继续讲扣子数据库的创建。

1） 在新建数据表页面，输入数据库名称、描述信息，并上传图标，然后单击确认。

2）新增存储字段名称

说明：

（2）id：数据的唯一标识，作为数据库表的主键，确保了每条数据记录的唯一性。

（3）sys_platform：数据产生或使用的渠道，例如微信小程序、扣子、飞书等，便于进行数据分类和统计分析。

（4）uuid：用户唯一标识，由系统生成，确保用户数据的独立性和安全性。

（5）bstudio_create_time：数据插入的时间。

这里我追加两个字段存入数据表：

点击保存，这样我们的扣子数据表就创建完成了。

在我们创建成功之后，可以看到如下：

1）用户模式

扣子数据表支持单用户和多用户两种查询模式。

2）编辑表结构

对数据表字段可进行编辑

3）测试数据

点击测试数据，可对数据库中的数据进行增加、删除、刷新等操作。

扣子支持通过自然语言操作数据表，也支持在工作流中添加各数据库的节点来操作数据库。

1）通过自然语言操作数据

智能体会根据用户的输入自动创建一条新的记录并将其存储在数据库中。

同样，用户也可以使用自然语言查询数据库中的数据，例如询问某一天的总开支、某一个类别的开支等，智能体会根据用户的查询条件从数据库中检索相应的数据并返回给用户。

实例测试：

在人设与回复逻辑中明确说明要执行的操作和涉及的字段，包括字段的使用说明。这样，大语言模型可以更准确地根据用户输入来执行操作。

在预览与调试界面，输入“小明，16岁”，则调用数据库，并将数据库正确写入。

进入数据库查看测试数据：

没有问题，测试成功。

2）工作流使用数据库

在扣子工作流中，SQL 自定义节点用于对指定数据库进行常见的 SQL 操作。

配置 SQL 自定义节点

a. 输入节点比较简单。

b. 数据表，点击“+”，即可添加创建好的数据库到工作流中。

这里，如果你不会写SQL语句，没有关系，你可以使用AI自动生成。

描述好你的查询目标，扣子会自动给你生成SQL语句。

需要注意的是：

1. 每个 SQL 自定义节点中仅支持添加一条 SQL 语句。

2. 每次执行SQL 自定义节点，最多返回 1000 行数据。

3）工作流测试数据库

把SQL自定义节点输入删掉，直接测试节点，会从数据库读取数据，输出数据即为刚刚我们测试的数据，没有毛病。

这里SQL节点就差不多清楚了，需要额外注意的是：

默认情况下，节点运行超时、运行异常时，工作流会中断，工作流调试界面或 API 中会返回错误信息。

你也可以手动设置节点运行超时等异常情况下的处理方式，例如超时时间、是否重试、是否跳转异常分支等。

1. 新增数据节点

2. 查询数据节点

3. 更新数据节点

4. 删除数据节点

下面以新增数据节点为例：

1）添加新增数据节点

2）选择制定数据库

3）选择并设置字段

这里直接设置默认值，一般在开发工作流中，直接选择上游节点的值即可。

4）运行新增数据节点

测试节点，正确输出id

5）查看数据库

测试数据有了两条，正确。

其他三个节点差不多类似的使用和测试方式，大家可以动手去操作一下。

今天的分享就到这里了。如果你有想知道的其他方面，欢迎留言。