创建记忆库-j9九游会登录

前提条件

• 使用记忆库前需要先开通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. 登录。
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算法，提供很高的安全性。 密钥名称：在下拉选项中选择已创建的自定义密钥。也可单击“创建密钥”创建一个新的密钥，单击“查看密钥列表”可以查看已有的密钥列表。 说明： 密钥名称用于标识具体的加密密钥。在使用过程中，密钥不能被禁用、编辑或冻结，否则会导致记忆库不可用。 记忆库创建后，数据加密功能不可修改。 关于自定义密钥和默认密钥的区别可参考 自定义密钥以及默认密钥均会收取相关费用，费用说明请参考。
   短期记忆	短期记忆（原始事件）过期	存储智能体在当前任务或会话中的临时信息和状态，通常在任务完成后清空。 用于设置短期（原始事件）记忆持续时间，超过设置的持续时间的事件过期后不再存储。时间设置可设置为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. 单击“继续创建”，则记忆库创建成功，即可在记忆库列表展示已创建的记忆库。

后续操作

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

更多操作

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