すべてのプロダクト
Search
ドキュメントセンター

Tablestore:最初のメモリの書き込みとリコール

最終更新日:Oct 22, 2026

このクイックスタートでは、AgentStorage Python SDK を使用して構造化されたメモリストアを作成し、会話をそこに書き込み、サービスが抽出した長期記憶をリコールします。次に、セッションをまたいでそれらのメモリを検索し、その結果をエージェントに渡します。

前提条件

  • AgentStorage インスタンスを作成済みであること。このクイックスタートでは、そのインスタンス内にメモリストアを作成します。

  • AgentStorage インスタンス名、エンドポイント、API キー。ステップ 2 でクライアントを初期化するために、これらの値を使用します。

ステップ 1:SDK のインストール

次のコマンドを実行して、AgentStorage Python SDK をインストールします:

pip install "tablestore-agent-storage>=1.0.10"

ステップ 2:クライアントとメモリストアの作成

AgentStorage の認証情報を使用してクライアントを初期化し、agent_memory という名前のメモリストアを作成します:

from tablestore_agent_storage import AgentStorageClient

client = AgentStorageClient(
    api_key="<your-api-key>",
    ots_endpoint="https://<instance>.<region>.ots.aliyuncs.com",
    ots_instance_name="<instance-name>",
)

client.create_memory_store({
    "memoryStoreName": "agent_memory",
    "description": "Agent long-term memory",
})

<your-api-key>、<instance>、<region>、<instance-name> を、お使いの API キー、および AgentStorage インスタンスの名前とリージョンに置き換えます。

重要

メモリストアタイプを指定しない場合、サービスはメッセージを入力として受け取り、構造化されたメモリを出力するメモリストアを作成します。出力を明示的に選択するには、inputType と outputTypes を設定してください。メモリストアの作成後に inputType を変更することはできません。

ステップ 3:メッセージの書き込み

add_memories を呼び出して、会話をメモリストアに書き込みます:

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

response = client.add_memories({
    "memoryStoreName": "agent_memory",
    "scope": scope,
    "messages": [
        {"role": "user", "content": "I usually drink Americanos without sugar."},
        {"role": "assistant", "content": "Got it. I will remember your drink preference."},
    ],
    "sync": True,
})
print(response.get("memoryIds", []))

scope の各フィールドは会話の位置を特定します。appId はアプリケーション、tenantId はユーザー、agentId はエージェント、runId はセッションを識別します。サービスは最初に元のメッセージを保存し、その後、それらから長期記憶を抽出します。この例では sync=True を設定しているため、結果をすぐに確認できます。同期書き込みが完了すると、応答内の memoryIds 配列に、生成された長期記憶の ID が返されます。

出力された memoryIds 配列が空ではないことを確認してください。配列が空でない場合、サービスが会話から長期記憶を抽出したことを示します。配列が空の場合、長期記憶は生成されていません。

本番環境では、デフォルトの非同期モードを使用し、応答内の requestId を使用して抽出タスクをクエリしてください。

ステップ 4:セッションをまたいだ長期記憶の検索

会話から抽出された長期記憶を、メモリストアで検索します:

response = client.search_memories({
    "memoryStoreName": "agent_memory",
    "scope": {
        "appId": "shopping-app",
        "tenantId": "user-001",
        "agentId": "shopping-assistant",
        "runId": "*",
    },
    "query": "What are the user's coffee preferences?",
    "topK": 5,
})

for item in response.get("results", []):
    print(f"[{item['score']:.4f}] {item['unit']['text']}")

runId を * に設定すると、同一のアプリケーション、ユーザー、エージェントに対してセッションをまたいで検索します。スクリプトは、results 内の各メモリについて、関連性スコアとテキストを出力します。結果にステップ 3 で書き込んだ飲み物の好みが含まれていれば、メモリが正常にリコールされたことを意味します。

説明

インデックスの更新により、短い遅延が発生する場合があります。同期書き込み直後の最初の検索で結果が返されない場合は、しばらく待ってから再試行してください。

ステップ 5:結果のエージェントへの受け渡し

現在のタスクに関連する少数のメモリのみをモデルコンテキストに含めてください:

既知のユーザー設定:
- ユーザーは通常、砂糖なしのアメリカーノを飲みます。

これらの設定に基づいて現在の質問に回答してください。メモリが現在のリクエストと競合する場合は、ユーザーが現在のターンで明示的に述べた内容を優先してください。
  • メモリストア全体をプロンプトに連結しないでください。

  • 修正および監査のために、各結果のメモリ ID、スコープ、スコアを保持してください。

詳細情報

  • 短期メッセージ、長期記憶、スコープ、非同期タスクについては、「Memory Storage Service」をご参照ください。

  • TypeScript、CLI、またはダッシュボードでメモリの書き込みとリコールを行う方法については、「AgentStorage SDK」と「コマンドラインツール」をご参照ください。