メモリストレージ HTTP JSON API リファレンス - Tablestore - Alibaba Cloud ドキュメントセンター

API一覧

カテゴリ別にグループ化されたAPIは以下の通りです。

メモリストア管理

API	説明
`CreateMemoryStore`	メモリストアを作成します。
`GetMemoryStore`	メモリストアの詳細を取得します。
`UpdateMemoryStore`	メモリストアの説明を更新します。
`DeleteMemoryStore`	メモリストアを削除します。
`ListMemoryStores`	メモリストアを一覧表示します。

長期記憶

API	説明
`AddMemories`	会話メッセージまたはテキストを書き込んで、長期記憶を生成します。
`SearchMemories`	長期記憶を検索します。
`ListMemories`	長期記憶を一覧表示します。
`GetMemory`	長期記憶のエントリを取得します。
`UpdateMemory`	長期記憶のエントリを更新します。
`DeleteMemory`	長期記憶のエントリを削除します。

短期記憶と監査

API	説明
`ListMemoryStoreMessages`	短期記憶 (元の会話メッセージ) をクエリします。
`ListMemoryStoreRequests`	メモリストアのリクエストの監査レコードをクエリします。

非同期タスクとスコープ

API	説明
`GetMemoryTask`	非同期抽出タスクのステータスと結果をクエリします。
`ListMemoryTasks`	非同期抽出タスクを一覧表示します。
`ListMemoryStoreScopes`	メモリストアに存在するスコープを一覧表示します。

メモリードリーム

API	説明
`CreateMemoryDreamTask`	メモリードリームタスクを作成します。
`GetMemoryDreamTask`	メモリードリームタスクの進捗をクエリします。
`ListMemoryDreamTasks`	メモリードリームタスクを一覧表示します。
`ListMemoryDreamActions`	ドリームタスクが生成したアクション (提案) を一覧表示します。
`ApplyMemoryDreamActions`	ドリームタスクが提案したアクションを適用します。
`CancelMemoryDreamTask`	メモリードリームタスクをキャンセルします。

共通オブジェクト

API リクエストとレスポンスで共有されるデータ構造です。

スコープ

スコープは、メモリデータの所有権階層を定義します。

フィールド	タイプ	説明
`appId`	文字列	アプリケーションの識別子。
`tenantId`	文字列	テナントまたはユーザーの識別子。
`agentId`	文字列	エージェントの識別子。
`runId`	文字列	セッション、実行、またはタスクの識別子。

必須のスコープフィールドとワイルドカード * のサポート状況は、API によって異なります。

シナリオ	必須フィールド	*ワイルドカード `` のルール**
書き込み (`AddMemories`)	`appId`	空のフィールドには `__default__` が設定されます。ワイルドカード `*` は使用できません。
長期記憶の検索 (`SearchMemories`)	`appId` と `tenantId`	`agentId` と `runId` はワイルドカード `*` をサポートします。
短期記憶のクエリ (`ListMemoryStoreMessages`)	4 つのスコープフィールドすべて	ワイルドカード `*` は使用できません。
長期記憶エントリの取得、更新、または削除 (`GetMemory`、`UpdateMemory`、`DeleteMemory`)	4 つのスコープフィールドすべて	ワイルドカード `*` は使用できません。
一覧クエリ (`ListMemories`、`ListMemoryStoreRequests`)	`appId`	ワイルドカード `*` は各階層レベルでサポートされます。

例：

{
  "appId": "app-001",
  "tenantId": "user-001",
  "agentId": "assistant",
  "runId": "session-001"
}

メッセージ

AddMemories の messages フィールドの構造です。

フィールド	タイプ	必須	説明
`role`	文字列	はい	メッセージのロール (`user`、`assistant`、`system` など)。
`content`	文字列	はい	メッセージの内容。
`messageId`	文字列	いいえ	メッセージ ID。最大 256 文字。
`timestamp`	文字列	いいえ	RFC 3339 形式のタイムスタンプ。
`metadata`	オブジェクト	いいえ	メッセージレベルのメタデータ。キーと値は文字列でなければなりません。

メタデータ

ビジネスタグ用の文字列キーと値のペアです。検索 API は、完全一致フィルタリングにメタデータを使用します。

