View a markdown version of this page

컴퓨터 사용 도구를 사용하여 Amazon Bedrock 모델로 GUI 작업 자동화 - Amazon Bedrock
Amazon Bedrock에서 컴퓨터 사용요청 예제

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

컴퓨터 사용 도구를 사용하여 Amazon Bedrock 모델로 GUI 작업 자동화

컴퓨터 사용은 그래픽 사용자 인터페이스(GUI) 작업을 자동화하기 위한 Anthropic Claude 도구 패밀리(베타)입니다. 모델은 screenshot, left_click, type, 등의 tool_use 작업을 JSONscroll으로 반환합니다. 애플리케이션은 데스크톱 또는 컨테이너에서 이러한 작업을 실행하고 다음 차례에 결과 스크린샷을 Claude에 반환합니다.

기본 도구 프로토콜, 전체 작업 목록 및 프롬프트 엔지니어링 지침은 Anthropic 설명서의 컴퓨터 사용을 참조하세요. 이 페이지에서는 해당 프로토콜에 대한 Amazon Bedrock별 사용량을 다룹니다.

주의

컴퓨터 사용은 서비스 약관에 정의된 대로 "베타 AWS 서비스"로 제공됩니다. 여기에는 계약 AWS, AWS 서비스 약관 및 해당 모델 EULA가 적용됩니다. 컴퓨터 사용 API는 표준 API 기능 또는 채팅 인터페이스와 구별되는 고유한 위험을 초래합니다. 이러한 위험은 Computer Use API를 사용하여 인터넷과 상호 작용할 때 더욱 커집니다. 위험을 최소화하려면 다음과 같은 예방 조치를 취하는 것이 좋습니다.

  • 전용 가상 머신 또는 컨테이너에서 컴퓨터 사용 기능을 최소한의 권한으로 작동하여 직접 시스템 공격 또는 사고를 방지합니다.

  • 정보 도난을 방지할 수 있도록 민감한 계정 또는 데이터에 대한 Computer Use API 액세스 권한을 부여하지 마세요.

  • 컴퓨터 사용 API의 인터넷 액세스를 필수 도메인으로 제한하여 악성 콘텐츠에 대한 노출을 줄입니다.

  • 적절한 감독이 이루어질 수 있도록, 민감한 작업(예: 의미 있는 실제 결과로 이어질 수 있는 의사 결정)과 긍정적인 동의가 필요한 모든 작업(예: 쿠키 허용, 금융 거래 실행 또는 서비스 약관 동의)에 대해 사람을 루프에 관여시킵니다.

Claude가 확인하거나 액세스할 수 있도록 설정한 모든 콘텐츠로 인해 지침이 재정의되거나, Claude의 실수 또는 의도하지 않은 작업 수행이 발생할 수 있습니다. 프롬프트 인젝션과 관련된 위험을 방지하기 위해서는 민감한 표면에서 Claude를 격리하는 등 적절한 예방 조치를 취하는 것이 중요합니다. 자체 제품에서 컴퓨터 사용 기능을 설정하는 데 필요한 권한을 활성화하거나 요청하기 전에 최종 사용자에게 관련 위험을 알리고 필요한 경우 동의를 얻으시기 바랍니다.

Amazon Bedrock에서 컴퓨터 사용

컴퓨터 사용은 bedrock-runtime 및 bedrock-mantle 엔드포인트 모두에서 지원됩니다. 각 엔드포인트에서 컴퓨터 사용을 지원하는 모델을 찾으려면 각의 기능 및 기능 표를 참조하세요한 눈에 보는 모델. 컴퓨터 사용을 지원하지 않는 모델에 요청을 제출하거나 도구 유형을 지원되지 않는 모델과 페어링하면가 반환됩니다400 invalid_request_error.

요청에서 컴퓨터 사용을 활성화하려면 다음을 모두 포함합니다.

  • 컴퓨터 사용 베타 버전의 이름을 지정하는 anthropic_beta 항목입니다(예: "anthropic_beta": ["computer-use-2025-11-24"]의 요청 본문 bedrock-runtime또는의 anthropic-beta: computer-use-2025-11-24 HTTP 헤더bedrock-mantle).

  • 베타 버전과 일치하는 type 필드(예: , computer_20251124 bash_20250124또는 text_editor_20250124)가 있는 tools 배열에 하나 이상의 Anthropic 사전 정의된 도구 항목.

beta-version-to-tool-type 페어링, 추가 Anthropic정의 도구(bash 및 텍스트 편집기) 및 전체 요청 및 응답 필드 설명서는 섹션을 참조하세요컴퓨터 사용(베타).

요청 예제

다음 Python 예제에서는 컴퓨터 사용 도구를 사용하여 bedrock-runtime 엔드포인트를 통해 메시지 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 메시지 API 요청 셰이프는 섹션을 참조하세요Anthropic Messages API를 사용한 추론.