View a markdown version of this page

Utilisez des outils informatiques pour automatiser les tâches de l'interface graphique avec les modèles Amazon Bedrock - Amazon Bedrock
Utiliser un ordinateur sur Amazon BedrockExemple de demande

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisez des outils informatiques pour automatiser les tâches de l'interface graphique avec les modèles Amazon Bedrock

L'utilisation de l'ordinateur est une famille d'AnthropicClaudeoutils (en version bêta) permettant d'automatiser les tâches de l'interface utilisateur graphique (GUI). Le modèle renvoie tool_use des actions telles quescreenshot, left_clicktype, et scroll en JSON. Votre application exécute ces actions sur un poste de travail ou un conteneur et renvoie la capture d'écran obtenue Claude au tour suivant.

Pour le protocole de l'outil sous-jacent, la liste complète des actions et les instructions techniques, voir Utilisation de l'ordinateur dans la Anthropic documentation. Cette page décrit l' Bedrock-specificutilisation d'Amazon en plus de ce protocole.

Avertissement

L'utilisation de l'ordinateur est mise à votre disposition en tant que « service bêta » tel que défini dans les conditions AWS de service. Il est soumis à votre accord AWS, aux conditions AWS de service et au modèle EULA applicable. L'API d'utilisation de l'ordinateur présente des risques uniques, distincts des fonctionnalités standard de l'API ou des interfaces de chat. Ces risques sont accrus lors de l’utilisation de l’API d’utilisation d’ordinateur pour interagir avec Internet. Pour minimiser les risques, pensez à prendre les précautions suivantes :

  • Exploitez les fonctionnalités d’utilisation d’un ordinateur dans une machine virtuelle ou un conteneur dédié avec des privilèges minimaux afin de prévenir les attaques directes du système ou les accidents.

  • Pour éviter le vol d’informations, évitez de donner à l’API d’utilisation d’ordinateur l’accès à des comptes ou à des données sensibles.

  • Limitez l'accès Internet de l'API d'utilisation de l'ordinateur aux domaines requis afin de réduire l'exposition au contenu malveillant.

  • Pour garantir une supervision adéquate, gardez une intervention humaine pour les tâches sensibles (telles que la prise de décisions susceptibles d’avoir des conséquences importantes dans le monde réel) et pour tout ce qui nécessite un consentement affirmatif (comme l’acceptation de cookies, l’exécution de transactions financières ou l’acceptation des conditions de service).

Tout contenu que vous autorisez Claude à afficher ou auquel vous l’autorisez à accéder peut potentiellement entraîner l’annulation d’instructions ou amener Claude à commettre des erreurs ou à effectuer des actions involontaires. Il est essentiel de prendre les précautions appropriées, telles que l’isolement de Claude des surfaces sensibles, notamment pour éviter les risques liés à une injection d’invite. Avant d’activer ou de demander les autorisations nécessaires pour activer les fonctionnalités d’utilisation d’ordinateur dans vos propres produits, informez les utilisateurs finaux de tout risque pertinent et obtenez leur consentement le cas échéant.

Utiliser un ordinateur sur Amazon Bedrock

L'utilisation de l'ordinateur est prise en charge à la fois sur bedrock-runtime les bedrock-mantle terminaux et. Pour savoir quels modèles prennent en charge l'utilisation d'un ordinateur sur chaque terminal, consultez le tableau des fonctionnalités et des fonctionnalités de chaque terminalLes modèles en un coup d'œil. Soumettre une demande à un modèle qui ne prend pas en charge l'utilisation d'un ordinateur, ou associer un type d'outil à un modèle non pris en charge, renvoie un. 400 invalid_request_error

Pour permettre l'utilisation d'un ordinateur sur demande, incluez les deux éléments suivants :

  • anthropic_betaEntrée désignant une version bêta destinée à un usage informatique (par exemple, "anthropic_beta": ["computer-use-2025-11-24"] dans le corps de la requête ou dans l'en-tête anthropic-beta: computer-use-2025-11-24 HTTP pourbedrock-mantle). bedrock-runtime

  • Une ou plusieurs entrées d'outils Anthropic prédéfinies dans le tools tableau, avec un type champ correspondant à la version bêta (par exemple, computer_20251124bash_20250124, outext_editor_20250124).

Pour les appariements entre la version bêta et le type d'outil, les outils supplémentaires Anthropic définis (bash et éditeur de texte) et la documentation complète des champs de demande et de réponse, voir. Utilisation d’ordinateur (version bêta)

Exemple de demande

L'exemple Python suivant envoie une demande d'API Messages via le bedrock-runtime point de terminaison avec l'outil d'utilisation de l'ordinateur. Remplacez-le par un autre compatible modelId avec l'utilisation d'un ordinateur (voirLes modèles en un coup d'œil).

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

Pour la forme de demande d'API bedrock-mantle Messages équivalente, consultezInférence à l'aide de l'API Anthropic Messages.