【愚公系列】《扣子开发 AI Agent 智能体应用》020-扣子数据库实战（创建/使用扣子数据库）

💎【行业认证·权威头衔】

✔ 华为云天团核心成员：特约编辑/云享专家/开发者专家/产品云测专家

✔ 开发者社区全满贯：CSDN博客&商业化双料专家/阿里云签约作者/腾讯云内容共创官/掘金&亚马逊&51CTO顶级博主

✔ 技术生态共建先锋：横跨鸿蒙、云计算、AI等前沿领域的技术布道者

🏆【荣誉殿堂】

🎖 连续三年蝉联"华为云十佳博主"（2022-2024）

🎖 双冠加冕CSDN"年度博客之星TOP2"（2022&2023）

🎖 十余个技术社区年度杰出贡献奖得主

📚【知识宝库】

覆盖全栈技术矩阵：

◾ 编程语言：.NET/Java/Python/Go/Node...

◾ 移动生态：HarmonyOS/iOS/Android/小程序

◾ 前沿领域：物联网/网络安全/大数据/AI/元宇宙

◾ 游戏开发：Unity3D引擎深度解析

文章目录

• 🚀前言
• 🚀一、创建/使用扣子数据库
• • 🔎1.创建扣子数据库
  • • [🦋1.1 创建步骤演示](#🦋1.1 创建步骤演示)
    • [🦋1.2 关键概念：单用户 vs. 多用户模式](#🦋1.2 关键概念：单用户 vs. 多用户模式)
  • 🔎2.使用扣子数据库
  • • [🦋2.1 实战案例：访客登记智能体](#🦋2.1 实战案例：访客登记智能体)
    • [🦋2.2 在智能体中集成数据库的步骤](#🦋2.2 在智能体中集成数据库的步骤)
    • [🦋2.3 进阶：在工作流中使用数据库节点](#🦋2.3 进阶：在工作流中使用数据库节点)

---

🚀前言

在构建智能体时，常需要永久保存对话或业务中产生的信息。变量适合暂存简单数据，而数据库则是管理结构化、复杂性数据（如用户档案、订单记录、产品清单）的理想选择。

将信息存入数据库，不仅实现了持久化存储，更能支持后续的精准查询与分析，使智能体具备"记忆"和深度服务用户的能力。

🚀一、创建/使用扣子数据库

🔎1.创建扣子数据库

扣子平台提供了类似传统数据库的功能，允许用户以表格结构存储和管理结构化数据（如客户信息、产品列表、订单记录）。你可以根据业务需求创建数据表，定义字段、数据类型，并设置规则以确保数据安全与完整性。

🦋1.1 创建步骤演示

以下以创建一个名为 daily_expenses 的日常开支记录表为例：

1. 进入创建入口 ：登录扣子开发平台，进入"资源库 "，点击右上角"+资源 "按钮，在菜单中选择"数据库"。

2. 填写基础信息：在"新建数据表"窗口中，填写：

   • 数据表名称 ：daily_expenses
   • 数据表描述 ：记录日常开支
     

3. 设计表结构：在接下来的页面中，为数据表添加业务字段：

   • date (日期): 类型为 Time
   • category (类别): 类型为 String
   • item (项目): 类型为 String
   • expense (金额): 类型为 Integer
   • family (是否为家庭共同开支): 类型为 Boolean (布尔值，是/否)

4. 理解系统字段：创建时，系统会自动添加以下四个核心字段，用于管理和追踪数据：

   • id: 主键，每条数据的唯一标识。
   • sys_platform: 数据来源的渠道（如微信、扣子、飞书），便于统计分析。
   • uuid: 用户唯一标识，由系统生成，确保用户数据的独立性与安全性。
   • bstudio_create_time: 数据插入时间 的时间戳。
     

🦋1.2 关键概念：单用户 vs. 多用户模式

在创建时需选择查询模式，这决定了数据的访问权限：

模式	核心逻辑	适用场景
单用户模式	用户仅能访问和操作自己创建的数据。数据按用户和渠道天然隔离。	个人日记、私人待办清单、用户个人资料表等需要严格数据隐私的场景。
多用户模式	所有用户共享数据池，对数据的读写权限由开发者通过智能体的业务逻辑来控制。	公共留言板、团队任务看板、企业产品目录等多用户需要共同查看或编辑的场景。

🔎2.使用扣子数据库

扣子数据库支持两种主要使用方式：

1. 自然语言交互：用户直接通过对话与智能体交互，智能体自动理解并执行数据操作。
2. 工作流节点：在工作流中添加数据库节点（如查询、新增），实现复杂、自动化的业务逻辑。

🦋2.1 实战案例：访客登记智能体

下面以创建一个访客登记智能体为例，演示如何集成数据库。数据表 visitor_registration 结构设计如下：

字段名 (Field)	说明	数据类型
visitor_name	访客姓名	String
gender	性别	String
phone_number	电话号码	String
purpose_of_visit	来访目的	String
time	来访时间	String
escort_number	陪同人数	String
whether_invited	是否受邀	String

🦋2.2 在智能体中集成数据库的步骤

1. 设计提示词（关键）：在智能体的"人设与回复逻辑"中，必须清晰说明其角色和如何使用数据库。

   • 示例 ："你是一个访客登记助手。当用户提供访客信息时，你需要将 visitor_name（姓名）、gender（性别）等信息整理后，保存到数据库中。"
     

2. 关联数据表 ：在智能体编排页面的"数据库 "功能区，点击添加按钮，选择已创建好的 visitor_registration 表。
   

3. 测试交互：在"预览与调试"区域模拟用户对话。例如，用户说："登记一下，张三先生今天下午来访，目的是面试，电话是13800138000。" 智能体会自动理解并生成一条记录插入数据库。

4. 查看数据 ：在调试区域右上角的"记忆 "菜单中，选择"已存数据库 "，即可查看、验证数据表中已保存的所有记录。
   

🦋2.3 进阶：在工作流中使用数据库节点

对于更复杂的场景（如先查询后更新），可以在工作流中拖入"数据库"节点（提供增、删、改、查等多种类型），进行可视化配置，实现更精准、强大的数据流控制。

核心要点总结：

使用扣子数据库可以遵循以下流程：
创建数据表
设计字段与选择模式

（单用户/多用户）
在智能体中集成
编写清晰的提示词
关联目标数据表
用户通过自然语言交互
智能体自动操作数据库
可在"记忆"中查看存档数据

核心价值：扣子数据库将复杂的数据库操作"平民化"，让开发者和最终用户都能通过最自然的对话方式来管理结构化数据，极大降低了AI应用开发的门槛。

如果你想了解如何为这个"访客登记系统"设计一个包含表单验证 和数据查询功能的完整工作流，我可以为你进一步详细说明。