AWS bedrock documentation change
Summary
Updated Memory Tool section to beta status, added beta parameter requirements, removed Converse API examples, and updated Tool Search Tool API availability
Security assessment
Changes primarily relate to feature lifecycle management (beta labeling) and API access requirements rather than addressing security vulnerabilities. The added beta warnings are standard service maturity disclaimers without indicating security flaws. Parameter requirements control feature access but don't directly mitigate security risks.
Diff
diff --git a/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-tool-use.md b/bedrock/latest/userguide/model-parameters-anthropic-claude-messages-tool-use.md index c99623055..5917b370c 100644 --- a//bedrock/latest/userguide/model-parameters-anthropic-claude-messages-tool-use.md +++ b//bedrock/latest/userguide/model-parameters-anthropic-claude-messages-tool-use.md @@ -7 +7 @@ -Fine-grained tool streamingComputer use (Beta)Anthropic defined toolsAutomatic tool call clearing (Beta)Memory ToolCost considerations for tool useTool search tool (beta)Tool use examples (beta) +Fine-grained tool streamingComputer use (Beta)Anthropic defined toolsAutomatic tool call clearing (Beta)Memory Tool (Beta)Cost considerations for tool useTool search tool (beta)Tool use examples (beta) @@ -483 +483 @@ Bedrock does not currently support `clear_tool_uses_20250919` context management -## Memory Tool +## Memory Tool (Beta) @@ -485 +485,5 @@ Bedrock does not currently support `clear_tool_uses_20250919` context management -Claude includes a memory tool that provides you a way to manage memory across conversations. With this feature, you can allow Claude to retrieve information outside the context window by providing access to a local directory. This feature is available through the [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html), [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html), [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html), and [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html) APIs. +###### Warning + +Memory Tool is made available as a "Beta Service" as defined in the AWS Service Terms. + +Claude Sonnet 4.5 includes a new memory tool. This tool provides you a way to manage memory across conversations. With this feature, you can allow Claude to retrieve information outside the context window by providing access to a local directory. This feature is available in beta. To use this feature, you must include `context-management-2025-06-27` in the `anthropic_beta` parameter. @@ -500,0 +505 @@ Example Request: + "anthropic_beta": ["context-management-2025-06-27"], @@ -549,60 +553,0 @@ Example Response: -### Using Memory Tool with the [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API - -With the [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API, you define Memory Tool by using the `modelTool` field in your tool configuration. When Claude needs to access memory, it returns a `toolUse` block with a memory command. Your application executes the command and returns the result in the next turn. - -The following example shows a [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) request that defines Memory Tool and asks Claude to store a preference. - -Example [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) Request - - - { - "modelId": "us.anthropic.claude-opus-4-6-v1", - "messages": [ - { - "role": "user", - "content": [{"text": "Remember that my favorite color is blue."}] - } - ], - "inferenceConfig": {"maxTokens": 2048}, - "toolConfig": { - "tools": [ - { - "modelTool": { - "name": "memory", - "additionalToolConfiguration": { - "type": "memory_20250818" - } - } - } - ] - } - } - -Example [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) Response - - - { - "output": { - "message": { - "content": [ - { - "text": "Let me first check my memory directory for any earlier progress." - }, - { - "toolUse": { - "input": { - "command": "view", - "path": "/memories" - }, - "name": "memory", - "toolUseId": "tooluse_01ABC123", - "type": "tool_use" - } - } - ], - "role": "assistant" - } - }, - "stopReason": "tool_use" - } - @@ -650 +595 @@ Tool Search Tool allows Claude to work with hundreds or even thousands of tools -Tool Search Tool is available through the [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html), [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html), [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html), and [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html) APIs. +To access this feature, you must include `tool-search-tool-2025-10-19` in the `anthropic_beta` parameter. Note that this feature is currently only available via the [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html) and [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) APIs. @@ -656 +601 @@ Tool definition: - "type": "tool_search_tool_regex_20251119", + "type": "tool_search_tool_regex", @@ -670 +615 @@ Request example: - "type": "tool_search_tool_regex_20251119", + "type": "tool_search_tool_regex", @@ -811,274 +755,0 @@ Streaming example -### Using Tool Search Tool with the Converse API - -With the [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) API, you define Tool Search Tool by using the `modelTool` field in the tool configuration. Mark deferred tools with `additionalToolSpecConfiguration` and set `defer_loading` to `true`. - -[Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) request example - - - { - "modelId": "us.anthropic.claude-sonnet-4-5-20250929-v1:0", - "messages": [ - { - "role": "user", - "content": [ - { - "text": "What's the weather in Seattle?" - } - ] - } - ], - "toolConfig": { - "tools": [ - { - "modelTool": { - "name": "tool_search_tool_regex", - "additionalToolConfiguration": { - "type": "tool_search_tool_regex_20251119" - } - } - }, - { - "toolSpec": { - "name": "get_weather", - "description": "Get current weather for a location", - "inputSchema": { - "json": { - "type": "object", - "properties": { - "location": { - "type": "string" - }, - "unit": { - "type": "string", - "enum": ["celsius", "fahrenheit"] - } - }, - "required": ["location"] - } - }, - "additionalToolSpecConfiguration": { - "defer_loading": true - } - } - }, - { - "toolSpec": { - "name": "search_files", - "description": "Search through files in the workspace", - "inputSchema": { - "json": { - "type": "object", - "properties": { - "query": { - "type": "string" - }, - "file_types": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "required": ["query"] - } - }, - "additionalToolSpecConfiguration": { - "defer_loading": true - } - } - } - ] - } - } - -[Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) response example - - - { - "output": { - "message": { - "role": "assistant", - "content": [ - { - "text": "I'll search for the appropriate tools to help with this task." - }, - { - "toolUse": { - "toolUseId": "srvtoolu_01ABC123", - "name": "tool_search_tool_regex", - "type": "server_tool_use", - "input": { - "pattern": "weather" - } - } - }, - { - "toolResult": { - "toolUseId": "srvtoolu_01ABC123", - "content": [], - "singleContent": { - "json": {