制約	値
リクエストあたりの最大キー数	16
最大キー長	64 文字
最大値長	1,024 文字

例：

{
  "source": "chat",
  "topic": "preference"
}

CreateMemoryStore

メモリストアを作成します。

リクエストパラメータ

フィールド	タイプ	必須	説明
`memoryStoreName`	文字列	はい	メモリストアの名前。使用できるのは英字、数字、アンダースコア (_) のみで、長さは最大 32 文字です。
`description`	文字列	いいえ	メモリストアの説明。長さは最大 1,024 文字です。
`extractInstructions`	文字列	いいえ	メモリストアのカスタムの抽出指示。長さは最大 4,096 文字です。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "description": "Long-term memory store for the agent",
  "extractInstructions": "Focus on the user's dining preferences and travel habits."
}

GetMemoryStore

メモリストアの詳細を取得します。

リクエストパラメータ

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名

リクエストの例

{
  "memoryStoreName": "agent_memory"
}

UpdateMemoryStore

メモリストアの説明またはカスタム抽出指示を更新します。

リクエストパラメータ

フィールド	タイプ	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名。
`description`	文字列	はい	新しい説明。最大長：1,024 文字。
`extractInstructions`	文字列	いいえ	新しいカスタム抽出指示。最大長：4,096 文字。値をクリアするには、空の文字列を渡します。現在の値を維持するには、このフィールドを渡さないでください。

DeleteMemoryStore

メモリストアを削除します。

警告

メモリストアを削除すると、すべてのデータが完全に削除されます。この操作は元に戻すことができません。本番環境では注意して実行してください。

リクエストパラメータ

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名。

ListMemoryStores

メモリストアを一覧表示します。

リクエストパラメータ

フィールド	型	必須	説明
`limit`	整数	任意	返される最大エントリ数。
`nextToken`	文字列	任意	次のページのページネーショントークン。

AddMemories

会話メッセージまたはテキストを書き込みます。元のメッセージは短期記憶として保存され、入力から長期記憶が抽出されます。

リクエストパラメーター

フィールド	型	必須	説明
`memoryStoreName`	string	はい	対象のメモリストア名です。
`scope`	object	はい	スコープ。書き込み操作には `appId` が必須です。ワイルドカード `*` は許可されていません。
`messages`	array	`text` と `messages` のいずれかは必須です	会話メッセージの配列です。最大： 20 メッセージ、合計 32,000 文字。
`text`	string	`messages` または `text` のいずれかが必須です	テキストコンテンツです。最大長： 32,000 文字。
`metadata`	object	いいえ	書き込みレベルのメタデータです。最大： 16 キー、64 文字のキー、1,024 文字の値。
`sync`	boolean	いいえ	メモリ抽出の完了を同期的に待機するかどうか。デフォルト： `false`。

制限の詳細については、「制限と注意点」をご参照ください。

リクエストの例：メッセージの書き込み

{
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "user-001",
    "agentId": "assistant",
    "runId": "session-001"
  },
  "messages": [
    {
      "role": "user",
      "content": "I like drinking coffee"
    },
    {
      "role": "assistant",
      "content": "OK, I'll remember that"
    }
  ],
  "metadata": {
    "source": "chat"
  },
  "sync": true
}

リクエストの例：テキストの書き込み

{
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "user-001"
  },
  "text": "The user likes coffee and prefers concise responses"
}

レスポンスフィールド

フィールド	説明
`requestId`	リクエスト ID です。
`status`	リクエストのステータス。非同期書き込みは通常 `running` を返します。
`acceptedMessages`	受け入れられたメッセージの数です。
`scope`	書き込みに使用されたスコープです。
`memoryStoreName`	メモリストア名です。
`memcellsCreated`	同期書き込み時に返される、作成されたメモリセルの数です。
`unitsCreated`	同期書き込み時に返される、作成された長期記憶メモリユニットの数です。

SearchMemories

長期記憶を検索します。

