Tablestore:Memory store operations

メモリストアの作成

tablestore-agent-cli memory create --store agent_memory --description "Long-term memory store"

configure set memory_store_name でデフォルトのメモリストア名を設定している場合は、--store を省略できます：

tablestore-agent-cli configure set memory_store_name agent_memory
tablestore-agent-cli memory create --description "Long-term memory store"

メモリストアの一覧表示

tablestore-agent-cli memory ls
tablestore-agent-cli memory list --limit 50 --next-token <token>

memory ls は memory list のエイリアスです。ページネーションの動作については、「ページネーション」をご参照ください。

メモリストアの表示

tablestore-agent-cli memory describe --store agent_memory
tablestore-agent-cli memory show --store agent_memory

memory show は memory describe のエイリアスです。

説明の更新

tablestore-agent-cli memory update --store agent_memory --description "New description"

メモリストアの削除

tablestore-agent-cli memory delete --store agent_memory   # TTY で確認を求められます
tablestore-agent-cli memory rm --store agent_memory -y    # 確認をスキップします

memory rm は memory delete のエイリアスです。

単一テキストメモリの書き込み

tablestore-agent-cli memory add --store agent_memory --app-id app-001 --text "The user likes mapo tofu"

抽出完了まで同期的に待機

デフォルトでは、書き込みコマンドは非同期で返されます。メモリ抽出が完了するまでブロックするには、--sync フラグを追加してください：

tablestore-agent-cli memory add --store agent_memory --app-id app-001 --text "The user prefers Sichuan cuisine" --sync

JSON ファイルからのバッチ書き込み

tablestore-agent-cli memory add --store agent_memory --app-id app-001 --messages-file ./messages.json

messages.json には JSON 配列を含める必要があります。

メタデータの付与

tablestore-agent-cli memory add --store agent_memory --app-id app-001 --text "The user prefers Sichuan cuisine" --metadata '{"source":"chat","confidence":"high"}'

パラメータ

基本検索

tablestore-agent-cli memory search --store agent_memory --app-id app-001 --tenant-id tenant-001 --query "What food does the user like" --top-k 5

再ランキングの無効化

tablestore-agent-cli memory search --store agent_memory --app-id app-001 --tenant-id tenant-001 --query "user preferences" --disable-rerank

メタデータによるフィルタリング

tablestore-agent-cli memory search --store agent_memory --app-id app-001 --tenant-id tenant-001 --query "user preferences" --metadata '{"source":{"equals":"chat"}}'

レスポンス例

{"items":[{"memory":{"id":"mem-001","text":"The user likes mapo tofu"},"score":0.91}],"totalCount":1}

パラメータ

メモリユニットの一覧表示

tablestore-agent-cli memory list-units --store agent_memory --app-id app-001
tablestore-agent-cli memory ls-units --store agent_memory --app-id app-001 --limit 20 --next-token <token>

memory ls-units は memory list-units のエイリアスです。ページネーションの動作については、「ページネーション」をご参照ください。

メモリユニットの表示

tablestore-agent-cli memory get --store agent_memory --memory-id mem-001 --app-id app-001
tablestore-agent-cli memory cat --store agent_memory --memory-id mem-001 --app-id app-001

memory cat は memory get のエイリアスです。

メモリユニットの更新

# テキストを更新します
tablestore-agent-cli memory update-unit --store agent_memory --memory-id mem-001 --app-id app-001 --text "The user strongly prefers spicy food"

# メタデータを更新します
tablestore-agent-cli memory update-unit --store agent_memory --memory-id mem-001 --app-id app-001 --metadata '{"confidence":"very_high"}'

--text または --metadata の少なくとも 1 つを指定してください。

メモリユニットの削除

tablestore-agent-cli memory delete-unit --store agent_memory --memory-id mem-001 --app-id app-001
tablestore-agent-cli memory rm-unit --store agent_memory --memory-id mem-001 --app-id app-001 -y

memory rm-unit は memory delete-unit のエイリアスです。

RAW メッセージレコードの表示

tablestore-agent-cli memory msg-list --store agent_memory --app-id app-001
tablestore-agent-cli memory ls-msgs --store agent_memory --app-id app-001

memory ls-msgs は memory msg-list のエイリアスです。

リクエスト監査レコードの表示

tablestore-agent-cli memory req-list --store agent_memory --app-id app-001
tablestore-agent-cli memory req-list --store agent_memory --app-id app-001 --operation AddMemories
tablestore-agent-cli memory ls-reqs --store agent_memory --app-id app-001

memory ls-reqs は memory req-list のエイリアスです。--operation を使用して、AddMemories や SearchMemories などのオペレーションタイプでフィルタリングできます。

パラメータ