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

# 컴퓨터 사용 도구를 사용하여 Amazon Bedrock 모델로 GUI 작업 자동화
<a name="computer-use"></a>

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

기본 도구 프로토콜, 전체 작업 목록 및 프롬프트 엔지니어링 지침은 Anthropic 설명서의 [컴퓨터 사용을](https://docs.anthropic.com/en/docs/build-with-claude/computer-use) 참조하세요. 이 페이지에서는 해당 프로토콜에 대한 Amazon Bedrock별 사용량을 다룹니다.

**주의**  
컴퓨터 사용은 서비스 약관에 정의된 대로 "베타 AWS 서비스"로 제공됩니다. 여기에는 계약 AWS, AWS 서비스 약관 및 해당 모델 EULA가 적용됩니다. 컴퓨터 사용 API는 표준 API 기능 또는 채팅 인터페이스와 구별되는 고유한 위험을 초래합니다. 이러한 위험은 Computer Use API를 사용하여 인터넷과 상호 작용할 때 더욱 커집니다. 위험을 최소화하려면 다음과 같은 예방 조치를 취하는 것이 좋습니다.  
전용 가상 머신 또는 컨테이너에서 컴퓨터 사용 기능을 최소한의 권한으로 작동하여 직접 시스템 공격 또는 사고를 방지합니다.
정보 도난을 방지할 수 있도록 민감한 계정 또는 데이터에 대한 Computer Use API 액세스 권한을 부여하지 마세요.
컴퓨터 사용 API의 인터넷 액세스를 필수 도메인으로 제한하여 악성 콘텐츠에 대한 노출을 줄입니다.
적절한 감독이 이루어질 수 있도록, 민감한 작업(예: 의미 있는 실제 결과로 이어질 수 있는 의사 결정)과 긍정적인 동의가 필요한 모든 작업(예: 쿠키 허용, 금융 거래 실행 또는 서비스 약관 동의)에 대해 사람을 루프에 관여시킵니다.
Claude가 확인하거나 액세스할 수 있도록 설정한 모든 콘텐츠로 인해 지침이 재정의되거나, Claude의 실수 또는 의도하지 않은 작업 수행이 발생할 수 있습니다. 프롬프트 인젝션과 관련된 위험을 방지하기 위해서는 민감한 표면에서 Claude를 격리하는 등 적절한 예방 조치를 취하는 것이 중요합니다. 자체 제품에서 컴퓨터 사용 기능을 설정하는 데 필요한 권한을 활성화하거나 요청하기 전에 최종 사용자에게 관련 위험을 알리고 필요한 경우 동의를 얻으시기 바랍니다.

**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`.

요청에서 컴퓨터 사용을 활성화하려면 다음을 모두 포함합니다.
+ 컴퓨터 사용 베타 버전의 이름을 지정하는 `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 및 텍스트 편집기) 및 전체 요청 및 응답 필드 설명서는 섹션을 참조하세요[컴퓨터 사용(베타)](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` 엔드포인트를 통해 메시지 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` 메시지 API 요청 셰이프는 섹션을 참조하세요[Anthropic Messages API를 사용한 추론](inference-messages-api.md).