AWS bedrock documentation change
Summary
Updated documentation for Memory Tool and Tool Search Tool features - removed beta status, added support for Converse and ConverseStream APIs, removed beta headers, and added comprehensive examples for both features with the Converse API.
Security assessment
The changes are feature maturity updates (removing beta status) and API support expansions. No security vulnerabilities, weaknesses, or incidents are mentioned. The changes focus on feature availability, API integration examples, and removing beta requirements. The Memory Tool feature allows Claude to access local directories which could have security implications, but the documentation changes don't address security controls or vulnerabilities.
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 64bf8096f..e5c996119 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 Tool (Beta)Cost 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 ToolCost considerations for tool useTool search tool (beta)Tool use examples (beta) @@ -480 +480 @@ Bedrock does not currently support `clear_tool_uses_20250919` context management -## Memory Tool (Beta) +## Memory Tool @@ -482,5 +482 @@ Bedrock does not currently support `clear_tool_uses_20250919` context management -###### 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 that provide customers a way to manage memory across conversations. With this feature, customers can allow Claude to retrieve information outside the context window by providing access to a local directory. This will be available as a beta feature. To use this feature, you must use the `context-management-2025-06-27` beta header. +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. @@ -502 +497,0 @@ Example Request: - "anthropic_beta": ["context-management-2025-06-27"], @@ -550,0 +546,60 @@ 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" + } + @@ -592 +647 @@ Tool Search Tool allows Claude to work with hundreds or even thousands of tools -To access this feature you must use the beta header `tool-search-tool-2025-10-19`. 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. +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. @@ -598 +653 @@ Tool definition: - "type": "tool_search_tool_regex", + "type": "tool_search_tool_regex_20251119", @@ -612 +667 @@ Request example: - "type": "tool_search_tool_regex", + "type": "tool_search_tool_regex_20251119", @@ -752,0 +808,274 @@ 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": {