AI对话单元格

观看本节视频

功能概述

AI 对话单元格是活字格提供的智能交互组件，允许终端用户通过自然语言与应用系统进行多轮对话。该组件支持：

• 上下文感知的连续对话

• 动态数据绑定与展示

• 自定义函数调用

• 界面风格灵活配置

配置指南

基础配置

1. 选择 AI 模型：

• 从已配置的运行时模型中选择

• 支持测试连接验证可用性

2. 绑定数据源：

• 可关联多个数据表

• 绑定后可在提示词中引用数据表

• 示例提示词：

  根据数据生成营销文案：[%AiDataSource=(数据源1)%]

提示词设置

公式插入

• 直接编写 Excel 公式即可

• 示例：[=Text(Today(),"yyyy-MM-dd")]

关键字插入：

• 点击右侧树形菜单快速插入

• 支持日期、用户、数据源等

函数定义

1. 创建函数：

• 采用驼峰命名法（如getOrderDetail）

• 明确定义参数和返回值

2. 执行控制：

• 启用/禁用函数：主要用于在开发阶段调试功能，例如临时禁用某些函数

• 设置执行前确认：对于敏感危险的操作，应该勾选该选项以让用户二次确认操作

type=warning

注意：一旦配置了函数定义列表，输出 AI 聊天文本时，将从流式输出变成一次输出全部回答。

事件

新建对话时命令

当用户发起一个新的AI对话（如点击“新建对话”按钮或初始化聊天窗口）时执行。

典型用例：

• 设置或者还原页面中的一些上下文

• 通过可用操作“添加组件消息”向 AI 对话单元格追加一个卡片消息，用作“开场白”

消息追加时命令

每次用户或AI发送消息并成功追加到聊天记录时触发（包括用户输入和AI回复）。

典型用例：

• 保存聊天记录到数据库（可配合可用操作“获取历史消息”）

• 调用 AI 助手命令或触发常规业务逻辑

界面定制

标题设置

• 显示标题栏

• 显示新建对话按钮

• 自定义标题图标

• 自定义标题文本

聊天区设置

• 显示聊天时间戳

• 显示复制按钮

• 显示重新生成按钮

• 显示用户问题建议

• 自定义 AI 对话图标

底边栏设置

• 显示底边栏

• 自定义文本输入框水印

• 自定义输入提问最大长度

开场白设置

• 自定义开场文案

• 自定义开场问题列表

典型场景

客户服务场景

1. 绑定客户历史订单表，按需设置查询条件和获取行数等

2. 设置系统提示词：

你是一名专业的客服代表，请根据客户历史订单信息回答问题。
可用数据：[%AiDataSource=(客户历史订单表)%]
当前时间：[%Date.Now%]
当前用户名：[%CurrentUser.UserName%]

3. 用户提问："我最近的订单状态如何？"

数据查询场景

1. 创建查询函数，"查询销售数据",描述为"获取指定Top行数的数据"

2. 添加一个参数，"top"

3. 添加一个返回值，"data"

4. 编辑命令，添加一个设置变量命令，变量名为"data"，从数据表获取值，查询行数设为"=top"公式

5. 运行应用，用户提问："显示本月销售 Top 10 产品"

6. 聊天消息展示正在执行操作（执行操作的结果，也就是命令的返回值data，会再次发送给AI)

7. 聊天框展示AI的答复

注意事项

1. 性能优化：

• 复杂函数的调用命令建议添加加载状态提示

• 大数据量查询建议分页处理

2. 安全建议：

• 对用户输入进行敏感词过滤

• 关键操作必须设置执行确认

3. 体验提升：

• 为常用操作添加快捷指令（通过可用操作->添加文本消息来实现）

• 提供开场白或对话示例引导用户

故障排查

提示：建议先在测试环境充分验证提示词和对话逻辑，再部署到生产环境