扣子的数据库功能提供了一种简单、高效的方式来管理和处理结构化数据，开发者和用户可通过自然语言插入、查询、修改或删除数据库中的数据。同时，也支持开发者开启多用户模式，支持更灵活的读写控制。 ## 功能介绍 扣子提供了类似传统软件开发中数据库的功能，允许用户以表格结构存储数据。这种数据存储方式非常适合组织和管理结构化数据，例如客户信息、产品列表、订单记录等。 扣子数据库表支持单用户和多用户两种查询模式。 * 开发者指创建数据表的开发人员；用户指智能体的使用者。 * 多用户模式仅在工作流的数据库节点中生效。 | | **单用户模式** | **多用户模式** | | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | 读写模式 | 有限读写模式 | 完整读写模式 | | 读写权限 | 开发者和用户都可以添加记录，但仅能读/修改/删除自己创建的来自同渠道的数据。 | 开发者和用户都可读/写/修改/删除表中来自同渠道的任何数据，由业务逻辑控制读写权限。 | | 生效方式 | 在创建数据库表时，选择单用户模式。 | 在创建数据库表时，选择多用户模式。 | | 调用方式 | * 支持在 Prompt、Query 中通过 NL2SQL 方式及代码方式调用* 支持在工作流中通过 NL2SQL 方式及代码方式调用 | * 支持在 Prompt、Query 中通过 NL2SQL 方式及代码方式调用* 支持在工作流中通过 NL2SQL 方式及代码方式调用 | | 应用场景示例 | * 一个记账智能体，每个用户/开发者,自己记录账单，自己查看。* 一个金融分析智能体，开发者导入上市公司近三年财报到数据表用于做金融分析，所有用户都可以读这份数据用于金融分析。 | * 一个漂流瓶智能体，用户可以发布漂流瓶，也可以随机读取别人的漂流瓶。* 一个联网游戏智能体，游戏结束后，可以查看排行榜。 | ## 创建数据表 参考以下操作，创建数据表： 1. 登录[扣子开发平台](https://www.coze.cn/home)。 2. 在左侧导航栏中选择**工作空间**，并在页面顶部空间列表中选择目标工作空间。 3. 在**项目开发**页面，选择智能体。 4. 在智能体编排页面，单击**数据库**对应的创建图标 **+**。 5. 在弹出的新窗口中，单击**新建数据表>****自定义表格**创建数据表，或单击**新建数据表>基于模版创建**，复用示例表再进行修改。 6. 根据以下信息配置数据表，然后单击**保存**。 | **配置项** | **说明** | | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 表格名称 | 输入表名称。 | | 表格描述 | 输入表的描述信息。 | | Table 查询模式 | 扣子数据表支持单用户和多用户两种查询模式。> 开发者指创建数据表的开发人员；用户指使用智能体的终端用户。* 单用户模式：开发者和用户都可以添加记录，但仅能读/修改/删除自己创建的来自同渠道的数据。* 多用户模式：开发者和用户**都可**读/写/修改/删除表中来自同渠道的任何数据，由业务逻辑控制读写权限。* 选择多用户模式后，会自动新增一个 uuid 字段，用来标识用户，由系统自动生成。* 在 Prompt 中，使用 NL2SQL 操作数据表时不需要包含 uuid 字段，但在工作流中使用多用户模式时，需要包含 uuid 字段。 | | 字段 | 添加字段信息：* **存储字段名称**：字段名称。只能包含小写字母或数字或\_、必须以英文字母开头、最多 64 字符。* **描述**：存储字段的补充说明，可以是对存储字段的自然语言描述、示例数据，也可以是格式说明等。* **数据类型**：存储字段的数据类型，大语言模型会按照选择的数据类型对用户输入的内容进行处理和保存。目前支持的数据类型包括 String、Integer、Time、Number 和 Boolean。* **是否必要**：是否是必要字段。必要字段，是指用户在保存一行数据时必须提供对应字段信息。 | ## 使用数据表 扣子支持在 Prompt 通过 NL2SQL 方式对数据表进行操作。为了方便演示和介绍数据功能，本文以一个记录日常开支的智能体为例。这个智能体中使用的数据表结构如下。  用户可通过自然语言与智能体进行交互来插入或查询数据库中的数据。智能体会根据用户的输入自动创建一条新的记录并将其存储在数据库中。同样，用户也可以使用自然语言查询数据库中的数据，例如询问某一天的总开支、某一个类别的开支等，智能体会根据用户的查询条件从数据库中检索相应的数据并返回给用户。  参考以下操作，在 Prompt 中添加并使用数据表： 1. 在 Prompt 中明确说明要执行的操作和涉及的字段，包括字段的使用说明。这样，大语言模型可以更准确地根据用户输入来执行操作。 2. 在数据库功能区域添加要操作的数据表。 3. 在调试区域，进行测试。 可单击调试区域右上方查看数据表中的数据。