“按 ID 更新项目”工具允许智能体修改所选数据列表中现有记录的特定字段。智能体使用项目的唯一 ID 来定位记录，并仅更新您所配置的字段。
访问工具页面
打开目标智能体。
在顶部导航中点击 工具。
查看、启用/禁用、编辑或删除现有工具。
点击 添加工具创建新工具。
添加“按 ID 更新项目”工具
点击 添加工具 后，选择：
按 ID 更新项目— 使用其 ID 修改现有记录的特定字段
然后：
选择应用— 选择包含该列表的应用
数据源— 选择要更新项目的列表
选择 添加或 添加并配置
通用设置
该工具包含与其他智能体工具相同的通用设置：
详细信息— 名称、描述、工具类型、应用、数据源
使用的凭据— 终端用户凭据或指定用户
这些设置在各个工具中保持一致。
有关更多详细信息，请参阅：AI 智能体。
输入— 更新项目时使用的字段
“按 ID 更新项目”工具包含一个默认输入：
默认输入：项目 ID
列 | 描述 |
输入名称 | 记录标识 |
输入类型 | 单行文本 |
填充方式 | 通常为“AI 动态填充”，以便 AI 提供正确的记录 ID |
值 | 可选的自定义值 |
项目 ID 是必填项。如果缺少该字段，系统无法识别要更新的记录。
添加并配置需要更新的字段输入
要指定智能体可以更新哪些字段，请点击 + 添加输入。
弹出对话框会列出所选数据列表中的所有字段，包括每个字段的输入名称、ID 和输入类型（单行文本、数字、日期等）。选择您希望允许更新的字段，然后点击 确定。
输入表配置
所选字段将出现在 Inputs 表中，每一行代表一个可以更新的字段。对于每个字段，您可以配置：
列 | 描述 |
输入名称 | 要更新的字段 |
输入类型 | 从列表继承 |
填充方式 | AI 填充或自定义值 |
值 | 仅在使用自定义值时需要 |
仅在输入部分添加的字段才可以由智能体更新。
您可以使用删除图标移除任何字段。
只有在需要修改时，才需要包含必填字段。
如果记录标识缺失或无效，更新将失败。
注意：
要了解“AI 动态填充”和“自定义值”选项，请参阅以下文章：
《AI智能体工具输入中“AI动态填充”和“自定义值”的用法与区别》
完成
完成设置定义工具执行后智能体的行为：
执行后行为
选项 | 描述 |
不响应 | 智能体不会等待工具结果。适用于后续无需使用数据的场景 |
等待响应（默认） | 智能体等待工具执行完成并使用返回数据 |
该部分与其他工具行为一致，并与输出（Outputs）一起使用。
可供智能体及其他工具使用的输出
该部分用于指定更新操作完成后可用的输出。
默认输出包括：
输出 | 类型 | 描述 |
数据 | 文本 | 更新操作返回的信息（例如：更新后的字段或确认信息） |
消息 | 文本 | 描述成功或失败的可读消息 |
状态码 | 数字 | 数值状态指示，例如 200（成功）或 400（错误） |
管理输出
点击 自定义 配置每个输出。
删除不需要的输出。
已删除的输出可以随时通过 添加输出 按钮重新添加。
总结
“按 ID 更新项目”工具使智能体能够通过使用唯一 ID 更新记录中的特定字段。
通过配置输入和输出，您可以控制：
智能体可以修改哪些字段
值如何提供
哪些信息会返回给智能体用于后续处理
该工具适用于如下场景：
更新联系人信息
修改订单状态
调整库存数据