“向数据列表添加项目”工具使智能体能够在选定的数据列表中创建新记录。通过配置输入字段和输出，您可以定义智能体如何提供数据以及系统如何返回创建结果。
访问工具页面
打开目标智能体。
在顶部导航中点击 工具。
查看、启用/禁用、编辑或删除现有工具。
点击 添加工具创建新工具。
添加“向数据列表添加项目”工具
点击 添加工具 后，选择：
向数据列表添加项目— 向数据列表插入新记录
然后：
选择应用— 选择包含该数据列表的应用
数据源— 选择要创建新记录的列表
选择 添加或 添加并配置
通用设置
您可以通过以下方式进入完整设置页面：
在创建工具时选择 添加并配置
或在现有工具上点击 … → 编辑
以下部分描述所有通用配置选项。
（1）详细设置
详细设置定义工具的基本信息、关联数据源以及凭据模式。
设置 | 描述 |
名称 | 工具名称（≤100 字符）。默认为工具类型，但可以自定义 |
描述 | 用于说明工具用途（≤2500 字符），帮助 AI 理解如何使用该工具 |
工具 | 显示工具类型（只读），例如：查询数据 |
应用 | 所选应用。可以通过链接图标在新窗口中打开 |
数据源 | 所选列表或报表。可以打开进行查看 |
使用的凭据 | 定义执行查询时使用的用户身份 |
凭据选项
凭据模式 | 描述 |
终端用户凭据 | 使用 AI 终端用户身份执行查询。如果用户没有列表权限，AI 将收到访问错误 |
指定用户 | 以指定用户身份执行查询。如果该用户没有访问权限，工具将执行失败 |
（2）输入— 创建新项目时使用的字段
与“查询数据”不同，“向数据列表添加项目”工具需要定义在创建新记录时智能体可以填写哪些列表字段。
初始状态下，Inputs 表为空。
点击 + 添加输入添加字段。
选择输入
弹出对话框会列出所选数据列表中的所有字段：
输入名称— 字段的显示名称
ID — 字段的内部 ID
输入类型— 数据类型（单行文本、数字、日期等）
选择应提供给智能体填充的字段，然后点击 确定。
输入表配置
每个选中的输入会作为一行显示，包括：
列 | 描述 |
输入名称 | 智能体将填写的字段名称 |
输入类型 | 从数据列表继承的数据类型 |
填充方式 | AI 生成的值或自定义值 |
值 | 仅在使用自定义值时显示 |
注意：
必填字段应包含在内
只有在此添加的字段才可以由智能体填充
可以随时使用删除图标移除字段
注意：
要了解“使用 AI 动态填充”和“自定义值”选项，请参阅以下文章：
《AI智能体工具输入中“AI动态填充”和“自定义值”的用法与区别》
（3）完成
您可以配置：
执行后— 智能体是否等待工具的响应
该部分的行为与其他工具相同，并与输出一起定义执行后的行为。
（4）可供智能体及其他工具使用的输出
定义在创建项目后，该工具的哪些输出可供智能体或其他工具使用。
默认输出包括：
输出 | 类型 | 描述 |
消息 | 文本 | 描述执行结果（成功或错误） |
状态码 | 数字 | 以数值形式表示成功或失败 |
管理输出
点击 自定义 配置每个输出的内容。
您可以删除不需要的输出。
已删除的输出可以随时通过 添加输出按钮重新添加。
总结
“向数据列表添加项目”工具使智能体能够通过映射到列表字段的结构化输入创建新记录。
通过配置输入和输出，您可以完全控制数据如何被收集，以及结果如何在后续流程中使用。