AWS bedrock documentation change
Summary
Restructured documentation for Anthropic Claude tool use, including updated terminology from 'computer use' to 'tool family', removed detailed security warnings, simplified tool version mapping tables, added model compatibility notes, and replaced response examples with external references.
Security assessment
The changes involve documentation restructuring and clarification of technical parameters without addressing any specific security vulnerability. The removal of security warnings about VM isolation, sensitive data access, and human oversight doesn't indicate resolution of a security issue but rather relocation of content (as referenced by new links). No vulnerabilities or incidents are mentioned in the diff.
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 5917b370c..76e439ba8 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 @@ -9 +9 @@ Fine-grained tool streamingComputer use (Beta)Anthropic defined toolsAutomatic t -# Tool use +# Anthropic Claude tool use @@ -185,14 +185 @@ Because fine-grained streaming sends parameters without buffering or JSON valida -Computer use is an Anthropic Claude model capability (in beta) available with Claude 3.5 Sonnet v2, Claude Sonnet 4.5, Claude Haiku 4.5, Claude 3.7 Sonnet, Claude Sonnet 4, and Claude Opus 4. With computer use, Claude can help you automate tasks through basic GUI actions. - -###### Warning - -Computer use feature is made available to you as a ‘Beta Service’ as defined in the AWS Service Terms. It is subject to your Agreement with AWS and the AWS Service Terms, and the applicable model EULA. Please be aware that the Computer Use API poses unique risks that are distinct from standard API features or chat interfaces. These risks are heightened when using the Computer Use API to interact with the Internet. To minimize risks, consider taking precautions such as: - - * Operate computer use functionality in a dedicated Virtual Machine or container with minimal privileges to prevent direct system attacks or accidents. - - * To prevent information theft, avoid giving the Computer Use API access to sensitive accounts or data. - - * Limiting the computer use APIs internet access to required domains to reduce exposure to malicious content. - - * To ensure proper oversight, keep a human in the loop for sensitive tasks (such as making decisions that could have meaningful real-world consequences) and for anything requiring affirmative consent (such as accepting cookies, executing financial transactions, or agreeing to terms of service). - +Computer use is an Anthropic Claude tool family (in beta) for automating graphical user interface (GUI) tasks. For an overview, the Amazon Bedrock-specific request shape, and an end-to-end example, see [Use computer use tools to automate GUI tasks with Amazon Bedrock models](./computer-use.html). To find which models support computer use on each endpoint, see the _Capabilities and Features_ table in each [](./model-cards.html). @@ -199,0 +187 @@ Computer use feature is made available to you as a ‘Beta Service’ as defined +To enable computer use on a request, set `anthropic_beta` to a computer-use version and include a tool entry whose `type` matches that version. The valid pairings are: @@ -201,10 +189 @@ Computer use feature is made available to you as a ‘Beta Service’ as defined - -Any content that you enable Claude to see or access can potentially override instructions or cause Claude to make mistakes or perform unintended actions. Taking proper precautions, such as isolating Claude from sensitive surfaces, is essential — including to avoid risks related to prompt injection. Before enabling or requesting permissions necessary to enable computer use features in your own products, please inform end users of any relevant risks, and obtain their consent as appropriate. - -The computer use API offers several pre-defined computer use tools for you to use. You can then create a prompt with your request, such as “send an email to Ben with the notes from my last meeting” and a screenshot (when required). The response contains a list of `tool_use` actions in JSON format (for example, scroll_down, left_button_press, screenshot). Your code runs the computer actions and provides Claude with screenshot showcasing outputs (when requested). - -Since the release of Claude 3.5 v2, the tools parameter has been updated to accept polymorphic tool types; a `tool.type` property was added to distinguish them. `type` is optional; if omitted, the tool is assumed to be a custom tool (previously the only tool type supported). To access computer use, you must use the `anthropic_beta` parameter, with a corresponding enum, whose value depends on the model version in use. See the following table for more information. - -Only requests made with this parameter and enum can use the computer use tools. It can be specified as follows: `"anthropic_beta": ["computer-use-2025-01-24"]`. - -Model | Beta header +Beta header | Computer tool type @@ -212,6 +191,3 @@ Model | Beta header -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 -Claude 3.5 Sonnet v2 | computer-use-2024-10-22 - -For more information, see [Computer use (beta)](https://docs.anthropic.com/en/docs/build-with-claude/computer-use) in the Anthropic documentation. - -The following is an example response that assumes the request contained a screenshot of your desktop with a Firefox icon. +`computer-use-2025-11-24` | `computer_20251124` +`computer-use-2025-01-24` | `computer_20250124` +`computer-use-2024-10-22` | `computer_20241022` @@ -218,0 +195 @@ The following is an example response that assumes the request contained a screen +Each tool type works only with a specific subset of models. Submitting a tool type that a model does not support returns a `400 invalid_request_error` with a message such as `'claude-opus-4-7' does not support tool types: computer_20241022`. Confirm support in the model's _Capabilities and Features_ table before sending requests. @@ -220,38 +197 @@ The following is an example response that assumes the request contained a screen - { - "id": "msg_123", - "type": "message", - "role": "assistant", - "model": "anthropic.claude-3-5-sonnet-20241022-v2:0", - "content": [ - { - "type": "text", - "text": "I see the Firefox icon. Let me click on it and then navigate to a weather website." - }, - { - "type": "tool_use", - "id": "toolu_123", - "name": "computer", - "input": { - "action": "mouse_move", - "coordinate": [ - 708, - 736 - ] - } - }, - { - "type": "tool_use", - "id": "toolu_234", - "name": "computer", - "input": { - "action": "left_click" - } - } - ], - "stop_reason": "tool_use", - "stop_sequence": null, - "usage": { - "input_tokens": 3391, - "output_tokens": 132 - } - } +For the underlying tool protocol, the full action vocabulary, and prompt-engineering guidance, see [Computer use](https://docs.anthropic.com/en/docs/build-with-claude/computer-use) in the Anthropic documentation. @@ -261 +201 @@ The following is an example response that assumes the request contained a screen -Anthropic provides a set of tools to enable certain Claude models to effectively use computers. When specifying an Anthropic defined tool, the `description` and `tool_schema` fields are not necessary or allowed. Anthropic defined tools are defined by Anthropic, but you must explicitly evaluate the results of the tool and return the `tool_results` to Claude. As with any tool, the model does not automatically execute the tool. Each Anthropic defined tool has versions optimized for specific models Claude 3.5 Sonnet (new) and Claude 3.7 Sonnet: +Anthropic provides a set of pre-defined tools that Claude models can use to interact with computers. When specifying an Anthropic-defined tool, the `description` and `tool_schema` fields are not necessary or allowed. The model does not execute these tools automatically; you must run each requested action and return a `tool_result` to Claude. To find which of these tools each model accepts, see the _Capabilities and Features_ table in the model's [](./model-cards.html); submitting a tool type that a model does not support returns a `400 invalid_request_error`. @@ -263,3 +203,2 @@ Anthropic provides a set of tools to enable certain Claude models to effectively -Model | Tool | Notes ----|---|--- -Claude Claude Opus 4.1 Claude Claude Opus 4 Claude Sonnet 4.5 Claude Haiku 4.5 Claude Sonnet 4 | +Tool | Notes +---|--- @@ -269,2 +208,2 @@ Claude Claude Opus 4.1 Claude Claude Opus 4 Claude Sonnet 4.5 Claude Haiku 4.5 C - "type": "text_editor_20250124", - "name": "str_replace_based_edit_tool" + "type": "computer_20251124", + "name": "computer" @@ -273,2 +212 @@ Claude Claude Opus 4.1 Claude Claude Opus 4 Claude Sonnet 4.5 Claude Haiku 4.5 C -| Update to existing `str_replace_editor` tool -Claude 3.7 Sonnet | +| Latest computer-use tool. Use with `"anthropic_beta": ["computer-use-2025-11-24"]`. @@ -282,2 +220 @@ Claude 3.7 Sonnet | -| Includes new actions for more precise control -Claude 3.7 Sonnet | +| Use with `"anthropic_beta": ["computer-use-2025-01-24"]`. @@ -287,2 +224,2 @@ Claude 3.7 Sonnet | - "type": "text_editor_20250124", - "name": "str_replace_editor" + "type": "computer_20241022", + "name": "computer" @@ -291,2 +228 @@ Claude 3.7 Sonnet | -| Same capabilities as 20241022 version -Claude 3.5 Sonnet v2 | +| Legacy. Use with `"anthropic_beta": ["computer-use-2024-10-22"]`. @@ -296,2 +232,2 @@ Claude 3.5 Sonnet v2 | - "type": "bash_20250124", - "name": "bash" + "type": "text_editor_20250124", + "name": "str_replace_based_edit_tool" @@ -300,2 +236 @@ Claude 3.5 Sonnet v2 | -| Same capabilities as 20241022 version -Claude 3.5 Sonnet v2 | +| Update to the existing `str_replace_editor` tool. Use with `"anthropic_beta": ["computer-use-2025-01-24"]` or `["computer-use-2025-11-24"]`. @@ -309 +244 @@ Claude 3.5 Sonnet v2 | -Claude 3.5 Sonnet v2 | +| Legacy. Use with `"anthropic_beta": ["computer-use-2024-10-22"]`. @@ -313 +248 @@ Claude 3.5 Sonnet v2 | - "type": "bash_20241022", + "type": "bash_20250124", @@ -317 +252 @@ Claude 3.5 Sonnet v2 | -Claude 3.5 Sonnet v2 | +| Use with `"anthropic_beta": ["computer-use-2025-01-24"]` or `["computer-use-2025-11-24"]`. @@ -321,2 +256,2 @@ Claude 3.5 Sonnet v2 | - "type": "computer_20241022", - "name": "computer" + "type": "bash_20241022", + "name": "bash" @@ -325 +260,3 @@ Claude 3.5 Sonnet v2 | -The `type` field identifies the tool and its parameters for validation purposes, the `name` field is the tool name exposed to the model. +| Legacy. Use with `"anthropic_beta": ["computer-use-2024-10-22"]`. + +The `type` field identifies the tool and its parameters for validation purposes; the `name` field is the tool name exposed to the model. @@ -327 +264 @@ The `type` field identifies the tool and its parameters for validation purposes, -If you want to prompt the model to use one of these tools, you can explicitly refer the tool by the `name` field. The `name` field must be unique within the tool list; you cannot define a tool with the same `name` as an Anthropic defined tool in the same API call. +If you want to prompt the model to use one of these tools, you can explicitly refer the tool by the `name` field. The `name` field must be unique within the tool list; you cannot define a tool with the same `name` as an Anthropic-defined tool in the same API call. @@ -1016 +953 @@ To use the Amazon Web Services Documentation, Javascript must be enabled. Please -Anthropic Claude Messages API +Server-side @@ -1018 +955 @@ Anthropic Claude Messages API -Extended thinking +Projects