创建记忆库

前提条件

• 使用记忆库前需要先开通AgentArts服务并进行服务授权，请在“授权管理”页面进行云服务开通及授权，详细信息请参考授权管理。
• 如需通过私有网络VPC访问记忆库，请确保已开通虚拟私有云，并已创建私有网络、子网。详细操作请参见创建虚拟私有云和子网。
• （可选）管理员可在IAM控制台为创建的IAM子用户授予权限，授权后，子用户即可根据权限使用账号中的云服务资源，相关操作步骤如下。
  1. 创建IAM用户。
  2. 给IAM用户授权。
     • 为子用户授予完整的记忆库权限，需授予AgentArtsCoreRunFullAccessPolicy身份策略。
     • 可根据子用户实际需求创建自定义身份策略并授予如下权限，授权项功能介绍请参考表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	授予记录集的删除权限

创建记忆库

1. 登录AgentArts智能体开发平台。
2. 在左侧导航栏选择“开发中心 > 组件库 ”，单击左上角“记忆库”页签，进入记忆库界面。
3. 单击右上角“创建记忆库”。
4. 在“创建记忆库”的页面中，输入记忆库的配置信息，参数说明请参考表2。

   表2 参数说明

   参数		说明
   基本信息	记忆库名称	记忆库的名称。 命名规则：包含a-z、A-Z、0-9 和 （中划线）等有效字符，最多可包含 48 个字符。 系统会默认生成记忆库的名称，可根据需求自定义修改。
   	描述	用于对记忆库内容和用途的简要说明。 规则：长度不大于1000个字符。
   高级配置	私网访问	记忆库能够连接到内部的私有网络，访问内部的资源和服务。开启后，私有网络、子网暂时不支持修改。 选择已配置的VPC和子网，如未配置，请单击“新建私有网络”或“新建子网”并参考创建虚拟私有云和子网进行配置，配置后单击刷新。
   	公网访问	开启公网访问后，存在一定安全风险，建议仅用于开发调测场景。开启后，暂不支持关闭。
   身份认证与鉴权	API Key	系统默认为“API Key”，通过接口的访问密钥进行身份验证和授权。 系统会自动为记忆创建和绑定API Key，可通过记忆详情页查看。
   短期记忆	短期记忆（原始事件）过期	存储智能体在当前任务或会话中的临时信息和状态，通常在任务完成后清空。 用于设置短期（原始事件）记忆持续时间，超过设置的持续时间的事件过期后不再存储。时间设置可设置为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之间。

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

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

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

后续操作

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

更多操作

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