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.

Utilisation de l'outil

Avec Anthropic Claude 3 modèles, vous pouvez spécifier un outil que le modèle peut utiliser pour répondre à un message. Par exemple, vous pouvez spécifier un outil qui capte la chanson la plus populaire d'une station de radio. Si l'utilisateur passe le message Quelle est la chanson la plus populaire sur WZPZ ? , le modèle détermine que l'outil que vous avez spécifié peut aider à répondre à la question. Dans sa réponse, le modèle vous demande d'exécuter l'outil en son nom. Vous exécutez ensuite l'outil et transmettez le résultat de l'outil au modèle, qui génère ensuite une réponse pour le message d'origine. Pour plus d'informations, consultez la section Utilisation de l'outil (appel de fonction) dans la Anthropic Claude documentation.

Vous spécifiez les outils que vous souhaitez mettre à la disposition d'un modèle tools sur le terrain. L'exemple suivant concerne un outil qui permet d'obtenir les chansons les plus populaires d'une station de radio.

[
    {
        "name": "top_song",
        "description": "Get the most popular song played on a radio station.",
        "input_schema": {
            "type": "object",
            "properties": {
                "sign": {
                    "type": "string",
                    "description": "The call sign for the radio station for which you want the most popular song. Example calls signs are WZPZ and WKRP."
                }
            },
            "required": [
                "sign"
            ]
        }
    }
]

Lorsque le modèle a besoin d'un outil pour générer une réponse à un message, il renvoie des informations sur l'outil demandé, ainsi que l'entrée de l'outil, dans le content champ du message. Il définit également le motif d'arrêt de la réponse àtool_use.

{
    "id": "msg_bdrk_01USsY5m3XRUF4FCppHP8KBx",
    "type": "message",
    "role": "assistant",
    "model": "claude-3-sonnet-20240229",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 375,
        "output_tokens": 36
    },
    "content": [
        {
            "type": "tool_use",
            "id": "toolu_bdrk_01SnXQc6YVWD8Dom5jz7KhHy",
            "name": "top_song",
            "input": {
                "sign": "WZPZ"
            }
        }
    ],
    "stop_reason": "tool_use"
}

Dans votre code, vous appelez l'outil au nom de l'outil. Vous transmettez ensuite le résultat de l'outil (tool_result) dans un message utilisateur au modèle.

{
    "role": "user",
    "content": [
        {
            "type": "tool_result",
            "tool_use_id": "toolu_bdrk_01SnXQc6YVWD8Dom5jz7KhHy",
            "content": "Elemental Hotel"
        }
    ]
}

Dans sa réponse, le modèle utilise le résultat de l'outil pour générer une réponse pour le message d'origine.

{
    "id": "msg_bdrk_012AaqvTiKuUSc6WadhUkDLP",
    "type": "message",
    "role": "assistant",
    "model": "claude-3-sonnet-20240229",
    "content": [
        {
            "type": "text",
            "text": "According to the tool, the most popular song played on radio station WZPZ is \"Elemental Hotel\"."
        }
    ],
    "stop_reason": "end_turn"
}

Utilisation de l'ordinateur (version bêta)

L'utilisation de l'ordinateur est une fonctionnalité du Anthropic Claude modèle (en version bêta) disponible avec Claude 3.5 Sonnet v2Claude 3.7 Sonnet,Claude Sonnet 4, etClaude Opus 4. Grâce à l'utilisation d'un ordinateur, Claude peut vous aider à automatiser les tâches grâce à des actions de base de l'interface graphique.