リクエストパラメーター

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	対象のメモリストア名です。
`query`	文字列	はい	クエリテキストです。
`scope`	object	はい	スコープです。`appId` と `tenantId` は必須です。`agentId` と `runId` はワイルドカード `*` をサポートします。
`topK`	int	いいえ	返す結果の数です。デフォルト： `10`。有効な値： 1～50。
`includeEvidence`	ブール値	いいえ	結果に短期記憶のソースエビデンス (`evidence` フィールド) を含めるかどうかを指定します。デフォルト： `false`。
`minSimilarity`	浮動小数点数	いいえ	類似度フィルターのしきい値です。有効な値： `0～1`。デフォルト： `0` (フィルターなし) 。値が `0` より大きい場合、正規化されたコサイン類似度がこの値より低い結果は除外されます。
`enableRerank`	ブール値	いいえ	リランキングを有効にするかどうかを指定します。デフォルト： `true`。
`metadata`	object	いいえ	完全一致のためのメタデータフィルターです。キーと値は文字列である必要があります。

topK の制限の詳細については、「制限と注意点」をご参照ください。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "user-001",
    "agentId": "*",
    "runId": "*"
  },
  "query": "What beverages does the user like",
  "topK": 5,
  "enableRerank": true,
  "includeEvidence": true,
  "metadata": {
    "source": "chat"
  }
}

レスポンスフィールド

フィールド	説明
`results`	検索結果のリストです。
`results[].unit`	長期記憶ユニットです。フィールドの定義については、次の表をご参照ください。
`results[].score`	関連性スコアです。
`results[].similarity`	クエリとメモリ間の正規化されたコサイン類似度 (`0～1`) です。この値は `minSimilarity` フィルターで使用されます。
`results[].source`	ヒットソースです。例： `ベクトル` または `ベクトル+text`。
`evidence`	`includeEvidence=true` の場合に返される短期記憶のソースエビデンスのリストです。エビデンスがない場合は `[]` を返します。各要素は `results` と同様の構造を持ちますが、`similarity` を含まず、`unit`、`score`、および `source` のみを含みます。
`scope`	クエリに使用されたスコープです。
`memoryStoreName`	メモリストア名です。

results[].unit のフィールド：

フィールド	説明
`id`	長期記憶ユニット ID です。
`conversation_key`	関連付けられた会話キーです。
`scope`	メモリが属するスコープです。オブジェクトには `appId`、`tenantId`、`agentId`、および `runId` が含まれます。
`memcell_id`	メモリセル ID です。
`unit_type`	メモリユニットのタイプです。
`text`	メモリテキストです。
`search_text`	検索に使用されるテキストです。
`source_turn_ids`	ソースメッセージ ID のリストです。
`type_label`	タイプラベルです。
`date_bucket`	日付バケットです。
`metadata_json`	JSON 文字列形式のメタデータです。
`deleted`	メモリが削除されたかどうかを示します。
`created_at`	作成時刻です。
`salience`	サリエンススコアです。
`version`	バージョン番号です。

ListMemories

長期メモリを一覧表示します。

リクエストパラメータ

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名。
`scope`	オブジェクト	はい	スコープ。 `appId` と `tenantId` は必須です。`tenantId`、`agentId`、`runId` はワイルドカード `*` に対応しています。
`limit`	整数	いいえ	返される最大エントリ数。
`nextToken`	文字列	いいえ	次のページのページネーショントークン。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "*",
    "agentId": "*",
    "runId": "*"
  },
  "limit": 20
}

GetMemory

長期記憶エントリを取得します。

リクエストパラメーター

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名。
`memoryId`	文字列	はい	メモリ ID。
`scope`	オブジェクト	はい	スコープは、4 つのフィールドすべてが必須です。ワイルドカード `*` は使用できません。

UpdateMemory

長期記憶エントリを更新します。text または metadata の少なくとも 1 つを指定します。

リクエストパラメーター

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名。
`memoryId`	文字列	はい	メモリ ID。
`scope`	オブジェクト	はい	スコープ全体。4 つのフィールドはすべて必須です。ワイルドカード `*` は使用できません。
`text`	文字列	いいえ	新しいメモリテキスト。
`metadata`	オブジェクト	いいえ	新しいメタデータ。

DeleteMemory

長期記憶のメモリエントリを削除します。

警告

長期記憶のメモリエントリを削除すると元に戻すことはできません。本番環境では注意して実行してください。

