[]

AI表格查询命令

在查询命令中使用 AI 查询功能

本文档旨在说明如何在活字格的表格查询对话框命令中启用并使用“AI 查询”功能，以简化最终用户的数据筛选操作。

一、功能简介

在传统的数据查询界面中，用户通常需要手动选择字段、设置“等于”、“包含”等条件，并填写具体数值。对于复杂的多条件查询，这个过程可能比较繁琐。

“AI 查询”功能对此进行了改进。它允许最终用户直接使用自然语言（例如，输入一句话）来描述查询需求，AI 会自动将这句话解析为结构化的查询条件，并执行筛选。

二、核心优势

简化用户操作：最终用户无需学习复杂的查询界面，只需用日常语言描述想查找的数据即可。
提升查询效率：对于多条件组合的复杂查询，通过一句话输入通常比逐条设置条件更快。
数据安全：此功能在工作时，仅会将数据表的结构（如字段名）和用户的输入文本发送给 AI 模型以生成查询条件。您的实际业务数据不会被发送给 AI，保证了数据查询过程的安全性。

三、配置步骤

为查询命令启用 AI 功能非常简单。以下以“表格查询对话框命令”为例进行说明。

添加查询命令
在一个包含列表或表格的页面上，通常会有一个“查询”按钮。为此按钮绑定“表格查询对话框命令”。
启用 AI 查询
在“显示查询对话框”命令的设置面板中，找到并勾选“使用 AI 查询”复选框。
配置 AI 选项
勾选后，需要配置以下两个核心选项：

AI 模型：选择一个用于解析用户指令的 AI 模型。
用户输入：指定一个单元格或变量，用于接收最终用户输入的自然语言查询文本。

四、关键选项说明

在使用 AI 查询时，有两个重要的选项可以控制其行为。

确认 AI 查询结果
- 勾选时：当最终用户输入查询文本后，系统会弹出一个对话框，显示 AI 解析出的具体查询条件。用户可以检查这些条件是否符合预期，然后点击“确定”执行查询。这为用户提供了一个审核环节，增加了透明度和准确性。
- 不勾选时：系统将直接使用 AI 生成的条件执行查询，中间不会有确认步骤。这个模式执行速度更快，但用户无法在查询前确认 AI 的理解是否正确。
接收 AI 查询的结果
此选项在未勾选“确认 AI 查询结果”时生效。您可以指定一个单元格或页面变量，用来接收 AI 生成的结构化查询条件（通常为 JSON 格式的文本）。这对于调试或记录 AI 的行为非常有用。

五、注意事项

如果用户输入的内容为空，系统将直接清除当前的查询条件并显示所有数据，AI 不会参与此次操作。
此功能属于“运行时 AI”功能，其可用性与您在应用设置中配置的 AI 模型相关。