CreateMemoryDreamTask 创建 Dream-表格存储 Tablestore(Tablestore)-阿里云帮助中心

使用 CreateMemoryDreamTask 接口创建异步 Dream 任务。结构化记忆库使用 Dream 整理长期记忆、提取技能或画像；可写文件记忆库使用 Dream 整理文本文件并自动写入指定的输出 Scope。

前提条件

已创建 AgentStorage 实例且状态为 normal，并获取实例访问地址（endpoint）和实例名。
已创建 API Key。
Dream 为异步任务，创建后需通过 GetMemoryDreamTask 轮询任务状态。结构化记忆 Dream 和文件 Dream 的参数与适用记忆库类型不同，创建前应确认记忆库类型。

请求参数

公共参数

字段	类型	必填	说明
`memoryStoreName`	string	是	记忆库名称。
`scopes`	array	是	输入 Scope 选择器。结构化低强度 Dream 最多 20 个，高强度 Dream 和文件 Dream 最多 8 个。
`taskType`	string	否	`memory`（默认）、`skill` 或 `profile`。文件 Dream 仅支持 `memory` 或省略。
`effort`	string	否	`low`（默认）或 `high`。文件 Dream 固定为 `high`，可省略。
`expandedScopeLimit`	int	否	Scope 展开上限，默认 200，最大 1000。
`instructions`	string	否	自定义整理指令，最长 4000 字节（UTF-8）。
`clientToken`	string	否	幂等 Token。同一业务请求重试时复用相同值。

结构化记忆 Dream 参数

以下字段只适用于非文件记忆库。

字段	类型	必填	说明
`applyMode`	string	否	`proposal`（默认）、`safe_auto` 或 `plan`。仅 `taskType=memory` 支持；`plan` 需要高强度整理。
`scopeOutputMode`	string	否	`preserve_scope`（默认）或 `promote_scope`。
`confidenceThresholds`	object	否	自动应用置信度阈值；键为 `add`、`update`、`merge`，值为 0～1。
`minTimestamp` / `maxTimestamp`	string 或 number	否	消息时间范围，Unix 毫秒时间戳，不支持 RFC3339。
`maxSessions` / `maxMessages` / `maxMemories`	int	否	输入规模上限，取值范围见使用限制。
`incremental`	boolean	否	是否从上次成功水位增量整理，默认 `false`。显式 `minTimestamp` 优先。

文件记忆 Dream 参数

以下字段只适用于 inputType=file、outputTypes=["file"] 的可写文件记忆库。

字段	类型	必填	说明
`outputScope`	object	是	唯一输出位置。必须是完整四级 Scope，不允许使用通配符。
`maxItems`	int	否	任务可处理的文件数，默认 1000，最大 5000；包含去重后的输入和输出 Scope 已有文件。
`applyMode`	string	否	仅允许 `auto` 或省略。文件动作在任务执行期间自动应用。

文件 Dream 不支持消息时间窗口、incremental、scopeOutputMode、confidenceThresholds、maxSessions、maxMessages 或 maxMemories。只读文件记忆库、二进制文件和 /.wiki/ 系统路径不支持文件 Dream。

请求示例

使用 API Key 认证时，通过 x-ots-instancename 和 x-ots-apikey 请求头传入实例名和 API Key。

创建结构记忆 Dream

curl -X POST https://<endpoint>/CreateMemoryDreamTask \
  -H "x-ots-instancename: <instance-name>" \
  -H "x-ots-apikey: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "memoryStoreName": "agent_memory",
  "scopes": [
    {
      "appId": "app-001",
      "tenantId": "user-001"
    }
  ],
  "taskType": "memory",
  "applyMode": "proposal"
}'

创建文件记忆 Dream

{
  "memoryStoreName": "agent_files",
  "scopes": [
    {
      "appId": "project-app",
      "tenantId": "team-a",
      "agentId": "research-agent",
      "runId": "*"
    },
    {
      "appId": "project-app",
      "tenantId": "team-a",
      "agentId": "coding-agent",
      "runId": "*"
    }
  ],
  "outputScope": {
    "appId": "project-app",
    "tenantId": "team-a",
    "agentId": "shared-agent",
    "runId": "knowledge"
  },
  "instructions": "按主题整理，并保留不同项目的适用条件和分歧。",
  "maxItems": 1000,
  "clientToken": "project-file-dream-001"
}

响应

{
  "memoryStoreName": "agent_files",
  "dreamId": "a83e4877f94443229969ec72b8b75e1d",
  "status": "queued",
  "createdAt": "2026-09-14T03:00:00Z"
}