リクエストパラメータ

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名です。
`memoryId`	文字列	はい	メモリ ID です。
`scope`	オブジェクト	はい	完全なスコープです。4 つのフィールドはすべて必須です。ワイルドカード `*` は使用できません。

ListMemoryStoreMessages

短期記憶 (元の会話メッセージ) をクエリします。

リクエストパラメータ

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名。
`scope`	オブジェクト	はい	完全なスコープには、4つのフィールドがすべて必須です。ワイルドカード `*` は使用できません。
`limit`	整数	いいえ	返されるエントリの最大数。
`nextToken`	文字列	いいえ	次のページのページネーショントークン。
`minTimestamp`	文字列	いいえ	RFC 3339 フォーマットの最も早い時刻。
`maxTimestamp`	文字列	いいえ	RFC 3339 フォーマットの最も遅い時刻。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "user-001",
    "agentId": "assistant",
    "runId": "session-001"
  },
  "limit": 100
}

レスポンスの例

{
  "session": {
    "scope": { "appId": "app-001", "tenantId": "user-001", "agentId": "assistant", "runId": "session-001" },
    "messages": [
      {
        "messageId": "d0d9dd778a27e8cde773a243a5bab13c",
        "role": "user",
        "speaker": "user",
        "content": "[10:00 AM on 13 May, 2026] From now on, always book me a window seat when I travel for business.",
        "timestamp": "2026-05-13T10:00:00Z",
        "metadata": { "channel": "chat", "source": "chat" }
      }
    ]
  }
}

メモリストアは存在するが Scope のメッセージが存在しない場合、操作は 200 と空の messages リストを返します。

ListMemoryStoreRequests

メモリストアへのリクエストに関する監査レコードをクエリします。

リクエストパラメーター

フィールド	型	必須	説明
`memoryStoreName`	文字列	必須	メモリストア名です。
`scope`	オブジェクト	必須	スコープ。ワイルドカード `*` は、各階層レベルでサポートされています。
`operation`	文字列	任意	`AddMemories` や `SearchMemories` などの操作名。
`limit`	整数	任意	最大エントリ数です。
`nextToken`	文字列	任意	次のページを取得するためのページネーショントークンです。
`minTimestamp`	文字列	任意	RFC 3339 フォーマットの最も早い時刻です。
`maxTimestamp`	文字列	任意	RFC 3339 フォーマットの最も遅い時刻です。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "scope": {
    "appId": "app-001",
    "tenantId": "*",
    "agentId": "*",
    "runId": "*"
  },
  "operation": "AddMemories",
  "limit": 50
}

レスポンスフィールド

フィールド	説明
`requestId`	リクエスト ID です。
`operation`	オペレーション名です。
`scope`	リクエストで使用したスコープです。
`requestSummary`	リクエストサマリーです。
`responseStatus`	レスポンスステータスです。
`latencyMs`	処理レイテンシー (ミリ秒) です。
`targetId`	オペレーションのターゲット ID です (メモリ ID など)。
`createdAt`	レコードの作成時刻です。

GetMemoryTask

インジェストタスクのステータスと結果をクエリします。AddMemories が返す requestId を渡してください。

リクエストパラメータ

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名です。
`requestId`	文字列	はい	`AddMemories` が返すリクエスト ID です。
`scope`	オブジェクト	いいえ	タスクのスコープを検証します。任意のレベルでワイルドカード `*` を使用できます。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "requestId": "4b41a912f8c8a66202896e880a505d4a"
}

レスポンスの例

{
  "memoryStoreName": "agent_memory",
  "task": {
    "requestId": "4b41a912f8c8a66202896e880a505d4a",
    "eventType": "ingest",
    "memoryStoreName": "agent_memory",
    "conversationKey": "app-001/user-001/assistant/session-001",
    "scope": { "appId": "app-001", "tenantId": "user-001", "agentId": "assistant", "runId": "session-001" },
    "status": "completed",
    "acceptedMessages": 2,
    "derivedMemcellId": "b1bb4faec235b0d55bc8830da8ffa9f2",
    "derivedUnitIds": ["88432eb9d28e0787791625da916d6a20", "480230ab0806e88fd69e0804599552a4"],
    "createdAt": "2026-06-17T07:19:59.962Z",
    "updatedAt": "2026-06-17T07:20:08.749Z",
    "finishedAt": "2026-06-17T07:20:08.749Z"
  }
}

