AWS bedrock documentation change
Summary
Added documentation for new 'Tool search tool (beta)' and 'Tool use examples (beta)' features, updated supported model versions (including Claude Opus 4.5), and expanded tool use implementation details with examples
Security assessment
The changes introduce new beta features for tool management and examples but contain no explicit security vulnerability fixes or security guidance. The added content focuses on functionality improvements (deferred tool loading, search capabilities, and example validation) without mentioning security controls, vulnerabilities, or protective measures.
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 e724ea199..446de6f7f 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 @@ -5 +5 @@ -Fine-grained tool streamingComputer use (Beta)Anthropic defined toolsAutomatic tool call clearing (Beta)Memory Tool (Beta)Cost considerations for tool use +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) @@ -210 +210 @@ Model | Beta header -Claude Opus 4.1 Claude Opus 4 Claude Sonnet 4.5 Claude Haiku 4.5 Claude Sonnet 4 Claude 3.7 Sonnet | computer-use-2025-01-24 +Claude Opus 4.5 Claude Opus 4.1 Claude Opus 4 Claude Sonnet 4.5 Claude Haiku 4.5 Claude Sonnet 4 Claude 3.7 Sonnet | computer-use-2025-01-24 @@ -583,2 +583,2 @@ Model | Tool choice | Tool use system prompt token count -Claude Opus 4.1 Claude Opus 4 Claude Sonnet 4.5 Claude Haiku 4.5 Claude Sonnet 4 Claude 3.7 Sonnet Claude 3.5 Sonnet v2 | `auto` or `none` | 346 -Claude Opus 4.1 Claude Opus 4 Claude Sonnet 4.5 Claude Haiku 4.5 Claude Sonnet 4 Claude 3.7 Sonnet Claude 3.5 Sonnet v2 | `any` or `tool` | 313 +Claude Opus 4.5 Claude Opus 4.1 Claude Opus 4 Claude Sonnet 4.5 Claude Haiku 4.5 Claude Sonnet 4 Claude 3.7 Sonnet Claude 3.5 Sonnet v2 | `auto` or `none` | 346 +Claude Opus 4.5 Claude Opus 4.1 Claude Opus 4 Claude Sonnet 4.5 Claude Haiku 4.5 Claude Sonnet 4 Claude 3.7 Sonnet Claude 3.5 Sonnet v2 | `any` or `tool` | 313 @@ -593,0 +594,419 @@ Claude 3 Haiku | `any` or `tool` | 340 +## Tool search tool (beta) + +Tool Search Tool allows Claude to work with hundreds or even thousands of tools without loading all their definitions into the context window upfront. Instead of declaring all tools immediately, you can mark them with `defer_loading: true`, and Claude finds and loads only the tools it needs through the tool search mechanism. + +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 definition: + + + { + "type": "tool_search_tool_regex", + "name": "tool_search_tool_regex" + } + +Request example: + + + { + "anthropic_version": "bedrock-2023-05-31", + "anthropic_beta": [ + "tool-search-tool-2025-10-19" + ], + "max_tokens": 4096, + "tools": [{ + "type": "tool_search_tool_regex", + "name": "tool_search_tool_regex" + }, + { + "name": "get_weather", + "description": "Get current weather for a location", + "input_schema": { + "type": "object", + "properties": { + "location": { + "type": "string" + }, + "unit": { + "type": "string", + "enum": ["celsius", "fahrenheit"] + } + }, + "required": ["location"] + }, + "defer_loading": true + }, + { + "name": "search_files", + "description": "Search through files in the workspace", + "input_schema": { + "type": "object", + "properties": { + "query": { + "type": "string" + }, + "file_types": { + "type": "array", + "items": { + "type": "string" + } + } + }, + "required": ["query"] + }, + "defer_loading": true + } + ], + "messages": [{ + "role": "user", + "content": "What's the weather in Seattle?" + }] + } + +Response example + + + { + "role": "assistant", + "content": [{ + "type": "text", + "text": "I'll search for the appropriate tools to help with this task." + }, + { + "type": "server_tool_use", + "id": "srvtoolu_01ABC123", + "name": "tool_search_tool_regex", + "input": { + "pattern": "weather" + } + }, + { + "type": "tool_search_tool_result", + "tool_use_id": "srvtoolu_01ABC123", + "content": { + "type": "tool_search_tool_search_result", + "tool_references": [{ + "type": "tool_reference", + "tool_name": "get_weather" + }] + } + }, + { + "type": "text", + "text": "Now I can check the weather." + }, + { + "type": "tool_use", + "id": "toolu_01XYZ789", + "name": "get_weather", + "input": { + "location": "Seattle", + "unit": "fahrenheit" + } + } + ], + "stop_reason": "tool_use" + } + +Streaming example + + + # Event 1: content_block_start(with complete server_tool_use block) { + "type": "content_block_start", + "index": 0, + "content_block": { + "type": "server_tool_use", + "id": "srvtoolu_01ABC123", + "name": "tool_search_tool_regex" + } + } + + # Event 2: content_block_delta(input JSON streamed) { + "type": "content_block_delta", + "index": 0, + "delta": { + "type": "input_json_delta", + "partial_json": "{\"regex\": \".*weather.*\"}" + } + } + + # Event 3: content_block_stop(tool_use complete) { + "type": "content_block_stop", + "index": 0 + } + + # Event 4: content_block_start(COMPLETE result in single chunk) { + "type": "content_block_start", + "index": 1, + "content_block": { + "type": "tool_search_tool_result", + "tool_use_id": "srvtoolu_01ABC123", + "content": { + "type": "tool_search_tool_search_result", + "tool_references": [{ + "type": "tool_reference", + "tool_name": "get_weather" + }] + } + } + } + + # Event 5: content_block_stop(result complete) { + "type": "content_block_stop", + "index": 1 + } + +###### Custom tool search tools + +You can implement custom tool search tools (for example, using embeddings) by defining a tool that returns `tool_reference` blocks. The custom tool must have `defer_loading: false` while other tools should have `defer_loading: true`. When you define your own Tool Search Tool, it should return a tool result containing `tool_reference` content blocks that point to the tools you want Claude to use. + +The expected customer-defined Tool Search Tool result response format: + + + { + "type": "tool_result", + "tool_use_id": "toolu_01ABC123", + "content": [{ + "type": "tool_reference", + "tool_name": "get_weather" + }, + { + "type": "tool_reference", + "tool_name": "weather_forecast" + } + ]