更新时间：2026-04-15 GMT+08:00
为应用添加记忆
在多轮对话场景中，用户往往期望智能体能够记住自己的偏好、身份和交互习惯，从而获得连贯且个性化的服务体验。在单智能体配置中，支持通过配置变量为应用开启“记忆”功能。
AgentArts提供以下记忆类型，满足不同场景下的记忆需求：
- 入参变量：通过API调用向智能体动态注入外部信息（如用户 ID、业务单据编号），支持String、Boolean、Integer、Number类型，支持在工作流、插件和MCP服务的入参配置处引用。
约束与限制
|
类别 |
说明 |
|---|---|
|
变量 |
每个应用最多支持创建30个变量。
|
变量类型说明
|
变量类型 |
说明 |
适用场景 |
|---|---|---|
|
入参变量 |
入参变量用于在API调用时向智能体动态传入外部信息，通常用于注入具有确定性的业务逻辑、上下文信息或特定参数（如：用户ID、业务单据编号等确定性数据）。支持的数据类型包括String、Boolean、Integer、Number。 使用示例可参考示例：配置与使用入参变量。 |
|
示例：配置与使用入参变量
使用场景：
当需要在智能体中固定某些参数值时，即适合使用入参变量。典型场景包括：
- 固定组件入参：为工作流、插件、MCP服务中的某个参数绑定固定值。例如，将天气查询服务的城市参数固定为“上海”，无论用户如何提问，服务始终查询上海的天气。
- 固定提示词上下文：在提示词中引用入参变量，为智能体注入固定的背景信息或约束条件。
以下通过一个天气查询场景，演示“入参变量”的完整配置方法和典型引用方式。
示例场景说明：
本示例将创建一个"城市旅行助手"智能体，为其添加天气查询插件，并通过入参变量将城市参数固定为"上海"。配置完成后，无论用户如何提问，智能体始终基于"上海"进行回复。
- 创建单智能体。
参考表3创建一个“城市旅行助手”单智能体。
- 添加插件。
进入“城市旅行助手”的单智能体配置界面，添加“天气查询”类插件。添加插件的详细操作步骤可参考添加插件。
- 新增入参变量。
在“记忆”模块的“入参变量”处，单击“
”新增入参变量，参考表4添加入参变量，单击“确定”。
表4 添加入参变量 参数
说明
配置示例
名称
入参变量的名称，支持中英文字符，不支持 ^，最长 100 个字符。
城市
描述
非必填。用于标识该入参变量的用途，最长 200 个字符。
旅行目的地
类型
选择入参变量的数据类型，当前支持String、Boolean、Integer、Number。
String
默认值
非必填。入参变量的默认值。
上海
图1 添加入参变量
- 在插件参数中引用变量。
- 鼠标放置在“天气查询”插件处，单击“天气查询”插件的“参数配置”图标。
图2 参数配置
- 在“插件参数配置”界面，单击“location”参数的“默认值”列，选择“引用”，然后选择已配置的“城市”入参变量。
- 关闭“location”参数的“可见性”开关，固定该参数不被智能体修改，单击“确定”完成插件参数配置。
如果“可见性”开关保持开启，智能体在对话过程中会根据用户的提问内容自动覆盖默认值，入参变量的固定效果将不生效。图3 插件参数配置
- 鼠标放置在“天气查询”插件处，单击“天气查询”插件的“参数配置”图标。
- 预览调试。
在右侧“预览调试”窗口进行提问。此时无需在提问中提及城市名称，智能体也会默认查询并回复上海的天气信息。
单击右上角的“
”记忆图标，进入“入参变量”页签，即可查看当前已配置的入参变量取值。
图4 预览调试