タスクの status の有効値： queued、running、completed、failed、needs_reconcile。最初の書き込み後にインジェストタスクのインデックスが構築されている間、この API は 409 CONFLICT (ingest task index is still building, please retry shortly) を返す場合があります。短い遅延の後にリクエストをリトライしてください。

ListMemoryTasks

非同期抽出タスクを一覧表示します。レスポンスでは、tasks 配列にタスクオブジェクトが返されます。各要素は、GetMemoryTask レスポンスの task フィールドと同じ構造です。

リクエストパラメーター

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名です。
`scope`	オブジェクト	はい	スコープです。任意のレベルでワイルドカード `*` を使用できます。
`status`	文字列	いいえ	タスクをステータス (`queued` (キューに登録済み)、`running` (実行中)、`completed` (完了)、`failed` (失敗)、または `needs_reconcile` (調整が必要)) でフィルタリングします。
`limit`	整数	いいえ	返される最大エントリ数です。デフォルト： `50`。最大： `100`。
`nextToken`	文字列	いいえ	次のページのページネーショントークンです。
`minTimestamp`	文字列	いいえ	最も早い時刻をミリ秒単位の UNIX タイムスタンプで指定します (RFC 3339 はサポートされていません)。
`maxTimestamp`	文字列	いいえ	最も遅い時刻をミリ秒単位の UNIX タイムスタンプで指定します (RFC 3339 はサポートされていません)。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "scope": { "appId": "app-001", "tenantId": "user-001", "agentId": "assistant", "runId": "session-001" },
  "limit": 5
}

ListMemoryStoreScopes

メモリストアに存在するスコープの一覧を取得します。この API を使用して、特定のアプリケーションまたはテナント配下で、どのエージェントとセッションがメモリを生成したかを確認できます。

リクエストパラメータ

Field	Type	Required	Description
`memoryStoreName`	文字列	Yes	メモリストア名。
`scope`	オブジェクト	Yes	スコープ。任意の階層レベルでワイルドカード `*` を使用できます。
`limit`	整数	No	返す最大エントリ数。デフォルト： `100`。最大： `100`。
`nextToken`	文字列	No	次ページ用のページネーショントークン。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "scope": { "appId": "app-001", "tenantId": "*", "agentId": "*", "runId": "*" },
  "limit": 10
}

レスポンスの例

{
  "memoryStoreName": "agent_memory",
  "scope": { "appId": "app-001", "tenantId": "*", "agentId": "*", "runId": "*" },
  "scopes": [
    { "appId": "app-001", "tenantId": "user-001", "agentId": "__default__", "runId": "__default__" },
    { "appId": "app-001", "tenantId": "user-001", "agentId": "assistant", "runId": "session-001" }
  ]
}

CreateMemoryDreamTask

書き込まれたメモリに対して二次リファインメント、マージ、およびスキルまたはプロファイルの抽出を実行するメモリドリームタスクを作成します。タスクは非同期に実行されます。

リクエストパラメーター

フィールド	型	必須	説明
`memoryStoreName`	string	はい	メモリストア名です。
`scopes`	array	はい	整理するスコープのリストです。最大 20 スコープ。
`taskType`	string	いいえ	タスクタイプ: `memory` (デフォルト)、`skill`、または `profile`。
`applyMode`	string	いいえ	適用モードは `proposal` (デフォルト、提案のみを生成) または `safe_auto` (安全なアクションを自動的に適用) で、`taskType=memory` の場合にのみサポートされます。
`scopeOutputMode`	string	いいえ	結果の帰属モード: `preserve_scope` (デフォルト) または `promote_scope`。
`confidenceThresholds`	object	いいえ	アクション `add`、`update`、および `merge` をキーとする自動適用の信頼度のしきい値。有効な値: `0 to 1`。
`minTimestamp / maxTimestamp`	string	いいえ	整理のための時間範囲。ミリ秒単位の UNIX タイムスタンプとして指定します (RFC 3339 形式はサポートされていません)。なお、レスポンス本文のタイムスタンプは RFC 3339 形式で返されます。
`maxSessions / maxMessages / maxMemories`	int	いいえ	最大入力スケール。有効な範囲については、制限に関するドキュメントをご参照ください。
`expandedScopeLimit`	int	いいえ	展開されたスコープの最大数。有効範囲: `0～1000`。
`instructions`	string	いいえ	カスタムの整理指示。最大長： 4,000 文字。
`incremental`	boolean	いいえ	増分整理を実行するかどうかを指定します。デフォルト: `false` (完全整理)。 true に設定すると、タスクは最後に成功した位置から再開されます。
`clientToken`	string	いいえ	べき等性トークンです。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "scopes": [ { "appId": "app-001", "tenantId": "user-001" } ],
  "taskType": "memory",
  "applyMode": "proposal"
}

