View a markdown version of this page

Utilice herramientas informáticas para automatizar las tareas de la interfaz gráfica de usuario con los modelos de Amazon Bedrock - Amazon Bedrock
Usa el ordenador en Amazon BedrockEjemplo de solicitud

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

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 comoscreenshot, left_clicktype, 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 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.

Usa el ordenador en Amazon Bedrock

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 ellosLos modelos de un vistazo. 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 un400 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 debedrock-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_20251124bash_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)

Ejemplo de solicitud

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 (consulteLos modelos de un vistazo).

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, consulteInferencia mediante la API de mensajes antrópicos.