View a markdown version of this page

コンピュータ使用ツールを使用して Amazon Bedrock モデルで GUI タスクを自動化する - Amazon Bedrock
Amazon Bedrock でコンピュータを使用するリクエスト例

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

コンピュータ使用ツールを使用して Amazon Bedrock モデルで GUI タスクを自動化する

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

基盤となるツールプロトコル、アクションの完全なリスト、プロンプトエンジニアリングガイダンスについては、 Anthropicドキュメントの「コンピュータの使用」を参照してください。このページでは、そのプロトコルでの 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 機能に必要なアクセス許可を有効化またはリクエストする前に、エンドユーザーに関連するリスクを通知したり、必要に応じて、エンドユーザーから合意を得ます。

Amazon Bedrock でコンピュータを使用する

コンピュータの使用は、 エンドポイントbedrock-runtimeと bedrock-mantleエンドポイントの両方でサポートされています。各エンドポイントでコンピュータの使用をサポートするモデルを確認するには、各 の機能と機能の表を参照してくださいモデルの概要。コンピュータの使用をサポートしていないモデルにリクエストを送信するか、サポートされていないモデルとツールタイプをペアリングすると、 が返されます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 (ベータ版)。

リクエスト例

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

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 を使用した推論。