翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# コンピュータ使用ツールを使用して Amazon Bedrock モデルで GUI タスクを自動化する
<a name="computer-use"></a>

コンピュータの使用は、グラフィカルユーザーインターフェイス (GUI) タスクを自動化するためのAnthropicClaudeツールファミリー (ベータ版) です。このモデルは、`screenshot`、、`type`、 などの`tool_use`アクションを JSON `left_click``scroll`で返します。アプリケーションはデスクトップまたはコンテナでこれらのアクションを実行し、次のターンClaudeで結果のスクリーンショットを に返します。

基盤となるツールプロトコル、アクションの完全なリスト、プロンプトエンジニアリングガイダンスについては、 Anthropicドキュメントの[「コンピュータの使用](https://docs.anthropic.com/en/docs/build-with-claude/computer-use)」を参照してください。このページでは、そのプロトコルでの Amazon Bedrock 固有の使用方法について説明します。

**警告**  
コンピュータの使用は、 AWS サービス条件で定義されている「ベータサービス」として利用できます。本ライセンス条項には、 との契約 AWS、 AWS サービス条件、および該当するモデル EULA が適用されます。Computer Use API には、標準の API 機能やチャットインターフェイスとは異なる固有のリスクがあります。これらのリスクは、Computer Use API を使用してインターネットと通信するときに高くなります。リスクを最小限に抑えるには、次のような予防策を検討します。  
Computer Use 機能は、システムへの直接攻撃や事故を防ぐために、最小限の権限で専用の仮想マシンまたはコンテナで操作します。
情報の盗難を防ぐため、Computer Use API に機密アカウントまたはデータへのアクセスを許可しないでください。
悪意のあるコンテンツへの露出を減らすために、コンピュータでの API のインターネットアクセスを必要なドメインに制限します。
適切な監視を行うには、機密タスク (現実の世界に重大な結果を与える意思決定など) や、肯定的合意が必要なもの (Cookie の承諾、金融取引の実行または利用規約への同意など) のループに人間を関与させます。
Claude が閲覧またはアクセスできるようにしたコンテンツは、指示をオーバーライドしたり、Claude による間違いを招いたり、意図しない動作を引き起こす場合があります。Claude を機密事項から隔離するなど、適切な予防措置を講じることは、プロンプトインジェクション関連のリスクを回避するためにも不可欠です。独自の製品で Computer Use 機能に必要なアクセス許可を有効化またはリクエストする前に、エンドユーザーに関連するリスクを通知したり、必要に応じて、エンドユーザーから合意を得ます。

**Topics**
+ [Amazon Bedrock でコンピュータを使用する](#computer-use-bedrock-specifics)
+ [リクエスト例](#computer-use-example-code)

## Amazon Bedrock でコンピュータを使用する
<a name="computer-use-bedrock-specifics"></a>

コンピュータの使用は、 エンドポイント`bedrock-runtime`と `bedrock-mantle`エンドポイントの両方でサポートされています。各エンドポイントでコンピュータの使用をサポートするモデルを確認するには、各 の*機能と機能の*表を参照してください[モデルの概要](model-cards.md)。コンピュータの使用をサポートしていないモデルにリクエストを送信するか、サポートされていないモデルとツールタイプをペアリングすると、 が返されます`400 invalid_request_error`。

リクエストでコンピュータの使用を有効にするには、両方を含めます。
+ コンピュータ使用のベータバージョン (たとえば、 のリクエスト本文`bedrock-runtime`、または の `anthropic-beta: computer-use-2025-11-24` HTTP ヘッダー`"anthropic_beta": ["computer-use-2025-11-24"]`) という名前の`anthropic_beta`エントリ`bedrock-mantle`。
+ `tools` 配列内の 1 つ以上のAnthropic事前定義されたツールエントリ。ベータバージョン (、、 `computer_20251124` `bash_20250124`など`text_editor_20250124`) に一致する`type`フィールド。

beta-version-to-tool-type ペアリング、追加の Anthropic定義済みツール (bash およびテキストエディタ）、および完全なリクエストとレスポンスフィールドのドキュメントについては、「」を参照してください[Computer Use (ベータ版)](model-parameters-anthropic-claude-messages-tool-use.md#model-parameters-anthropic-claude-messages-computer-use)。

## リクエスト例
<a name="computer-use-example-code"></a>

次の Python の例では、コンピュータ使用ツールを使用して`bedrock-runtime`、エンドポイントを介して Messages API リクエストを送信します。`modelId` をコンピュータの使用をサポートするものと置き換えます (「」を参照[モデルの概要](model-cards.md))。

```
import boto3
import json

client = boto3.client("bedrock-runtime", region_name="us-east-1")

response = client.invoke_model(
    modelId="us.anthropic.claude-opus-4-7",
    body=json.dumps({
        "anthropic_version": "bedrock-2023-05-31",
        "anthropic_beta": ["computer-use-2025-11-24"],
        "max_tokens": 1024,
        "messages": [
            {"role": "user", "content": "Take a screenshot of the desktop."}
        ],
        "tools": [
            {
                "type": "computer_20251124",
                "name": "computer",
                "display_width_px": 1024,
                "display_height_px": 768,
            }
        ],
    }),
)

result = json.loads(response["body"].read())
print(result["stop_reason"])  # "tool_use" when the model issues a computer action
print(result["content"])      # contains the tool_use block describing the action
```

同等の `bedrock-mantle` Messages API リクエストシェイプについては、「」を参照してください[Anthropic Messages API を使用した推論](inference-messages-api.md)。