AWS bedrock-agentcore documentation change
Summary
Updated documentation to replace references to the deprecated 'Amazon Bedrock AgentCore starter toolkit' and 'AgentCore python SDK' with the new 'AgentCore CLI' and interactive TUI (Terminal User Interface) for creating and managing memory stores. The examples have been completely rewritten to reflect the new CLI commands and TUI workflow.
Security assessment
The changes are purely documentation updates related to tooling and user interface workflows. There is no mention of security vulnerabilities, patches, or incident response. The existing mention of 'encryption settings' remains unchanged, indicating no new security features were added. The changes are focused on usability and reflect a shift in the recommended tools for interacting with the service.
Diff
diff --git a/bedrock-agentcore/latest/devguide/memory-create-a-memory-store.md b/bedrock-agentcore/latest/devguide/memory-create-a-memory-store.md index 6251cbc93..ed1498d5d 100644 --- a//bedrock-agentcore/latest/devguide/memory-create-a-memory-store.md +++ b//bedrock-agentcore/latest/devguide/memory-create-a-memory-store.md @@ -7 +7 @@ -You can create an AgentCore Memory with the Amazon Bedrock AgentCore starter toolkit, AgentCore python SDK, the AWS console, or with the [CreateMemory](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateMemory.html) AWS SDK operation. When creating a memory, you can configure settings such as name, description, encryption settings, expiration timestamp for raw events, and memory strategies if you want to extract long-term memory. +You can create an AgentCore Memory with the AgentCore CLI, the AWS console, or with the [CreateMemory](https://docs.aws.amazon.com/bedrock-agentcore-control/latest/APIReference/API_CreateMemory.html) AWS SDK operation. When creating a memory, you can configure settings such as name, description, encryption settings, expiration timestamp for raw events, and memory strategies if you want to extract long-term memory. @@ -19 +19 @@ When creating an AgentCore Memory, consider the following factors to maintain it -Starter toolkit CLI +AgentCore CLI @@ -22,2 +22 @@ Starter toolkit CLI -**Create** a basic memory (short-term only): - +The AgentCore CLI memory commands must be run inside an existing agentcore project. If you don't have one yet, create a project first: @@ -25,3 +23,0 @@ Starter toolkit CLI - agentcore memory create my_agent_memory --region us-west-2 - -**Create** memory with long-term strategies: @@ -28,0 +25,2 @@ Starter toolkit CLI + agentcore create --name my-agent --no-agent + cd my-agent @@ -30,7 +28 @@ Starter toolkit CLI - agentcore memory create ShoppingSupportAgentMemory \ - --region us-west-2 \ - --description "Memory for a customer support agent." \ - --strategies '[{"summaryMemoryStrategy": {"name": "SessionSummarizer", "namespaceTemplates": ["/summaries/{actorId}/{sessionId}/"]}}, {"userPreferenceMemoryStrategy": {"name": "PreferenceLearner", "namespaceTemplates": ["/users/{actorId}/preferences/"]}}]' \ - --wait - -**List** all memories: +**Create** a basic memory (short-term only): @@ -39 +31,2 @@ Starter toolkit CLI - agentcore memory list --region us-west-2 + agentcore add memory --name my_agent_memory + agentcore deploy @@ -41 +34 @@ Starter toolkit CLI -**Get** memory details: +**Create** memory with long-term strategies: @@ -44 +37,3 @@ Starter toolkit CLI - agentcore memory get <memory-id> --region us-west-2 + agentcore add memory --name ShoppingSupportAgentMemory \ + --strategies SUMMARIZATION,USER_PREFERENCE + agentcore deploy @@ -49 +44 @@ Starter toolkit CLI - agentcore memory status <memory-id> --region us-west-2 + agentcore status @@ -51 +46 @@ Starter toolkit CLI -Starter toolkit +Interactive @@ -54 +49 @@ Starter toolkit -for the full example, see [Get started with AgentCore Memory](./memory-get-started.html). +Run `agentcore` to open the TUI, then select **add** and choose **Memory** : @@ -55,0 +51 @@ for the full example, see [Get started with AgentCore Memory](./memory-get-start + 1. Enter the memory name: @@ -57,10 +53 @@ for the full example, see [Get started with AgentCore Memory](./memory-get-start - from bedrock_agentcore_starter_toolkit.operations.memory.manager import MemoryManager - from bedrock_agentcore.memory.session import MemorySessionManager - from bedrock_agentcore.memory.constants import ConversationalMessage, MessageRole - from bedrock_agentcore_starter_toolkit.operations.memory.models.strategies import SummaryStrategy, UserPreferenceStrategy - import time - - # Create memory manager - memory_manager = MemoryManager(region_name="us-west-2") - - print("Creating a new memory resource and waiting for it to become active...") + @@ -68,15 +55 @@ for the full example, see [Get started with AgentCore Memory](./memory-get-start - # Create memory resource with summary and user preference strategy - memory = memory_manager.get_or_create_memory( - name="ShoppingSupportAgentMemory", - description="Memory for a customer support agent.", - strategies=[ - SummaryStrategy( - name="SessionSummarizer", - namespace_templates=["/summaries/{actorId}/{sessionId}/"] - ), - UserPreferenceStrategy( - name="PreferenceLearner", - namespace_templates=["/users/{actorId}/preferences/"] - ) - ] - ) + 2. Select the event expiry duration: @@ -84,2 +57 @@ for the full example, see [Get started with AgentCore Memory](./memory-get-start - memory_id = memory.get('id') - print(f"Memory resource is now ACTIVE with ID: {memory_id}") + @@ -87 +59 @@ for the full example, see [Get started with AgentCore Memory](./memory-get-start -AgentCore python SDK + 3. Choose memory strategies for long-term memory extraction: @@ -88,0 +61 @@ AgentCore python SDK + @@ -90 +63 @@ AgentCore python SDK -For more information, see [Amazon Bedrock AgentCore SDK](./agentcore-sdk-memory.html). + 4. Review the configuration and press Enter to confirm: @@ -91,0 +65 @@ For more information, see [Amazon Bedrock AgentCore SDK](./agentcore-sdk-memory. + @@ -93,2 +66,0 @@ For more information, see [Amazon Bedrock AgentCore SDK](./agentcore-sdk-memory. - from bedrock_agentcore.memory import MemoryClient - import time @@ -96,14 +67,0 @@ For more information, see [Amazon Bedrock AgentCore SDK](./agentcore-sdk-memory. - client = MemoryClient(region_name="us-east-1") - - memory = client.create_memory_and_wait( - name="MyAgentMemory", - strategies=[{ - "summaryMemoryStrategy": { - # Name of the extraction model/strategy - "name": "SessionSummarizer", - # Organize facts by session ID for easy retrieval - # Example: "summaries/session123" contains summary of session123 - "namespaceTemplates": ["/summaries/{actorId}/{sessionId}/"] - } - }] - )