L'API d'utilisation de l'ordinateur propose plusieurs outils d'utilisation prédéfinis que vous pouvez utiliser. Vous pouvez ensuite créer une invite avec votre demande, telle que « envoyer un e-mail à Ben avec les notes de ma dernière réunion » et une capture d'écran (si nécessaire). La réponse contient une liste d'tool_useactions au format JSON (par exemple, scroll_down, left_button_press, capture d'écran). Votre code exécute les actions de l'ordinateur et fournit une capture d'écran Claude présentant les sorties (sur demande).

Depuis la sortie de la version Claude 3.5 v2, le paramètre tools a été mis à jour pour accepter les types d'outils polymorphes ; une tool.type propriété a été ajoutée pour les distinguer. typeest facultatif ; s'il est omis, l'outil est supposé être un outil personnalisé (auparavant le seul type d'outil pris en charge). Pour accéder à l'utilisation de l'ordinateur, vous devez utiliser le anthropic_beta paramètre, avec une énumération correspondante, dont la valeur dépend de la version du modèle utilisée. Pour plus d'informations, veuillez consulter le tableau suivant.

Seules les requêtes effectuées avec ce paramètre et enum peuvent utiliser les outils d'utilisation de l'ordinateur. Il peut être spécifié comme suit :"anthropic_beta": ["computer-use-2025-01-24"].

Pour plus d'informations, consultez la section Utilisation de l'ordinateur (version bêta) dans la Anthropic documentation.

Voici un exemple de réponse qui suppose que la demande contient une capture d'écran de votre bureau avec une icône Firefox.

{
    "id": "msg_123",
    "type": "message",
    "role": "assistant",
    "model": "anthropic.claude-3-5-sonnet-20241022-v2:0",
    "content": [
        {
            "type": "text",
            "text": "I see the Firefox icon. Let me click on it and then navigate to a weather website."
        },
        {
            "type": "tool_use",
            "id": "toolu_123",
            "name": "computer",
            "input": {
                "action": "mouse_move",
                "coordinate": [
                    708,
                    736
                ]
            }
        },
        {
            "type": "tool_use",
            "id": "toolu_234",
            "name": "computer",
            "input": {
                "action": "left_click"
            }
        }
    ],
    "stop_reason": "tool_use",
    "stop_sequence": null,
    "usage": {
        "input_tokens": 3391,
        "output_tokens": 132
    }
}

Anthropicoutils définis

Anthropicfournit un ensemble d'outils permettant à certains Claude modèles d'utiliser efficacement les ordinateurs. Lorsque vous spécifiez un outil Anthropic défini, les tool_schema champs description et ne sont ni nécessaires ni autorisés. Anthropicles outils définis sont définis parAnthropic, mais vous devez évaluer explicitement les résultats de l'outil et renvoyer le tool_results àClaude. Comme pour tout outil, le modèle n'exécute pas automatiquement l'outil. Chaque outil Anthropic défini possède des versions optimisées pour des modèles spécifiques Claude 3.5 Sonnet (nouveaux) et Claude 3.7 Sonnet :

Le type champ identifie l'outil et ses paramètres à des fins de validation, le name champ est le nom de l'outil exposé au modèle.

Si vous souhaitez inviter le modèle à utiliser l'un de ces outils, vous pouvez référencer explicitement l'outil par le name champ. Le name champ doit être unique dans la liste d'outils ; vous ne pouvez pas définir un outil avec le même outil name qu'un outil Anthropic défini dans le même appel d'API.

Considérations relatives aux coûts liés à l'utilisation des outils

Les demandes d'utilisation d'outils sont facturées en fonction des facteurs suivants :

Le prix des outils est le même que celui de toutes les autres demandes d'ClaudeAPI, mais ils incluent des jetons supplémentaires par demande. Les jetons supplémentaires liés à l'utilisation de l'outil proviennent des éléments suivants :

Lorsque vous utilisez des outils, les Anthropic modèles incluent automatiquement une invite système spéciale qui permet de les utiliser. Le nombre de jetons d'utilisation d'outils requis pour chaque modèle est indiqué dans le tableau suivant. Ce tableau exclut les jetons supplémentaires décrits précédemment. Notez que ce tableau suppose qu'au moins un outil est fourni. Si aucun outil n'est fourni, le choix de l'outil « aucun » n'utilise aucun jeton d'invite système supplémentaire.