记忆导入导出

约束与限制

• 导出格式仅支持JSONL。
• 导入文件需为json（JSONL）格式。
• 单次导出或导入的记忆条数上限为100万条，文件大小上限为1024MB。
• 系统最大支持10个导入导出任务并发执行（导入和导出共计），超出并发的任务将排队等待。
• 同一记忆库不能同时运行导入和导出任务，但可同时创建，后创建的任务进入排队。
• 导入导出使用的OBS桶需为单AZ存储类型，暂不支持多AZ存储桶，使用多AZ存储桶会导致任务失败。
• 删除任务不操作OBS文件，OBS文件由用户自行管理。

前提条件

• 已创建记忆库，且记忆库处于“可用”状态。详细操作请参见创建记忆库。
• 已创建OBS桶。记忆导入导出通过您自建的OBS桶中转文件，平台不提供文件存储。如未创建OBS桶，请前往对象存储服务创建桶，详细操作请参见创建桶。
• 已创建具备OBS访问权限的委托。进行记忆导出或导入时需要创建委托并授权，请确保传入的委托包含以下身份策略权限：

  表1 授权项

  授权项	功能介绍
  obs:object:getObject	授予下载非指定版本对象的权限。
  obs:object:putObject	授予上传对象的权限。

导出记忆

将记忆库中的记忆数据导出至OBS桶，用于数据备份或迁移。

1. 登录AgentArts智能体平台。
2. 在左侧导航栏选择“托管与运行 > 记忆库”，进入记忆库界面。
3. 单击记忆库名称，进入记忆库详情页。
4. 在页面右上角单击“记忆导入导出”。
5. 在弹出的“记忆导入导出”窗口中，单击“记忆导出”，进入创建导出任务页面。
6. 在“创建导出任务”页面，配置导出参数，参数说明请参考表2。

   表2 导出记忆参数说明

   参数	说明
   OBS桶	选择用于存放导出文件的OBS桶（用户自建桶）。可单击“前往OBS”跳转至对象存储服务控制台创建，详细请参考创建桶。
   存储路径	导出文件在OBS桶内的存储子路径。 路径格式：/路径名称。 为空时存储到桶的根路径；若有值则必须以“/”开头，支持大小写字母、数字及! _ - . * ' ( ) /等字符且不能包含“..”，路径长度最大1024字符。
   委托	选择具备OBS访问权限的委托。为保证记忆导出正常运行，所选委托需具备相关权限。可单击“创建委托”自定义新建委托，或单击“一键创建并选用”系统快速创建并选用所需委托，系统创建的委托名称为“AgentArtsMemoryImportExportAgency”，单击“查看所需权限”查看委托所需权限列表。 自定义创建委托操作如下： 委托名称：自定义。 信任主体类型：选择“云服务”。 搜索service.AgentArtsMemory。 其余参数使用默认值。 图1 创建委托 委托创建完成后可对委托进行授权，具体操作详情请参考创建委托并授权，需授予obs:object:putObject的操作。
   用户ID	按用户ID过滤导出的记忆数据。为空时导出所有用户的记忆。
   会话ID	按会话ID过滤导出的记忆数据。为空时导出所有会话的记忆。
   日期范围	按记忆创建时间范围过滤导出数据。为空时导出所有时间段的记忆。
   记忆策略类型	按记忆策略类型过滤，支持选择总结、语义记忆、用户偏好、情景记忆、程序性记忆等内置策略。为空时导出所有策略类型的记忆。
   导出格式	导出文件格式，当前支持JSONL。

7. 单击“确定”，创建导出任务。

   任务创建后状态为“等待中”，调度执行后变为“进行中”。导出完成后，文件将存储在您选择的OBS桶路径下，您可在任务详情中查看文件名全路径，并前往自己的OBS桶下载文件。

记忆导入

将记忆文件导入到当前记忆库，用于数据恢复或跨记忆库迁移。

导入前请先将待导入的json（JSONL）文件上传至您的OBS桶，您需在OBS控制台完成文件上传，详情请参见上传对象。

导入字段要求：

其中：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智能体平台。
2. 在左侧导航栏选择“托管与运行 > 记忆库”，进入记忆库界面。
3. 单击记忆库名称，进入记忆库详情页。
4. 在页面右上角单击“记忆导入导出”。
5. 在弹出的“记忆导入导出”窗口中，单击“记忆导入”，进入创建导入任务页面。
6. 在“创建导入任务”页面，配置导入参数，参数说明请参考表3。

   表3 导入参数说明

   参数	说明
   OBS桶	选择待导入文件所在的OBS桶（用户自建桶）。可单击“前往OBS”跳转至对象存储服务控制台创建，详细请参考创建桶。
   文件路径	输入待导入文件在OBS桶中的路径。导入文件需在OBS桶已上传，文件格式为json（JSONL）。 路径格式：/文件夹名称/文件名称，以“/”开头，支持大小写字母、数字及! _ - . * ' ( ) /等字符且不能包含“..”，路径长度最大1024字符。
   委托	选择具备OBS访问权限的委托。为保证记忆导入正常运行，所选委托需具备相关权限。可单击“创建委托”自定义新建委托，或单击“一键创建并选用”系统快速创建并选用所需委托，系统创建的委托名称为“AgentArtsMemoryImportExportAgency”，单击“查看所需权限”查看委托所需权限列表。 自定义创建委托操作如下： 委托名称：自定义。 信任主体类型：选择“云服务”。 云服务：搜索service.AgentArtsMemory。 其余参数使用默认值。 图2 创建委托 委托创建完成后可对委托进行授权，具体操作详情请参考创建委托并授权，需授予obs:object:getObject的操作。

7. 单击“确定”，创建导入任务。
   

   • 导入文件中每条记录需包含strategy_type字段，缺少该字段的记录将报错并跳过，计入失败条数，不影响后续记录导入。
   • 导入时不去重，您提供的记录会直接写入记忆库，单条记录导入失败不会中断整体任务，失败记录计入失败条数。
   • 导入的记忆会触发向量生成，写入完成后即可参与记忆检索。

管理导入导出任务

导入导出任务创建后，您可在任务列表中查看任务进度、状态，并管理任务。

通过“全部任务”、“导出任务”、“导入任务”三个页签切换查看。列表按创建时间倒序展示，每个任务卡片包含任务类型标签（导入/导出）、任务ID、任务状态和创建时间；失败任务还会在卡片中显示具体的错误原因。前端每10秒自动刷新进度。任务状态说明请参考表4。

任务管理操作：

• 查看任务进度：任务列表展示每个任务的类型、状态和进度条（已完成条数/总条数百分比）。
• 查看导出文件：导出任务成功后，任务详情中显示文件名全路径（如obs://桶名/路径/文件名），您需通过自己的OBS桶下载文件。
• 查看导入结果：导入任务完成后，可查看成功条数和失败条数。失败任务可展开查看前100条失败详情。
• 删除任务：在任务列表中可删除任务。删除任务不会删除OBS桶中的文件，OBS文件由您自行管理。
  • 删除等待中的任务：删除后任务记录无法恢复。
  • 删除进行中的任务：删除后将停止当前任务，已导入或导出内容会被保留，任务记录无法恢复。
  • 删除已完成的任务：删除后已导入或导出内容会被保留，任务记录无法恢复。
  • 删除失败任务：删除后任务记录无法恢复。