レスポンスの例

{
  "memoryStoreName": "agent_memory",
  "dreamId": "2a528008111f5dc3500c73fd965089f7",
  "status": "queued",
  "createdAt": "2026-06-17T07:21:25.329Z"
}

GetMemoryDreamTask

メモリドリームタスクの進捗と結果の概要を照会します。

リクエストパラメータ

フィールド	タイプ	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名です。
`dreamId`	文字列	はい	ドリームタスクの ID です。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "dreamId": "2a528008111f5dc3500c73fd965089f7"
}

レスポンスの例

{
  "memoryStoreName": "agent_memory",
  "dreamId": "2a528008111f5dc3500c73fd965089f7",
  "taskType": "memory",
  "applyMode": "proposal",
  "scopeOutputMode": "preserve_scope",
  "status": "completed",
  "actions": { "total": 2, "proposed": 2, "applied": 0, "skipped": 0, "failed": 0 },
  "input": { "scopes": [ { "appId": "app-001", "tenantId": "user-001", "agentId": "__default__", "runId": "__default__" } ], "sessionCount": 1, "messageCount": 1, "memoryCount": 2, "incremental": false },
  "lastError": "",
  "createdAt": "2026-06-17T07:21:25.329Z",
  "updatedAt": "2026-06-17T07:21:32.276Z",
  "finishedAt": "2026-06-17T07:21:32.276Z"
}

タスク status の有効な値は、queued、running、planning、applying、completed、completed_with_failures、failed、および cancelled です。

ListMemoryDreamTasks

メモリドリームタスクを一覧表示します。レスポンスは、tasks 配列内にタスクオブジェクトを返します。各要素には、dreamId、status、taskType、actionCount、proposedCount、confidenceThresholds、createdAt などのフィールドが含まれます。

リクエストパラメーター

フィールド	タイプ	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名です。
`scope`	オブジェクト	はい	スコープです。任意のレベルでワイルドカード `*` を使用できます。
`status`	文字列	いいえ	タスクをフィルタリングするためのタスクステータスです。
`limit`	整数	いいえ	返される最大エントリ数です。デフォルト： `50`。最大： `100`。
`nextToken`	文字列	いいえ	ページネーショントークンです。
`minTimestamp / maxTimestamp`	文字列	いいえ	ミリ秒単位の UNIX タイムスタンプで時間範囲を指定します (RFC 3339 はサポートされていません)。

リクエスト例

{
  "memoryStoreName": "agent_memory",
  "scope": { "appId": "app-001", "tenantId": "*", "agentId": "*", "runId": "*" },
  "limit": 10
}

ListMemoryDreamActions

メモリドリームタスクが生成したアクション (提案) を一覧表示します。

リクエストパラメーター

フィールド	タイプ	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名です。
`dreamId`	文字列	いいえ	`scope` とは相互排他的な dream タスクの ID です。
`scope`	オブジェクト	いいえ	スコープによるクエリ。このパラメーターは `dreamId` と相互に排他的です。 `scope` を使用する場合、`actionType` が必須となり、`EMIT_SKILL` と `EMIT_PROFILE` のみがサポートされます。
`status`	文字列	いいえ	アクションステータスでフィルタリングします: `proposed`、`applied`、`skipped`、または `failed`。
`action`	文字列	いいえ	アクションタイプ別にフィルタリング：`ADD`、`UPDATE`、`DELETE`、`MERGE`、または `NOOP`。
`minConfidence / maxConfidence`	浮動小数点数	いいえ	信頼度でフィルタリングします。有効値: `0～1`。
`orderBy`	文字列	いいえ	ソート順: `created_at_asc` (デフォルト)、`created_at_desc`、または `confidence_desc`。
`limit`	整数	いいえ	返すエントリの最大数。デフォルト： `100`。最大値： `100`。
`nextToken`	文字列	いいえ	次のページのページネーショントークンです。

