扣子数据库实战案例：搭建AI登记助手

本案例整个智能体开发主要分为4个核心步骤（见图7-21）：

（1）信息梳理：来访者的基本信息，如姓名、手机号等。

（2）提示工程：根据录入信息与智能体业务逻辑编写提示词。

（3）建数据表：新建自定义数据表，便于信息写入。

（4）调试测验：测试是否正确录入相应字段。

图7-21  智能体开发步骤

通过这一流程，即使是零技术基础的用户，也能轻松实现电子化登记，让烦琐的登记过程变得高效又便捷。

让我们开始创建智能体。首先，登录扣子官方网站，进入工作空间。然后依次单击“工作空间”→“项目开发”，在页面右上角单击“+ 创建”按钮，打开“创建智能体”页面。在“创建智能体”页面，填写智能体基本信息，如图7-22所示，智能体名称为“AI登记助手”（20字以内），智能体功能介绍为“记录访客信息”。

图7-22  创建智能体

创建智能体后，考虑需要登记的访客信息有哪些，并编写对应的提示词，如图7-23所示。这里推荐几个一般情况下需要登记的信息，如姓名、性别、电话、目的、时间、陪同人数以及是否受邀等。

图7-23  编写提示词

完整提示词如下：

# 角色
你是一位专业且贴心的访客登记助手，始终以礼貌、得体的态度引导用户准确填写访客记录。你具备良好的沟通能力，能够耐心解答用户在登记过程中产生的疑问。## 技能
### 技能 1：信息收集当用户开始登记信息时，你会按照以下顺序依次询问：
1. 您好，请问您的姓名是？
2. 您的性别是？
3. 请问您的电话号码是多少？
4. 您此次来访的目的可以告诉我吗？
5. 您来访的时间是？
6. 您有几位陪同人员？
7. 您是受邀前来的吗？当用户填写完所有信息后，你会以如下格式回复：
======
您填写的访客记录信息如下：
- 访客姓名：{访客姓名}
- 访客性别：{访客性别}
- 访客电话号码：{访客电话号码}
- 来访目的：{来访目的}
- 来访时间：{来访时间}
- 陪同人数：{陪同人数}
- 是否受邀：{是否受邀}
请仔细核对信息是否准确，如有误，请告知我修改。如无误，请回复“1”确认保存信息。
======### 技能 2：工作流程处理确认信息
若用户输入“1”，你会将{访客姓名}、{访客性别}、{访客电话号码}、{来访目的}、{来访时间}、{陪同人数}、{是否受邀}存储到“visitor_registration”中，并回复用户“登记完成，感谢您的配合！”若用户输入其他内容，你会回复“抱歉，我目前只能协助您完成登记，其他需求请咨询相关负责人。”## 限制
- 严格按照流程收集和处理访客记录，不会跳过任何步骤。
- 仅提供与访客登记相关的服务，不涉及其他无关内容。 

接下来，在智能体编排页面，选择模型“DeepSeek-R1·工具调用”，并单击如图7-24所示的模型设置按钮。

图7-24  模型设置按钮

如图7-25所示，在“DeepSeek-R1·工具调用 参数设置”页面上，进行模型参数设置，如生成随机性为0.8、携带上下文轮数为15、最大回复长度默认为1024。

图7-25  模型参数设置

接下来需要创建保存访客信息的数据库，在智能体编排页面“记忆”下的“数据库”右方单击“添加表”按钮，如图7-26所示。

图7-26  单击“添加表”按钮

在弹出的“选择数据库”窗口下方单击“新建数据表”，出现如图7-27所示的菜单，选择“自定义数据表”。

图7-27  选择自定义数据表

如图7-28所示，填写数据表名称（如visitor_registration）和数据表描述（如访客登记），单击星星按钮，让AI自动生成数据表图标，也可使用默认图标，填写完成后，单击“确认”按钮，创建数据表。

图7-28  “新建数据表”页面

如图7-29所示，在“新建数据表”页面，Table查询模式选择“单用户模式”，通过单击“+ 新增”按钮来增加数据表的字段。

图7-29  单击“+ 新增”按钮

按照前面提示词的设计，将访客需要填写的信息按顺序进行新增，填写字段名称和字段描述，如图7-30所示。新增字段包括访客姓名visitor_name、性别gender、电话号码phone_number、来访目的purpose_of_visit、来访时间time、陪同人数escort_number、是否受邀whether_invited，字段类型都选择String，是否必要均选择“必要”。图7-30框中的访客信息需要与提示词中设定的询问内容相对应。

图7-30  新增字段配置

另外，数据库的名称一定要与智能体的“人设与回复逻辑”提示词中技能设定的存储表名称一致，如图7-31所示。

图7-31  数据表名称对应

接下来需要进行智能体的调试测试，模拟访客与智能体对话交互，输入访客基本信息，最后回复1确认录入，如图7-32所示。

图7-32  调试智能体

如图7-33所示，调试完成后，单击“预览与调试”右侧的“记忆”，单击“已存数据库”查看调试后登记的信息。

图7-33  查看登记信息

在弹出的“记忆”窗口（见图7-34）中，查看已存数据库的访客信息是否登记无误。

图7-34  已存入数据库信息

通过以上步骤，我们就完成了一个能够自动完成访客登记的AI智能体。该智能体可以快速记录访客信息并生成登记记录，极大地提高了访客登记的效率和准确性。建议在实际使用过程中，根据具体场景和需求，不断调整和优化各个环节的参数，以获得最佳的使用效果。