# 记忆导入导出 记忆导入导出为您提供记忆数据的备份与迁移能力。您可以将记忆库中的记忆数据导出至对象存储服务（OBS）进行备份，或将已导出的记忆文件导入到目标记忆库，便于跨环境或跨记忆库迁移记忆数据。 支持以下核心场景： - 数据备份安全：将记忆库中的记忆数据导出保存至OBS桶，避免数据丢失。 - 数据迁移能力：在不同记忆库间迁移记忆数据，适配测试到生产、环境切换等场景。 导入导出文件均存储在您自建的OBS桶中，文件归属用户自主管理，您可通过自己的OBS桶下载或管理文件。 #### 约束与限制 - 导出格式仅支持JSONL。 - 导入文件需为json（JSONL）格式。 - 单次导出或导入的记忆条数上限为100万条，文件大小上限为1024MB。 - 系统最大支持10个导入导出任务并发执行（导入和导出共计），超出并发的任务将排队等待。 - 同一记忆库不能同时运行导入和导出任务，但可同时创建，后创建的任务进入排队。 - 导入导出使用的OBS桶需为单AZ存储类型，暂不支持多AZ存储桶，使用多AZ存储桶会导致任务失败。 - 删除任务不操作OBS文件，OBS文件由用户自行管理。 #### 前提条件 - 已创建记忆库，且记忆库处于"可用"状态。详细操作请参见[创建记忆库](https://support.huaweicloud.com/highcode-agentarts/agentarts_10_017.html)。 - 已创建OBS桶。记忆导入导出通过您自建的OBS桶中转文件，平台不提供文件存储。如未创建OBS桶，请前往[对象存储服务](https://console.huaweicloud.com/obs)创建桶，详细操作请参见[创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.html)。 - 已创建具备OBS访问权限的委托。进行记忆导出或导入时需要[创建委托并授权](https://support.huaweicloud.com/usermanual-iam5/iam_01_1163.html)，请确保传入的委托包含以下身份策略权限： 表1授权项 | 授权项 | 功能介绍 | |:---|:---| | obs:object:getObject | 授予下载非指定版本对象的权限。 | | obs:object:putObject | 授予上传对象的权限。 | #### 导出记忆 将记忆库中的记忆数据导出至OBS桶，用于数据备份或迁移。 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏选择"托管与运行 \> 记忆库"，进入记忆库界面。 3. 单击记忆库名称，进入记忆库详情页。 4. 在页面右上角单击"记忆导入导出"。 5. 在弹出的"记忆导入导出"窗口中，单击"记忆导出"，进入创建导出任务页面。 6. 在"创建导出任务"页面，配置导出参数，参数说明请参考[表2]。 表2导出记忆参数说明 | 参数 | 说明 | |:---|:---| | OBS桶 | 选择用于存放导出文件的OBS桶（用户自建桶）。可单击"前往OBS"跳转至对象存储服务控制台创建，详细请参考[创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.html)。 | | 存储路径 | 导出文件在OBS桶内的存储子路径。 路径格式：/路径名称。 为空时存储到桶的根路径；若有值则必须以"/"开头，支持大小写字母、数字及! _ - . \* ' ( ) /等字符且不能包含".."，路径长度最大1024字符。 | | 委托 | 选择具备OBS访问权限的委托。为保证记忆导出正常运行，所选委托需具备相关权限。可单击"创建委托"自定义新建委托，或单击"一键创建并选用"系统快速创建并选用所需委托，系统创建的委托名称为"AgentArtsMemoryImportExportAgency"，单击"查看所需权限"查看委托所需权限列表。 自定义创建委托操作如下： - 委托名称：自定义。 - 信任主体类型：选择"云服务"。 - 搜索service.AgentArtsMemory。 - 其余参数使用默认值。 图1创建委托 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002777494892.png "点击放大") 委托创建完成后可对委托进行授权，具体操作详情请参考[创建委托并授权](https://support.huaweicloud.com/usermanual-iam/iam_06_0002.html)，需授予obs:object:putObject的操作。 | | 用户ID | 按用户ID过滤导出的记忆数据。为空时导出所有用户的记忆。 | | 会话ID | 按会话ID过滤导出的记忆数据。为空时导出所有会话的记忆。 | | 日期范围 | 按记忆创建时间范围过滤导出数据。为空时导出所有时间段的记忆。 | | 记忆策略类型 | 按记忆策略类型过滤，支持选择总结、语义记忆、用户偏好、情景记忆、程序性记忆等内置策略。为空时导出所有策略类型的记忆。 | | 导出格式 | 导出文件格式，当前支持JSONL。 | 7. 单击"确定"，创建导出任务。 任务创建后状态为"等待中"，调度执行后变为"进行中"。导出完成后，文件将存储在您选择的OBS桶路径下，您可在任务详情中查看文件名全路径，并前往自己的OBS桶下载文件。 #### 记忆导入 将记忆文件导入到当前记忆库，用于数据恢复或跨记忆库迁移。 ![](https://support.huaweicloud.com/highcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) 导入前请先将待导入的json（JSONL）文件上传至您的OBS桶，您需在OBS控制台完成文件上传，详情请参见[上传对象](https://support.huaweicloud.com/usermanual-obs/obs_41_0076.html)。 导入字段要求： ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002806934497.png "点击放大") 其中：strategy_type，content必填字段，assistant_id，session_id，actor_id，extraction_meta为可选字段（session_id不为空时需要uuid形式字符串）。 - strategy_type：记忆策略类型 - content：记忆内容 - assistant_id：智能体ID - session_id：会话ID - actor_id：用户ID - extraction_meta：记忆内容的分类/属性 示例：{"assistant_id":"assistant-abc","updated_at":"2026-09-08T14:32:52.538916+08:00","session_id":"789e0123-e89b-12d3-a456-426614174000","memory_type":"memory","extraction_meta":{"fact":"编程语言偏好","category":"技能"},"created_at":"2026-09-08T14:32:52.538916+08:00","strategy_type":"semantic","id":"f236783a-8643-4385-8f79-7696cf428231","actor_id":"user-12345","space_id":"0d352eac-1852-4b04-8131-cdf306537184","content":"用户偏好使用 Python 进行数据分析"} 1. 登录[AgentArts智能体平台](https://console.huaweicloud.com/agentarts/#/home/overview)。 2. 在左侧导航栏选择"托管与运行 \> 记忆库"，进入记忆库界面。 3. 单击记忆库名称，进入记忆库详情页。 4. 在页面右上角单击"记忆导入导出"。 5. 在弹出的"记忆导入导出"窗口中，单击"记忆导入"，进入创建导入任务页面。 6. 在"创建导入任务"页面，配置导入参数，参数说明请参考[表3]。 表3导入参数说明 | 参数 | 说明 | |:---|:---| | OBS桶 | 选择待导入文件所在的OBS桶（用户自建桶）。可单击"前往OBS"跳转至对象存储服务控制台创建，详细请参考[创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.html)。 | | 文件路径 | 输入待导入文件在OBS桶中的路径。导入文件需在OBS桶已上传，文件格式为json（JSONL）。 路径格式：/文件夹名称/文件名称，以"/"开头，支持大小写字母、数字及! _ - . \* ' ( ) /等字符且不能包含".."，路径长度最大1024字符。 | | 委托 | 选择具备OBS访问权限的委托。为保证记忆导入正常运行，所选委托需具备相关权限。可单击"创建委托"自定义新建委托，或单击"一键创建并选用"系统快速创建并选用所需委托，系统创建的委托名称为"AgentArtsMemoryImportExportAgency"，单击"查看所需权限"查看委托所需权限列表。 自定义创建委托操作如下： - 委托名称：自定义。 - 信任主体类型：选择"云服务"。 - 云服务：搜索service.AgentArtsMemory。 - 其余参数使用默认值。 图2创建委托 ![](https://support.huaweicloud.com/highcode-agentarts/zh-cn_image_0000002777654880.png "点击放大") 委托创建完成后可对委托进行授权，具体操作详情请参考[创建委托并授权](https://support.huaweicloud.com/usermanual-iam/iam_06_0002.html)，需授予obs:object:getObject的操作。 | 7. 单击"确定"，创建导入任务。 ![](https://support.huaweicloud.com/highcode-agentarts/public_sys-resources/note_3.0-zh-cn.png) - 导入文件中每条记录需包含strategy_type字段，缺少该字段的记录将报错并跳过，计入失败条数，不影响后续记录导入。 - 导入时不去重，您提供的记录会直接写入记忆库，单条记录导入失败不会中断整体任务，失败记录计入失败条数。 - 导入的记忆会触发向量生成，写入完成后即可参与记忆检索。 #### 管理导入导出任务 导入导出任务创建后，您可在任务列表中查看任务进度、状态，并管理任务。 通过"全部任务"、"导出任务"、"导入任务"三个页签切换查看。列表按创建时间倒序展示，每个任务卡片包含任务类型标签（导入/导出）、任务ID、任务状态和创建时间；失败任务还会在卡片中显示具体的错误原因。前端每10秒自动刷新进度。任务状态说明请参考[表4]。 表4任务状态说明 | 状态 | 说明 | |:---|:---| | 等待中 | 任务已创建，等待调度执行。同一记忆库不能同时运行导入和导出任务，后创建的任务将进入排队。 | | 进行中 | 任务正在进行，可在任务详情中查看进度。 | | 成功 | 任务执行完成。导出任务可在详情中查看文件路径，前往OBS桶下载；导入任务可在详情中查看成功/失败条数。 | | 失败 | 任务执行失败，可在详情中查看失败原因。 | 任务管理操作： - 查看任务进度：任务列表展示每个任务的类型、状态和进度条（已完成条数/总条数百分比）。 - 查看导出文件：导出任务成功后，任务详情中显示文件名全路径（如obs://桶名/路径/文件名），您需通过自己的OBS桶下载文件。 - 查看导入结果：导入任务完成后，可查看成功条数和失败条数。失败任务可展开查看前100条失败详情。 - 删除任务：在任务列表中可删除任务。删除任务不会删除OBS桶中的文件，OBS文件由您自行管理。 - 删除等待中的任务：删除后任务记录无法恢复。 - 删除进行中的任务：删除后将停止当前任务，已导入或导出内容会被保留，任务记录无法恢复。 - 删除已完成的任务：删除后已导入或导出内容会被保留，任务记录无法恢复。 - 删除失败任务：删除后任务记录无法恢复。