リクエスト例

{
  "memoryStoreName": "agent_memory",
  "dreamId": "2a528008111f5dc3500c73fd965089f7",
  "limit": 20
}

レスポンス例

{
  "memoryStoreName": "agent_memory",
  "dreamId": "2a528008111f5dc3500c73fd965089f7",
  "actions": [
    {
      "dreamId": "2a528008111f5dc3500c73fd965089f7",
      "actionId": "968768529cdfde8d56686a71e1c28227",
      "action": "UPDATE",
      "status": "proposed",
      "targetScope": { "appId": "app-001", "tenantId": "user-001", "agentId": "__default__", "runId": "__default__" },
      "targetMemoryId": "d16fd038835d89ae8586f7814e5256c1",
      "newMemory": { "text": "User prefers concise responses.", "unitType": "atomic_fact" },
      "reason": "Rewritten as a more precise atomic_fact statement.",
      "confidence": 0.95,
      "createdAt": "2026-06-17T07:21:32.161Z"
    }
  ]
}

2 つのクエリモードは相互に排他的です。dreamId でクエリすると、タスク配下のすべてのアクションが返されます。scope と actionType (EMIT_SKILL または EMIT_PROFILE のみ) でクエリすると、その範囲内で蓄積されたスキルまたはプロファイルが返されます。

ApplyMemoryDreamActions

メモリ dream タスクによって生成された提案アクションを適用します (applyMode=proposal の場合)。

リクエストパラメータ

フィールド	型	必須	説明
`memoryStoreName`	文字列	はい	メモリストアの名前。
`dreamId`	文字列	はい	dream タスクの ID。
`actionIds`	配列	はい	適用するアクション ID のリスト。このリストを空にすることはできません。1 回のリクエストでは、最大 100 個のアクション ID をサポートします。
`applier`	文字列	いいえ	アプライヤーの識別子。この値は監査ログに記録されます。

リクエストの例

{
  "memoryStoreName": "agent_memory",
  "dreamId": "2a528008111f5dc3500c73fd965089f7",
  "actionIds": ["968768529cdfde8d56686a71e1c28227", "a0f4715245920ea7b6a34c1828c6f1ae"]
}

レスポンスの例

{
  "memoryStoreName": "agent_memory",
  "dreamId": "2a528008111f5dc3500c73fd965089f7",
  "applied": 2,
  "failed": 0,
  "results": [
    { "actionId": "968768529cdfde8d56686a71e1c28227", "status": "applied", "memoryId": "bd14a67ed215c114896325d912c8fa71" },
    { "actionId": "a0f4715245920ea7b6a34c1828c6f1ae", "status": "applied", "memoryId": "fa253856113f78d51a3b84a1fdf2d110" }
  ]
}

EMIT_SKILL と EMIT_PROFILE アクションは、dream タスクによって直接書き込まれるため、手動適用フローはありません。これらのタイプのアクション ID を含めると、リクエストは拒否されます。actionIds が空の配列の場合、リクエストは 403 を返します。

CancelMemoryDreamTask

完了していないメモリドリームタスクをキャンセルします。

リクエストパラメータ

フィールド	タイプ	必須	説明
`memoryStoreName`	文字列	はい	メモリストア名。
`dreamId`	文字列	はい	ドリームタスクのID。

リクエスト例

{
  "memoryStoreName": "agent_memory",
  "dreamId": "2a528008111f5dc3500c73fd965089f7"
}

レスポンス例

{
  "memoryStoreName": "agent_memory",
  "dreamId": "2a528008111f5dc3500c73fd965089f7",
  "status": "cancelled",
  "taskType": "memory"
}

完了していないタスクのみキャンセルできます。すでに終端状態 (completed、failed、または cancelled) に達したタスクについては、レスポンスは元の status 値のまま 200 を返しますが、タスク自体は変更されません。