查询数据工具使智能体能够从应用中的数据列表中检索记录。通过该工具，AI 可以基于条件查询数据、指定返回字段、定义排序和分页，并在对话或其他工具中使用结果。
1. 访问工具管理面板
打开目标智能体。
在顶部导航中选择 工具。
在工具页面中，您可以查看、启用/禁用、编辑或删除现有工具。
要添加新工具，请点击左上角的 添加工具。
2. 添加查询数据工具
点击 添加工具 后，选择：
查询数据 — 从数据列表中搜索并检索记录
然后进行配置：
1. 选择应用
选择包含您要查询数据的应用。
2. 数据源
选择要检索记录的列表或报表。
选择后，您可以选择：
添加 — 直接添加工具，无需进一步配置
添加并配置 — 进入完整配置页面
3. 通用设置
您可以通过以下方式进入完整设置页面：
在创建工具时选择 添加并配置
或在现有工具上点击 … → 编辑
以下部分描述所有通用配置选项。
（1）详细设置
详细设置定义工具的基本信息、关联数据源以及凭据模式。
设置 | 描述 |
名称 | 工具名称（≤100 字符）。默认为工具类型，但可以自定义 |
描述 | 用于说明工具用途（≤2500 字符），帮助 AI 理解如何使用该工具 |
工具 | 显示工具类型（只读），例如：查询数据 |
应用 | 所选应用。可以通过链接图标在新窗口中打开 |
数据源 | 所选列表或报表。可以打开进行查看 |
使用的凭据 | 定义执行查询时使用的用户身份 |
凭据选项
凭据模式 | 描述 |
终端用户凭据 | 使用 AI 终端用户身份执行查询。如果用户没有列表权限，AI 将收到访问错误 |
指定用户 | 以指定用户身份执行查询。如果该用户没有访问权限，工具将执行失败 |
（2）输入设置
输入定义工具在执行时接收的参数。
每个输入包括：
输入名称
输入类型
填充方式（AI 动态值或自定义值）
值（条件、字段选择或具体数值）
1. 数据筛选
输入名称：数据筛选
输入类型：文本
可选
支持：
AI 动态生成条件
或通过“自定义条件编辑器”手动配置
2. 字段
输入名称：字段
输入类型：文本
可选
点击 设置 打开字段选择对话框。
字段选择对话框功能：
可以勾选需要返回的字段（每个字段只能选择一次）
排序设置字段在输出中的顺序
显示名称可重命名字段以获得更清晰输出
未勾选字段不会出现在结果中
建议仅选择必要字段，以保持结果简洁并便于 AI 解析
3. 排序
输入名称：排序
输入类型：文本
可选
可以指定排序字段和排序方向（A → Z 或 Z → A）。
支持主排序和次排序。
4. 页码
输入名称：页码
输入类型：数字
可选
接受具体数值或表达式。
5. 每页数量
输入名称：每页数量
输入类型：数字
可选
控制每页返回的记录数量。
注意：
要了解“使用 AI 动态填充”和“自定义值”的区别，请参阅相关文章：
《AI智能体工具输入中“AI动态填充”和“自定义值”的用法与区别》
（3）完成设置
完成设置定义工具执行后智能体的行为，并指定哪些输出可供智能体及其他工具使用。
1. 执行后行为
选项 | 描述 |
不响应 | 智能体不会等待工具结果。适用于后续无需使用数据的场景 |
等待响应（默认） | 智能体等待工具执行完成并使用返回数据 |
2. 可供智能体及其他工具使用的输出
定义哪些输出可被访问。
查询数据工具的可用输出包括：
输出 | 类型 | 描述 |
数据 | 列表 | 查询到的数据记录。可自定义字段结构 |
消息 | 文本 | 执行消息，例如成功或错误信息 |
状态码 | 数字 | 类似 HTTP 状态码（例如 200、400） |
总数量 | 数字 | 满足查询条件的记录总数 |
可以通过 添加输出添加更多输出。
4. 总结
查询数据工具允许智能体通过自然语言指令查询应用数据。
它支持：
可配置筛选条件
字段选择
排序
分页
凭据模式
结构化输出
适用于各种数据查询场景。
其他工具（例如 删除数据、新增数据、按 ID 更新数据、调用智能体、启动工作流）也可以通过类似流程进行配置。