创建记忆库

前提条件

• 使用记忆库前需要先开通AgentArts服务并进行服务授权，请在“授权管理”页面进行云服务开通及授权，详细信息请参考授权管理。
• 如需通过私有网络VPC访问记忆库，请确保已开通虚拟私有云，并已创建私有网络、子网。详细操作请参见创建虚拟私有云和子网。
• （可选）管理员可在IAM控制台为创建的IAM子用户授予权限，授权后，子用户即可根据权限使用账号中的云服务资源，相关操作步骤如下。
  1. 创建IAM用户。
  2. 给IAM用户授权。
     • 为子用户授予完整的记忆库权限，需授予AgentArtsFullAccessPolicy身份策略。
     • 可根据子用户实际需求创建自定义身份策略并授予如下权限，授权项功能介绍请参考表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智能体平台。
2. 在左侧导航栏选择“开发中心 > 组件库 ”，单击“记忆库”页签，进入记忆库界面。
3. 单击右上角“创建记忆库”。
4. 在“创建记忆库”的页面中，输入记忆库的配置信息，参数说明请参考表2。

   表2 参数说明

   参数		说明
   基本信息	记忆库名称	记忆库的名称。 命名规则：包含a-z、A-Z、0-9 和 （中划线）等有效字符，最多可包含 48 个字符。 系统会默认生成记忆库的名称，可根据需求自定义修改。
   	描述	用于对记忆库内容和用途的简要说明。 规则：长度不大于1000个字符。
   高级配置	私网访问	记忆库能够连接到内部的私有网络，访问内部的资源和服务。开启后，私有网络、子网暂时不支持修改。 选择已配置的VPC和子网，如未配置，请单击“新建私有网络”或“新建子网”并参考创建虚拟私有云和子网进行配置，配置后单击刷新。
   	公网访问	开启公网访问后，存在一定安全风险，建议仅用于开发调测场景。开启后，暂不支持关闭。
   身份认证与鉴权	API Key	系统默认为“API Key”，通过接口的访问密钥进行身份验证和授权。 系统会自动为记忆创建和绑定API Key，可通过记忆详情页查看。
   数据加密配置	数据加密配置	选择“默认密钥”或“自定义密钥”。 数据加密功能，可以有效地对会话元数据、消息内容、记忆内容、自定义策略的提示词等敏感数据进行加密保护，满足用户对数据自主加密管控的合规需求，从而降低数据泄露等安全风险。 默认密钥 使用云服务默认密钥（agentarts/default）加密。 自定义密钥 通过自定义创建的KMS密钥进行加密。 密钥生成算法：当前支持选择“AES_256”。 AES是一种对称加密算法，AES_256表示使用256位密钥长度的AES算法，提供很高的安全性。 密钥名称：在下拉选项中选择已创建的自定义密钥。也可单击“创建密钥”创建一个新的密钥，单击“查看密钥列表”可以查看已有的密钥列表。 说明： 密钥名称用于标识具体的加密密钥。在使用过程中，密钥不能被禁用、编辑或冻结，否则会导致记忆库不可用。 记忆库创建后，数据加密功能不可修改。 关于自定义密钥和默认密钥的区别可参考自定义密钥与默认密钥有什么区别？ 自定义密钥以及默认密钥均会收取相关费用，费用说明请参考DEW 计费说明。
   短期记忆	短期记忆（原始事件）过期	存储智能体在当前任务或会话中的临时信息和状态，通常在任务完成后清空。 用于设置短期（原始事件）记忆持续时间，超过设置的持续时间的事件过期后不再存储。时间设置可设置为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中创建预定义标签，用于使用同一标签标识多种云资源，创建后可在标签输入框下拉选择同一标签，具体操作请参考创建预定义标签，创建后单击刷新。 单击“添加标签”，选择在TMS中创建的预定义标签，或自定义输入标签键和标签值。 可添加一个或多个标签，最多添加20个标签。

5. 单击“立即创建”，在“API Key”弹框中，请复制或下载API Key，以便在SDK客户端进行鉴权使用。

   API Key只显示一次请妥善保存。

6. 单击“继续创建”，则记忆库创建成功，即可在记忆库列表展示已创建的记忆库。

后续操作

创建记忆库成功后，您可以在智能体中集成记忆库，以保留上下文、用户偏好等，实现跨会话的持久化。详细操作请参见在智能体中集成记忆库。

更多操作

您还可以对已创建的记忆库执行如下操作。