

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Utilice herramientas informáticas para automatizar las tareas de la interfaz gráfica de usuario con los modelos de Amazon Bedrock
<a name="computer-use"></a>

Computer Use es una familia de Anthropic Claude herramientas (en versión beta) para automatizar las tareas de la interfaz gráfica de usuario (GUI). El modelo devuelve `tool_use` acciones como`screenshot`, `left_click``type`, y `scroll` en JSON. La aplicación ejecuta esas acciones en un escritorio o contenedor y devuelve la captura de pantalla resultante Claude en el siguiente turno.

Para ver el protocolo de la herramienta subyacente, la lista completa de acciones y una guía de ingeniería rápida, consulte [Uso del ordenador](https://docs.anthropic.com/en/docs/build-with-claude/computer-use) en la documentación. Anthropic Esta página cubre el Bedrock-specific uso de Amazon además de ese protocolo.

**aviso**  
El uso del ordenador se pone a su disposición como un «Servicio Beta», tal y como se define en las Condiciones del AWS servicio. Está sujeto a su acuerdo con él AWS, a las condiciones del AWS servicio y al modelo de EULA aplicable. La API de uso informático presenta riesgos únicos, distintos de los de las funciones de la API estándar o de las interfaces de chat. Estos riesgos aumentan cuando se utiliza la API de Computer Use para interactuar con internet. Para minimizar los riesgos, considere tomar las siguientes precauciones:  
Utilice la característica Uso de computadora en una máquina virtual o un contenedor específicos con privilegios mínimos para evitar ataques directos al sistema o accidentes.
Evitar dar a la API de Computer Use acceso a datos o cuentas confidenciales, para prevenir el robo de información.
Limite el acceso a Internet de la API de uso informático a los dominios necesarios para reducir la exposición a contenido malicioso.
Para garantizar una supervisión adecuada, asigne a una persona a las tareas delicadas (como la toma de decisiones que podría tener consecuencias significativas en el mundo real) y para cualquier cosa que requiera un consentimiento afirmativo (como aceptar cookies, ejecutar transacciones financieras o aceptar las condiciones del servicio).
Cualquier contenido que permita que Claude vea o acceda puede anular las instrucciones o provocar que Claude realice errores o acciones no deseadas. Es fundamental tomar las precauciones adecuadas, como aislar a Claude de las superficies sensibles, incluso para evitar los riesgos relacionados con una inyección de peticiones. Antes de habilitar o solicitar los permisos necesarios para activar las características Uso de computadora en sus propios productos, informe a los usuarios finales de los riesgos correspondientes y obtenga su consentimiento, según proceda.

**Topics**
+ [Usa el ordenador en Amazon Bedrock](#computer-use-bedrock-specifics)
+ [Ejemplo de solicitud](#computer-use-example-code)

## Usa el ordenador en Amazon Bedrock
<a name="computer-use-bedrock-specifics"></a>

El uso del ordenador está permitido tanto en el terminal como en `bedrock-runtime` el `bedrock-mantle` terminal. Para saber qué modelos admiten el uso del ordenador en cada terminal, consulte la tabla de *capacidades y características* de cada uno de ellos[Los modelos de un vistazo](model-cards.md). Al enviar una solicitud a un modelo que no admite el uso de ordenadores o al vincular un tipo de herramienta con un modelo no compatible, se devuelve un`400 invalid_request_error`.

Para habilitar el uso del ordenador en una solicitud, incluye ambos:
+ Una `anthropic_beta` entrada que nombre una versión beta para uso informático (por ejemplo, `"anthropic_beta": ["computer-use-2025-11-24"]` en el cuerpo de la solicitud o en el encabezado `anthropic-beta: computer-use-2025-11-24` HTTP de`bedrock-mantle`). `bedrock-runtime`
+ Una o más entradas de herramientas Anthropic predefinidas en la `tools` matriz, con un `type` campo que coincida con la versión beta (por ejemplo,, `computer_20251124``bash_20250124`, o). `text_editor_20250124`

Para ver las combinaciones entre la versión beta y el tipo de herramienta, las herramientas Anthropic definidas adicionales (bash y editor de texto) y la documentación completa de los campos de solicitud y respuesta, consulte. [Uso de computadora (Beta)](model-parameters-anthropic-claude-messages-tool-use.md#model-parameters-anthropic-claude-messages-computer-use)

## Ejemplo de solicitud
<a name="computer-use-example-code"></a>

El siguiente ejemplo de Python envía una solicitud de API de mensajes a través del `bedrock-runtime` punto final con la herramienta de uso informático. Sustitúyala por una que sea compatible `modelId` con el uso de ordenadores (consulte[Los modelos de un vistazo](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
```

Para ver la forma de solicitud de la API de `bedrock-mantle` mensajes equivalente, consulte[Inferencia mediante la API de mensajes antrópicos](inference-messages-api.md).