View a markdown version of this page

AgentCore メモリを作成する - Amazon Bedrock AgentCore

AgentCore メモリを作成する

AgentCore Memory は、AgentCore CLI、 AWS コンソール、または CreateMemory AWS SDK オペレーションを使用して作成できます。メモリを作成するときは、名前、説明、暗号化設定、raw イベントの有効期限タイムスタンプ、長期メモリを抽出する場合のメモリ戦略などの設定を行うことができます。

AgentCore メモリを作成するときは、アプリケーションのニーズを満たすように以下の要素を考慮してください。

イベント保持 — 短期メモリの raw イベントを保持する期間 (最大 365 日) を選択します。

注記

eventExpiryDuration は、書き込み時にイベントごとに適用されます。更新は、変更後に作成されたイベントにのみ影響します。以前に保存されたイベントは元の有効期限を保持し、延長できず、期限切れのイベントは復元できません。

セキュリティ要件 – アプリケーションが機密情報を処理する場合は、暗号化にカスタマーマネージド KMS AWS キーを使用することを検討してください。このサービスは、カスタマーマネージド KMS AWS キーを指定しない場合でも、サービスマネージドキーを使用してデータを暗号化します。

メモリ戦略 – 組み込みまたは上書き戦略を備えた組み込みを使用して、イベントを意味のある長期メモリに処理する方法を定義します。戦略を定義しない場合、raw イベントを含む短期メモリのみが保存されます。詳細については、「長期メモリの使用」を参照してください。

命名規則 – 特にアプリケーションが複数のストアを使用している場合は、各 AgentCore メモリの目的を特定するのに役立つ明確でわかりやすい名前を使用します。

例
AgentCore CLI

  1. AgentCore CLI メモリコマンドは、既存のエージェントコアプロジェクト内で実行する必要があります。まだプロジェクトを作成していない場合は、まずプロジェクトを作成します。

    agentcore create --name my-agent --no-agent
cd my-agent

    基本メモリを作成する (短期のみ):

    agentcore add memory --name my_agent_memory
agentcore deploy

    長期戦略を使用してメモリを作成します。

    agentcore add memory --name ShoppingSupportAgentMemory \
  --strategies SUMMARIZATION,USER_PREFERENCE
agentcore deploy

    メモリステータスを確認します。

    agentcore status
Interactive

  1. agentcore を実行して TUI を開き、追加 を選択してメモリ を選択します。

  2. メモリ名を入力します。

    メモリウィザード: 名前を入力

  3. イベントの有効期限を選択します。

    メモリウィザード: イベントの有効期限を選択する

  4. 長期メモリ抽出のメモリ戦略を選択します。

    メモリウィザード: メモリ戦略の選択

  5. 設定を確認し、Enter キーを押して以下を確認します。

    メモリウィザード: 設定の確認
AWS SDK

  1. 詳細については、「AWS SDK」をご参照ください。

    import boto3
import time

# Initialize the Boto3 clients for control plane and data plane operations
control_client = boto3.client('bedrock-agentcore-control')
data_client = boto3.client('bedrock-agentcore')

print("Creating a new memory resource...")

# Create the memory resource with defined strategies
response = control_client.create_memory(
    name="ShoppingSupportAgentMemory",
    description="Memory for a customer support agent.",
    memoryStrategies=[
        {
            'summaryMemoryStrategy': {
                'name': 'SessionSummarizer',
                'namespaceTemplates': ['/summaries/{actorId}/{sessionId}/']
            }
        },
        {
            'userPreferenceMemoryStrategy': {
                'name': 'UserPreferenceExtractor',
                'namespaceTemplates': ['/users/{actorId}/preferences/']
            }
        }
    ]
)

memory_id = response['memory']['id']
print(f"Memory resource created with ID: {memory_id}")

# Poll the memory status until it becomes ACTIVE
while True:
    mem_status_response = control_client.get_memory(memoryId=memory_id)
    status = mem_status_response.get('memory', {}).get('status')
    if status == 'ACTIVE':
        print("Memory resource is now ACTIVE.")
        break
    elif status == 'FAILED':
        raise Exception("Memory resource creation FAILED.")
    print("Waiting for memory to become active...")
    time.sleep(10)
Console

  1. ====== AgentCore メモリを作成するには

  2. Amazon Bedrock AgentCore コンソールを開きます。

  3. 左側のナビゲーションペインで、メモリを選択します。

  4. メモリの作成 を選択します。

  5. メモリ名 に AgentCore メモリの名前を入力します。

  6. (オプション) 短期メモリ (raw イベント) の有効期限には、AgentCore メモリがイベントを保存する期間 (日数) を設定します。

  7. (オプション) 追加設定では、以下を設定します。

    1. メモリの説明 に、AgentCore メモリの説明を入力します。

    2. 独自の AWS KMS キーを使用してデータを暗号化する場合は、次の操作を行います。

      1. KMS キー で、暗号化設定をカスタマイズ (詳細) を選択します。

      2. 「KMS AWS キーを選択する」で、既存の KMS キーの ARN AWS を選択または入力します。または、KMS の作成 を選択して新しい AWS KMS AWS キーを作成します。

  8. (オプション) 長期メモリ抽出戦略では、1 つ以上のメモリ戦略 を選択します。詳細については:

  9. AgentCoreメモリを作成するには、メモリの作成を選択します。

トピック