# 为应用添加记忆
在多轮对话场景中，用户往往期望智能体能够记住自己的偏好、身份和交互习惯，从而获得连贯且个性化的服务体验。在单智能体配置中，支持通过配置变量为应用开启"记忆"功能。
AgentArts提供以下记忆类型，满足不同场景下的记忆需求：
- 入参变量： 如果需要通过API传入外部业务参数（如"订单ID"），请选择"入参变量"。通过API调用向智能体动态注入外部信息（如用户ID、业务单据编号），支持String、Boolean、Integer、Number类型，支持在工作流、插件和MCP服务的入参配置处引用。
#### 约束与限制
表1记忆限制说明 
| 类别 | 说明                                                                                                                                                                                                                                                                            |
|:---|:---|
| 变量 | 每个应用最多支持创建30个变量。 - 变量名称：不允许为空，最长支持100个字符，不能带有\^符号。  - 描述最长支持200个字符，默认值最长支持500个字符。   |
   
#### 变量类型说明
表2变量类型说明 
| 变量类型 | 说明                                                                                                                                                                                                                     | 适用场景                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|
| 入参变量 | 入参变量用于在API调用时向智能体动态传入外部信息，通常用于注入具有确定性的业务逻辑、上下文信息或特定参数（如：用户ID、业务单据编号等确定性数据）。支持的数据类型包括String、Boolean、Integer、Number。 使用示例可参考[示例：配置与使用入参变量]。 | - 确定性信息注入：入参变量适用于传入明确、确定的外部信息，而非由智能体自主推理获取的内容。例如，将当前用户的身份信息或业务状态作为入参传入，智能体据此执行对应的处理逻辑。  - API动态赋值：入参变量的值通过调用智能体API时传入，每次调用可传入不同的值，实现参数的动态替换，无需修改智能体配置。  - 组件间灵活引用：入参变量创建后，可在工作流、插件、MCP服务的入参配置处进行引用，将外部传入的信息无缝传递至各组件中使用。   |
   
 #### 示例：配置与使用入参变量
**使用场景：**
当需要在智能体中固定某些参数值时，即适合使用入参变量。典型场景包括：
- 固定组件入参：为工作流、插件、MCP服务中的某个参数绑定固定值。例如，将天气查询服务的城市参数固定为"上海"，无论用户如何提问，服务始终查询上海的天气。
- 固定提示词上下文：在提示词中引用入参变量，为智能体注入固定的背景信息或约束条件。
以下通过一个天气查询场景，演示"入参变量"的完整配置方法和典型引用方式。
**示例场景说明：**
本示例将创建一个"城市旅行助手"智能体，为其添加天气查询插件，并通过入参变量将城市参数固定为"上海"。配置完成后，无论用户如何提问，智能体始终基于"上海"进行回复。
1. 创建单智能体。 
   参考[表3]创建一个"城市旅行助手"单智能体。
    表3单智能体入参变量示例 
   | 单智能体信息 | 示例值               |
   |:---|:---|
   | 名称     | 城市旅行助手            |
   | 描述     | 根据用户的提问进行旅行目的地问答。 |
      
   
   
2. 添加插件。 
   进入"城市旅行助手"的单智能体配置界面，添加"天气查询"类插件。添加插件的详细操作步骤可参考[添加插件](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0022.html)。
   
   
3. 新增入参变量。 
   在"记忆"模块的"入参变量"处，单击"![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717549807.png)"新增入参变量，参考[表4]添加入参变量，单击"确定"。
    表4添加入参变量 
   | 参数  | 说明                                             | 配置示例   |
   |:---|:---|:---|
   | 名称  | 入参变量的名称，支持中英文字符，不支持 \^，最长 100 个字符。             | 城市     |
   | 描述  | 非必填。用于标识该入参变量的用途，最长 200 个字符。                   | 旅行目的地  |
   | 类型  | 选择入参变量的数据类型，当前支持String、Boolean、Integer、Number。 | String |
   | 默认值 | 非必填。入参变量的默认值。                                  | 上海     |
      
   图1添加入参变量   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950174.png "点击放大")
   
   
4. 在插件参数中引用变量。 
   1. 鼠标放置在"天气查询"插件处，单击"天气查询"插件的"参数配置"图标。
      图2参数配置   
      ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950164.png "点击放大") 
   
   2. 在"插件参数配置"界面，单击"location"参数的"默认值"列，选择"引用"，然后选择已配置的"城市"入参变量。
   
   3. 关闭"location"参数的"可见性"开关，固定该参数不被智能体修改，单击"确定"完成插件参数配置。
      ![](https://support.huaweicloud.com/lowcode-agentarts/public_sys-resources/caution_3.0-zh-cn.png)
      如果"可见性"开关保持开启，智能体在对话过程中会根据用户的提问内容自动覆盖默认值，入参变量的固定效果将不生效。
      图3插件参数配置   
      ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002717389925.png "点击放大") 
   
   
   
   
5. 预览调试。 
   在右侧"预览调试"窗口进行提问。此时无需在提问中提及城市名称，智能体也会默认查询并回复上海的天气信息。
   图4预览调试   
   ![](https://support.huaweicloud.com/lowcode-agentarts/zh-cn_image_0000002687950162.png "点击放大")