翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AgentCore メモリを作成する
AgentCore Memory は、AgentCore CLI、 AWS コンソール、または CreateMemory AWS SDK オペレーションを使用して作成できます。メモリを作成するときは、名前、説明、暗号化設定、raw イベントの有効期限タイムスタンプ、長期メモリを抽出する場合のメモリ戦略などの設定を行うことができます。
AgentCore メモリを作成するときは、アプリケーションのニーズを満たすように以下の要素を考慮してください。
イベント保持 — 短期メモリの raw イベントを保持する期間 (最大 365 日) を選択します。
eventExpiryDuration は、書き込み時にイベントごとに適用されます。更新は、変更後に作成されたイベントにのみ影響します。以前に保存されたイベントは元の有効期限を保持し、延長できず、期限切れのイベントは復元できません。
長期メモリレコード保持 (time-to-live) – 必要に応じて、抽出された長期メモリレコードの有効期限を選択します。戦略ごとに、戦略の 内で recordExpiryDurationDays (最低 31 日間) 設定しますrecordExpirySpecification。設定しない場合、その戦略によって生成されたレコードは期限切れになりません。レコードtime-to-liveを設定または削除するには、 アクセスbedrock-agentcore:UpdateMemoryRecordExpirySpecification許可が必要です。詳細については、「長期メモリレコードの有効期限を設定するtime-to-live」を参照してください。
セキュリティ要件 – アプリケーションが機密情報を処理する場合は、暗号化にカスタマーマネージド KMS AWS キーを使用することを検討してください。このサービスは、カスタマーマネージド KMS AWS キーを指定しない場合でも、サービスマネージドキーを使用してデータを暗号化します。
メモリ戦略 – 組み込みまたは上書き戦略を備えた組み込みを使用して、イベントを意味のある長期メモリに処理する方法を定義します。戦略を定義しない場合、raw イベントを含む短期メモリのみが保存されます。詳細については、「長期メモリの使用」を参照してください。
命名規則 – 特にアプリケーションが複数のストアを使用している場合は、各 AgentCore メモリの目的を特定するのに役立つ明確でわかりやすい名前を使用します。
例
- AgentCore CLI
-
-
AgentCore CLI メモリコマンドは、既存のエージェントコアプロジェクト内で実行する必要があります。まだプロジェクトを作成していない場合は、まずプロジェクトを作成します。
agentcore create --project-name MemoryProject --no-agent
cd MemoryProject
基本メモリを作成する (短期のみ):
agentcore add memory --name my_agent_memory
agentcore deploy
長期戦略を使用してメモリを作成します。
agentcore add memory --name ShoppingSupportAgentMemory \
--strategies SUMMARIZATION,USER_PREFERENCE
agentcore deploy
メモリステータスを確認します。
agentcore status
- Interactive
-
-
agentcore を実行して TUI を開き、追加を選択してメモリ を選択します。
-
メモリ名を入力します。
-
イベントの有効期限を選択します。
-
長期メモリ抽出のメモリ戦略を選択します。
-
設定を確認し、Enter キーを押して以下を確認します。
- AWS SDK
-
-
詳細については、「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
-
-
====== AgentCore メモリを作成するには
-
Amazon Bedrock AgentCore コンソールを開きます。
-
左側のナビゲーションペインで、メモリを選択します。
-
メモリの作成 を選択します。
-
メモリ名 に AgentCore メモリの名前を入力します。
-
(オプション) 短期メモリ (raw イベント) の有効期限には、AgentCore メモリがイベントを保存する期間 (日) を設定します。
-
(オプション) 追加設定では、以下を設定します。
-
メモリの説明 に、AgentCore メモリの説明を入力します。
-
独自の AWS KMS キーを使用してデータを暗号化する場合は、次の操作を行います。
-
KMS キー で、暗号化設定をカスタマイズ (アドバンスド) を選択します。
-
「KMS AWS キーを選択する」で、既存の KMS キーの ARN AWS を選択または入力します。または、KMS の作成 を選択して新しい AWS KMS AWS キーを作成します。
-
(オプション) 長期メモリ抽出戦略では、1 つ以上のメモリ戦略 を選択します。詳細については:
-
AgentCoreメモリを作成するには、メモリの作成を選択します。