# 创建记忆库 创建记忆库用于存储和管理用户信息、历史交互和偏好，以便智能体能够提供更个性化、高效和情境适应的响应。 支持在控制台上通过配置长期记忆提取策略、短期记忆等参数来创建记忆库。 #### 前提条件 - 使用记忆库前需要先[开通AgentArts服务](https://support.huaweicloud.com/qs-agentarts/agentarts_04_0000.html)并进行服务授权，请在"授权管理"页面进行云服务开通及授权，详细信息请参考[授权管理](https://support.huaweicloud.com/lowcode-agentarts/agentarts_05_0218.html)。 - 如需通过私有网络VPC访问记忆库，请确保已开通虚拟私有云，并已创建私有网络、子网。详细操作请参见[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)。 - （可选）管理员可在IAM控制台为创建的IAM子用户授予权限，授权后，子用户即可根据权限使用账号中的云服务资源，相关操作步骤如下。 1. [创建IAM用户](https://support.huaweicloud.com/usermanual-iam5/iam_01_1144.html)。 2. [给IAM用户授权](https://support.huaweicloud.com/usermanual-iam5/iam_01_1145.html)。 - 为子用户授予完整的记忆库权限，需授予AgentArtsFullAccessPolicy身份策略。 - 可根据子用户实际需求[创建自定义身份策略](https://support.huaweicloud.com/usermanual-iam5/iam_01_0917.html)并授予如下权限，授权项功能介绍请参考[表1]。 表1授权项 | 授权项 | 功能介绍 | |:---|:---| | vpc:vpcs:get | 授予查询VPC的权限 | | vpc:subnets:get | 授予查询子网的权限 | | vpcep:endpoints:\* | 授予终端节点的操作权限 | | dns:zone:create | 授予区域的创建权限 | | dns:zone:delete | 授予区域的删除权限 | | dns:recordset:create | 授予记录集的创建权限 | | dns:recordset:list | 授予记录集的列表权限 | | dns:recordset:delete | 授予记录集的删除权限 | | kms:cmk:get | 授予查看KMS密钥的详细信息的权限 | | kms:cmk:createGrant | 授予给特定密钥创建授权的权限 | #### 创建记忆库 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏选择"开发中心 \> 组件库 "，单击"记忆库"页签，进入记忆库界面。 3. 单击右上角"创建记忆库"。 4. 在"创建记忆库"的页面中，输入记忆库的配置信息，参数说明请参考[表2]。 表2参数说明 | 参数 || 说明 | |:---|---|:---| | 基本信息 | 记忆库名称 | 记忆库的名称。 命名规则：包含a-z、A-Z、0-9 和 （中划线）等有效字符，最多可包含 48 个字符。 系统会默认生成记忆库的名称，可根据需求自定义修改。 | | 基本信息 | 描述 | 用于对记忆库内容和用途的简要说明。 规则：长度不大于1000个字符。 | | 高级配置 | 私网访问 | 记忆库能够连接到内部的私有网络，访问内部的资源和服务。开启后，私有网络、子网暂时不支持修改。 选择已配置的VPC和子网，如未配置，请单击"新建私有网络"或"新建子网"并参考[创建虚拟私有云和子网](https://support.huaweicloud.com/usermanual-vpc/zh-cn_topic_0013935842.html)进行配置，配置后单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002548695822.png)刷新。 | | 高级配置 | 公网访问 | 开启公网访问后，存在一定安全风险，建议仅用于开发调测场景。开启后，暂不支持关闭。 | | 身份认证与鉴权 | API Key | 系统默认为"API Key"，通过接口的访问密钥进行身份验证和授权。 系统会自动为记忆创建和绑定API Key，可通过记忆详情页查看。 | | 数据加密配置 | 数据加密配置 | 选择"默认密钥"或"自定义密钥"。 数据加密功能，可以有效地对会话元数据、消息内容、记忆内容、自定义策略的提示词等敏感数据进行加密保护，满足用户对数据自主加密管控的合规需求，从而降低数据泄露等安全风险。 - 默认密钥 使用云服务默认密钥（agentarts/default）加密。 - 自定义密钥 通过自定义创建的KMS密钥进行加密。 - 密钥生成算法：当前支持选择"AES_256"。 AES是一种对称加密算法，AES_256表示使用256位密钥长度的AES算法，提供很高的安全性。 - 密钥名称：在下拉选项中选择已创建的自定义密钥。也可单击"[创建密钥](https://support.huaweicloud.com/usermanual-dew/dew_01_0142.html)"创建一个新的密钥，单击"查看密钥列表"可以查看已有的密钥列表。 说明： 密钥名称用于标识具体的加密密钥。在使用过程中，密钥不能被禁用、编辑或冻结，否则会导致记忆库不可用。 记忆库创建后，数据加密功能不可修改。 关于自定义密钥和默认密钥的区别可参考[自定义密钥与默认密钥有什么区别？](https://support.huaweicloud.com/dew_faq/dew_01_0044.html) 自定义密钥以及默认密钥均会收取相关费用，费用说明请参考[DEW 计费说明](https://support.huaweicloud.com/price-dew/dew_03_0006.html)。 | | 短期记忆 | 短期记忆（原始事件）过期 | 存储智能体在当前任务或会话中的临时信息和状态，通常在任务完成后清空。 用于设置短期（原始事件）记忆持续时间，超过设置的持续时间的事件过期后不再存储。时间设置可设置为7～365天之间。 | | 长期记忆提取策略 | 总结 summary | 勾选后，将互动的大量详细信息或数据压缩成关键上下文和关键洞察信息，帮助智能体更高效地检索和利用长期记忆中的信息。如会议总结、年度工作总结等。 | | 长期记忆提取策略 | 语义记忆 Semantic Memory | 勾选后，使用与上下文无关的格式从原始对话中提取一般的事实性知识、概念和含义，帮助智能体理解和处理抽象信息。如个人信息、专业信息、教育经历等。 | | 长期记忆提取策略 | 用户偏好 User Preference | 勾选后，存储和管理用户在与智能体交互过程中表现出的偏好、习惯和个性化需求，用户偏好帮助智能体更好地理解和适应用户的需求。如个人爱好、运动习惯等。 | | 长期记忆提取策略 | 情景记忆 Episodic Memory | 勾选后，保留上下文的格式，从原始对话或经历中提取具有时空序列的具体事件、个人体验和场景细节，帮助智能体记住具体的事件和经历，支持其在类似情境下做出更准确的决策和响应。如旅游中的个人体验、看电影中的场景等。 | | 自定义策略（可选） | 自定义策略 | 用户可通过选择基础模型和定义提示模板，灵活地处理和生成特定类型的记忆内容。 单击"创建自定义策略"。 - 策略名称：自定义策略名称，策略名称不可重复。命名规则：包含a-z、A-Z、0-9 和 (中划线）等有效字符，最多可包含 48 个字符。 - 策略类型：选择策略类型，然后配置抽取（Extraction）、整合（Consolidation）和 反思（Reflection）的提示词模板。请根据页面展示的实际内容配置。 - 抽取 Extraction：从大量数据中提取关键信息和重要特征，可以使用默认用户提示或创建自定义提示。 - 整合 Consolidation：将提取出的信息进行汇总、合并和优化，确保信息的完整性和一致性，可以使用默认用户提示或创建自定义提示。 - 反思 Reflection：系统对过去的经验、行为或数据进行分析和总结，以提取有价值的信息和洞察的过程。 | | 长期记忆提取触发条件 | 空闲时间 | 在没有接收到新任务或用户交互的一段时间后，触发长期记忆的提取。 请输入具体的时间，时间范围介于10～86400秒之间，单位为秒。 | | 长期记忆提取触发条件 | 最大累计token数量 | 在处理用户输入时，累计的token数量达到预设的最大值时，触发长期记忆的提取。 请输入具体的token数量，数量介于1000～1073741824之间。 | | 长期记忆提取触发条件 | 最大累计消息数 | 在处理用户输入时，累计的消息数量达到预设的最大值时，触发长期记忆的提取。 请输入具体的消息数，消息数介于3～10000之间。 | | 高级配置 | 标签 (可选) | 由"标签键"和"标签值"组成，用于标识和分类云资源。 您可以在TMS中创建预定义标签，用于使用同一标签标识多种云资源，创建后可在标签输入框下拉选择同一标签，具体操作请参考[创建预定义标签](https://support.huaweicloud.com/usermanual-tms/zh-cn_topic_0144368884.html)，创建后单击![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002610162931.png)刷新。 单击"添加标签"，选择在TMS中创建的预定义标签，或自定义输入标签键和标签值。 可添加一个或多个标签，最多添加20个标签。 | 5. 单击"立即创建"，在"API Key"弹框中，查看或复制API Key id及API Key。 API Key只显示一次请妥善保存。 - API Key ID：[创建记忆库接口](https://support.huaweicloud.com/api-agentarts/CreateCoreSpace.html)时，作为请求参数传入，用于为记忆库绑定对应的鉴权密钥。 - API Key：数据面API认证，用于调用数据面API时，在请求头中携带进行身份认证，格式为：Authorization: Bearer ${api_key}。 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002654232208.png "点击放大") 6. 单击"继续创建"，则记忆库创建成功，即可在记忆库列表展示已创建的记忆库。 #### 后续操作 创建记忆库成功后，您可以在智能体中集成记忆库，以保留上下文、用户偏好等，实现跨会话的持久化。详细操作请参见[在智能体中集成记忆库](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_019.html)。 #### 更多操作 您还可以对已创建的记忆库执行如下操作。 表3更多操作 | 操作 | 说明 | |:---|:---| | 查看并修改记忆库 | 1. 进入记忆库界面。 2. 在记忆库列表中单击记忆库名称，查看记忆库详情。 3. 在"记忆库详情"页签，支持修改短期记忆持续时间、为记忆库新增内置策略或新增自定义策略、修改长期记忆触发条件等。 | | 删除记忆库 | 记忆库删除后不可恢复，请谨慎操作。 1. 进入记忆库界面。 2. 单击记忆库列表操作列的"删除"。 3. 在弹框中确认要删除后输入"DELETE"，然后单击"确定"。 | | 更新API Key | 1. 单击记忆库名称，进入"基本信息"界面，在"API Key"处单击"更新"。 图1更新API Key ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002585479539.png "点击放大") 2. 弹框中单击"确定"后，复制或下载API Key。 |