Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

*NOUVEAU* Anthropic Sonnet de Claude 3.7

Mode de mise au point
*NOUVEAU* Anthropic Sonnet de Claude 3.7 - Amazon Bedrock

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.

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.

Anthropic Claude 3.7 Sonnet est le premier modèle de Claude à proposer un step-by-step raisonnement, qui Anthropic a appelé « pensée étendue ». Avec Claude 3.7 Sonnet, le recours au step-by-step raisonnement est facultatif. Vous pouvez choisir entre la pensée standard et la pensée étendue pour un raisonnement avancé. Parallèlement à une réflexion approfondie, Claude 3.7 Sonnet autorise jusqu'à 128 000 jetons de sortie par demande (jusqu'à 64 000 jetons de sortie sont généralement considérés comme disponibles, mais les sorties entre 64 Ko et 128 Ko sont en version bêta). De plus, Anthropic a amélioré sa version bêta d'utilisation des ordinateurs avec la prise en charge de nouvelles actions.

Avec Claude 3.7 Sonnet, max_tokens (qui inclut votre budget de réflexion lorsque la réflexion est activée) est appliquée en tant que limite stricte. Le système renvoie désormais une erreur de validation si prompt tokens + max_tokens dépasse la taille de la fenêtre contextuelle. Lorsque vous calculez l'utilisation d'une fenêtre contextuelle avec la fonction de réflexion activée, il convient de prendre en compte certaines considérations :

  • Les blocs de réflexion des tours précédents sont supprimés et ne sont pas pris en compte dans votre fenêtre contextuelle.

  • La réflexion sur le tour actuel compte dans votre max_tokens limite pour ce tour.

  • Les blocs de réflexion des tours précédents sont généralement supprimés et ne sont pas pris en compte dans votre fenêtre contextuelle, sauf pour le dernier tour s'il s'agit d'un tour d'assistant.

  • Les blocs de réflexion actuels peuvent être inclus dans des scénarios spécifiques tels que l'utilisation d'outils et le préremplissage par assistant, et seuls ces blocs inclus sont pris en compte dans le calcul de votre utilisation de jetons.

  • Les utilisateurs ne sont facturés que pour les blocs de réflexion réellement présentés au modèle.

  • Il est recommandé de toujours renvoyer des blocs de réflexion avec vos demandes, car le système les utilisera et les validera si nécessaire pour un comportement optimal du modèle.

Raisonnement (pensée étendue)

Réflexion approfondie sur Claude 3.7 Sonnet permet aux capacités de chain-of-thought raisonnement d'améliorer la précision des tâches complexes, tout en garantissant la transparence de son processus de step-by-step réflexion avant de fournir une réponse finale. Lorsque vous activez la pensée étendue, Claude montre son processus de raisonnement par le biais de blocs de thinking contenu dans la réponse. Ces thinking blocs représentent le processus interne de résolution de problèmes de Claude utilisé pour éclairer la réponse. Claude 3.7 Sonnetle mode de raisonnement (ou de réflexion) est désactivé par défaut. Chaque fois que vous activez le thinking mode Claude, vous devez définir un budget pour le nombre maximum de jetons que Claude peut utiliser pour son processus de raisonnement interne. Vous thinking budget_tokens devez toujours être inférieur à celui que max_tokens vous spécifiez dans votre demande. Vous pouvez voir des blocs de réflexion expurgés apparaître dans votre sortie lorsque la sortie de raisonnement ne répond pas aux normes de sécurité. Ce comportement est normal. Le modèle peut toujours utiliser cette réflexion expurgée pour éclairer ses réponses tout en maintenant les garde-fous de sécurité. Lorsque vous passez thinking et redacted_thinking rebloquez l'API dans le cadre d'une conversation à plusieurs tours, vous devez fournir le bloc complet et non modifié.

Les jetons de réflexion contenus dans votre réponse sont pris en compte dans la fenêtre contextuelle et sont facturés comme des jetons de sortie. Étant donné que les jetons de réflexion sont traités comme des jetons de sortie normaux, ils sont également pris en compte dans le calcul de votre limite de quota de service par minute (TPM). Dans les conversations à plusieurs tours, les blocs de réflexion associés aux messages précédents de l'assistant ne sont pas facturés en tant que jetons de saisie.

Travailler avec un budget réfléchi :

Le minimum budget_tokens est de 1 024 jetons. Anthropic suggère d'essayer au moins 4 000 jetons pour obtenir un raisonnement plus complet et nuancé.

  • budget_tokensest une cible et non une limite stricte. L'utilisation réelle des jetons peut varier en fonction de la tâche.

  • Préparez-vous à des temps de réponse potentiellement plus longs en raison du traitement supplémentaire requis pour le raisonnement.

Compatibilité raisonnée avec d'autres paramètres :

  • Thinking n'est pas compatible avec les modifications de température, top_p ou top_k ni avec l'utilisation forcée d'outils.

  • Vous ne pouvez pas préremplir les réponses lorsque la fonction de réflexion est activée.

Raisonnement et mise en cache rapide (aperçu limité)

Inclusion des blocs de pensée :

  • La réflexion n'est incluse que lors de la génération d'un tour d'assistant et n'est pas destinée à être mise en cache.

  • Les blocages de réflexion des tours précédents sont ignorés.

  • Si la pensée est désactivée, tout contenu de réflexion transmis à l'API est ignoré.

Le cache est invalidé lorsque :

  • Permettre ou désactiver la pensée.

  • Modifier la façon de penserbudget_tokens.

Limites de persistance :

  • Seuls les instructions et les outils du système maintiennent la mise en cache lorsque les paramètres de réflexion changent.

  • La poursuite de l'utilisation de l'outil au tour par tour ne bénéficie pas d'une mise en cache rapide.

Utilisation de l'outil avec raisonnement

Lorsque vous retransmettez les blocs thinking et redacted_thinking à l'API dans le cadre d'une conversation à plusieurs tours, vous devez fournir le bloc complet et non modifié. Cela nécessite de préserver les blocages de pensée lors de l'utilisation de l'outil, pour deux raisons :

  • Continuité du raisonnement — Les blocs de réflexion reflètent le step-by-step raisonnement de Claude à l'origine des demandes d'outils. Lorsque vous publiez les résultats de l'outil, l'inclusion de la pensée originale permet à Claude de poursuivre son raisonnement là où il s'est arrêté.

  • Maintenance du contexte — Bien que les résultats d'utilisation des outils apparaissent sous forme de messages utilisateur dans la structure de l'API, ils font partie d'un flux de raisonnement continu. La préservation des blocs de réflexion permet de maintenir ce flux conceptuel entre plusieurs appels d'API.

Lorsque vous associez la pensée à l'utilisation d'outils, tenez compte du schéma de comportement suivant :

  • Premier tour d'assistant — Lorsque vous envoyez un message initial à l'utilisateur, la réponse de l'assistant inclut des blocs de réflexion suivis de demandes d'utilisation d'outils.

  • Tour de résultat de l'outil : lorsque vous transmettez le message utilisateur avec des blocs de résultats d'outils, le message d'assistant suivant ne contiendra aucun bloc de réflexion supplémentaire.

L'ordre normal d'une conversation basée sur l'utilisation d'un outil avec réflexion suit les étapes suivantes :

  1. L'utilisateur envoie le message initial.

  2. L'assistant répond par des blocs de réflexion et des demandes d'outils.

  3. L'utilisateur envoie un message avec les résultats de l'outil.

  4. L'assistant répond soit par d'autres appels à l'outil, soit par un simple texto (cette réponse ne bloque pas la réflexion).

  5. Si d'autres outils sont demandés, répétez les étapes 3 et 4 jusqu'à ce que la conversation soit terminée.

Cette conception permet à l'assistant de montrer son processus de raisonnement avant de faire des demandes d'outils, mais de ne pas répéter le processus de réflexion après avoir reçu les résultats de l'outil.

Avec Anthropic Claude 3.7 Sonnet modèle, vous pouvez spécifier un outil que le modèle peut utiliser pour répondre à un message. Pour plus d'informations, voir Utilisation de l'outil (appel de fonctions) dans le Anthropic Claude .

Astuce

Nous vous recommandons d'utiliser Converse API pour intégrer l'utilisation d'outils dans votre application. Pour de plus amples informations, veuillez consulter Utiliser un outil pour compléter une réponse du modèle Amazon Bedrock.

Utilisation de l'ordinateur mise à jour (version bêta)

Avec l'utilisation d'un ordinateur, Claude peut vous aider à automatiser les tâches grâce à des actions de base de l'interface graphique.

Avertissement

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

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

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

  • Limiter 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, tenez un humain au courant des tâches sensibles (telles que la prise de décisions susceptibles d'avoir des conséquences importantes dans le monde réel) et de 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 d'utilisation).

Tout contenu que vous activez Claude le fait de voir ou d'accéder peut potentiellement annuler les instructions ou provoquer Claude pour commettre des erreurs ou effectuer des actions involontaires. Prendre les précautions appropriées, telles que l'isolation Claude sur des surfaces sensibles, est essentiel, notamment pour éviter les risques liés à une injection rapide. Avant d'activer ou de demander les autorisations nécessaires pour activer les fonctionnalités d'utilisation de l'ordinateur dans vos propres produits, veuillez informer les utilisateurs finaux de tout risque pertinent et obtenir leur consentement le cas échéant.

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 Claude avec capture d'écran présentant les sorties (sur demande).

Claude 3.7 Sonnet permet d'étendre les capacités d'utilisation des ordinateurs grâce à une nouvelle version de l'outil bêta d'utilisation des ordinateurs existant. Pour utiliser ces nouveaux outils, vous devez spécifier le paramètre d'inférence anthropic-bêta « anthropic_beta » : ["computer-use-2025-01-24"]. L'ensemble des actions de retour possibles liées à l'utilisation d'un ordinateur comprend : faire défiler, attendre, cliquer avec le bouton gauche de la souris vers le bas, maintenir la touche enfoncée et cliquer trois fois. Il continuera à suivre le même format d'utilisation de l'outil dans les sorties.

Pour plus d'informations, voir Utilisation de l'ordinateur (version bêta) dans le Anthropic .

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-7-sonnet-20250219-v1:0", "anthropic_beta": ["computer-use-2025-01-24"] , "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 } }

Blocs de réflexion

Les blocs de pensée représentent Claude 3.7 Sonnetle processus de pensée interne.

InvokeModel Demande

{ "anthropic_version": "bedrock-2023-05-31", "max_tokens": 24000, "thinking": { "type": "enabled", "budget_tokens": 16000 }, "messages": [ { "role": "user", "content": "Are there an infinite number of prime numbers such that n mod 4 == 3?" } ] }

InvokeModel Réponse

{ "content": [ { "type": "thinking", "thinking": "To approach this, let's think about what we know about prime numbers...", "signature": "eyJhbGciOiJFUzI1NiIsImtpZCI6ImtleS0xMjM0In0.eyJoYXNoIjoiYWJjMTIzIiwiaWF0IjoxNjE0NTM0NTY3fQ...." }, { "type": "text", "text": "Yes, there are infinitely many prime numbers such that..." } ] }

Afin de permettre à Claude de résoudre les problèmes avec un minimum de restrictions internes tout en respectant les normes de sécurité, Anthropic a défini ce qui suit :

  • Les Thinking Blocks contiennent un champ de signature. Ce champ contient un jeton cryptographique qui vérifie que le bloc de réflexion a été généré par Claude, et qui est vérifié lorsque les blocs de réflexion sont renvoyés à l'API. Lors du streaming des réponses, la signature est ajoutée avec un signature_delta dans un événement content_block_delta juste avant l'événement content_block_stop.

Parfois, le raisonnement interne de Claude sera signalé par des systèmes de sécurité automatisés. Lorsque cela se produit, l'intégralité du bloc de pensée est cryptée et vous est renvoyée sous la forme d'un bloc redacted_thinking. Ces blocs de pensée expurgés sont déchiffrés lorsqu'ils sont renvoyés au modèle, ce qui permet à Claude de poursuivre sa réponse sans perdre le contexte.

Voici un exemple de réponse InvokeModel montrant à la fois des blocs de pensée normaux et expurgés :

{ "content": [ { "type": "thinking", "thinking": "Let me analyze this step by step...", "signature": "WaUjzkypQ2mUEVM36O2TxuC06KN8xyfbJwyem2dw3URve/op91XWHOEBLLqIOMfFG/UvLEczmEsUjavL...." }, { "type": "redacted_thinking", "data": "EmwKAhgBEgy3va3pzix/LafPsn4aDFIT2Xlxh0L5L8rLVyIwxtE3rAFBa8cr3qpP..." }, { "type": "text", "text": "Based on my analysis..." } ] }

Vous pouvez voir des blocs de réflexion expurgés apparaître dans votre sortie lorsque la sortie de raisonnement ne répond pas aux normes de sécurité. Ce comportement est normal. Le modèle peut toujours utiliser cette réflexion expurgée pour éclairer ses réponses tout en maintenant les garde-fous de sécurité. Lorsque vous retransmettez les blocs thinking et redacted_thinking à l'API dans le cadre d'une conversation à plusieurs tours, vous devez fournir le bloc complet et non modifié.

InvokeModelWithResponseStream

Lorsque le streaming est activé, vous recevrez du contenu de réflexion issu des événements thinking_delta. Voici comment gérer le streaming en toute réflexion :

Demande

{ "anthropic_version": "bedrock-2023-05-31", "max_tokens": 24000, "thinking": { "type": "enabled", "budget_tokens": 16000 }, "messages": [ { "role": "user", "content": "What is 27 * 453?" } ] }

Réponse

event: message_start data: {"type": "message_start", "message": {"id": "msg_01...", "type": "message", "role": "assistant", "content": [], "model": "claude-3-7-sonnet-20250219", "stop_reason": null, "stop_sequence": null}} event: content_block_start data: {"type": "content_block_start", "index": 0, "content_block": {"type": "thinking", "thinking": ""}} event: content_block_delta data: {"type": "content_block_delta", "index": 0, "delta": {"type": "thinking_delta", "thinking": "Let me solve this step by step:\n\n1. First break down 27 * 453"}} event: content_block_delta data: {"type": "content_block_delta", "index": 0, "delta": {"type": "thinking_delta", "thinking": "\n2. 453 = 400 + 50 + 3"}} // Additional thinking deltas... event: content_block_delta data: {"type": "content_block_delta", "index": 0, "delta": {"type": "signature_delta", "signature": "EqQBCgIYAhIM1gbcDa9GJwZA2b3hGgxBdjrkzLoky3dl1pkiMOYds..."}} event: content_block_stop data: {"type": "content_block_stop", "index": 0} event: content_block_start data: {"type": "content_block_start", "index": 1, "content_block": {"type": "text", "text": ""}} event: content_block_delta data: {"type": "content_block_delta", "index": 1, "delta": {"type": "text_delta", "text": "27 * 453 = 12,231"}} // Additional text deltas... event: content_block_stop data: {"type": "content_block_stop", "index": 1} event: message_delta data: {"type": "message_delta", "delta": {"stop_reason": "end_turn", "stop_sequence": null}} event: message_stop data: {"type": "message_stop"}

Longueur de sortie étendue (version bêta)

Claude 3.7 Sonnet peut produire des réponses nettement plus longues que les modèles Claude précédents, avec la prise en charge d'un maximum de 128 000 jetons de sortie (version bêta). Cette longueur de sortie étendue peut être utilisée avec les nouvelles capacités de raisonnement. Cette fonctionnalité peut être activée en transmettant un paramètre d'anthropic-betainférence deoutput-128k-2025-02-19.

Avertissement

La fonctionnalité de longueur de sortie étendue est mise à votre disposition sous la forme d'un « service bêta » tel que défini dans les conditions de service AWS. Il est soumis à votre accord avec AWS et aux conditions de service AWS, ainsi qu'au modèle EULA applicable.

Utilisation de l'ordinateur mise à jour (version bêta)

Claude 3.7 Sonnet permet d'étendre les capacités d'utilisation des ordinateurs grâce à une nouvelle version de l'outil bêta d'utilisation des ordinateurs existant. Pour utiliser ces nouveaux outils, vous devez spécifier le paramètre anthropic-beta computer_20250212 d'inférence. L'ensemble des actions de retour possibles liées à l'utilisation d'un ordinateur comprend : faire défiler, attendre, cliquer avec le bouton gauche de la souris vers le bas, maintenir la touche enfoncée et cliquer trois fois. Il continuera à suivre le même format d'utilisation de l'outil dans les sorties.

Avertissement

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

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

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

  • Limiter 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, tenez un humain au courant des tâches sensibles (telles que la prise de décisions susceptibles d'avoir des conséquences importantes dans le monde réel) et de 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 d'utilisation).

Tout contenu que vous activez Claude le fait de voir ou d'accéder peut potentiellement annuler les instructions ou provoquer Claude pour commettre des erreurs ou effectuer des actions involontaires. Prendre les précautions appropriées, telles que l'isolation Claude sur des surfaces sensibles, est essentiel, notamment pour éviter les risques liés à une injection rapide. Avant d'activer ou de demander les autorisations nécessaires pour activer les fonctionnalités d'utilisation de l'ordinateur dans vos propres produits, veuillez informer les utilisateurs finaux de tout risque pertinent et obtenir leur consentement le cas échéant.

Nouveaux outils définis par Anthropic

L'éditeur de texte et les outils bash n'étaient auparavant disponibles que dans le cadre de la computer-use-20241022 version bêta. Dans le cadre de Claude 3.7 Sonnet, ils seront désormais également disponibles sous forme d'outils autonomes définis par Anthropic :

  • L'outil d'édition de texte (qui effectue le remplacement des chaînes) sera désormais également disponible en tant qu'outil autonometext_editor_20250124.

  • L'outil Bash (qui permet au modèle de créer des commandes de terminal) sera désormais également disponible en tant qu'outil bash_20250124 autonome.

Ni l'outil de remplacement de chaînes ni l'outil bash ne nécessitent de paramètre d'inférence anthropique bêta.

Demande et réponse

Le corps de la demande est transmis dans le body champ d'une demande à InvokeModelou InvokeModelWithResponseStream. La taille maximale de la charge utile que vous pouvez envoyer dans une demande est de 20 Mo.

Pour plus d'informations, consultez https://docs.anthropic.com/claude/reference/messages_post.

Request

Claude 3.7 Sonnet possède les paramètres d'inférence suivants pour un appel d'inférence de messages.

{ "anthropic_version": "bedrock-2023-05-31", "anthropic_beta": ["computer-use-2025-01-24"] "max_tokens": int, "system": string, "messages": [ { "role": string, "content": [ { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "content image bytes" } }, { "type": "text", "text": "content text" } ] } ], "temperature": float, "top_p": float, "top_k": int, "tools": [ { "type": "custom", "name": string, "description": string, "input_schema": json }, { "type": "computer_20250212", "name": "computer", "display_height_px": int, "display_width_px": int, "display_number": 0 int }, { "type": "bash_20250124", "name": "bash" }, { "type": "text_editor_20250124", "name": "str_replace_editor" } ], "tool_choice": { "type" : string, "name" : string, }, "stop_sequences": [string] }

Les paramètres suivants sont obligatoires.

  • anthropic_version — (Obligatoire) La version anthropique. La valeur doit êtrebedrock-2023-05-31.

  • anthropic_beta — (Obligatoire, si vous utilisez l'API d'utilisation de l'ordinateur) La version bêta anthropique à utiliser. Pour utiliser l'API d'utilisation de l'ordinateur, la valeur doit êtrecomputer-use-2024-10-22. anthropic_betadevrait également avoir le output-128k-2025-02-19 paramètre pour une longueur de contexte étendue.

  • max_tokens — (Obligatoire) Le nombre maximum de jetons à générer avant l'arrêt.

    Notez que Anthropic Claude les modèles peuvent arrêter de générer des jetons avant d'atteindre la valeur demax_tokens. Différent Anthropic Claude les modèles ont des valeurs maximales différentes pour ce paramètre. Pour plus d'informations, consultez la section Comparaison des modèles.

  • messages — (Obligatoire) Les messages d'entrée.

    • rôle — Le rôle du tour de conversation. Les valeurs valides sont user et assistant.

    • content — (obligatoire) Le contenu de la conversation prend la forme d'un ensemble d'objets. Chaque objet contient un champ de type dans lequel vous pouvez spécifier l'une des valeurs suivantes :

      • text— Si vous spécifiez ce type, vous devez inclure un champ de texte et spécifier l'invite de texte comme valeur. Si un autre objet du tableau est une image, cette invite de texte s'applique aux images.

      • image— Si vous spécifiez ce type, vous devez inclure un champ source qui correspond à un objet avec les champs suivants :

        • type — (obligatoire) Type de codage de l'image. Vous pouvez le spécifierbase64.

        • media_type — (obligatoire) Le type de l'image. Vous pouvez définir les formats d'image suivants.

          • image/jpeg

          • image/png

          • image/webp

          • image/gif

        • data — (obligatoire) Les octets de l'image codés en base64 pour l'image. La taille maximale de l'image est de 3,75 Mo. La hauteur et la largeur maximales d'une image sont de 8 000 pixels.

      • réflexion — Claude montrera son processus de raisonnement par le biais de blocs de thinking contenu contenus dans la réponse. thinkingn'est pas compatible avec les modifications de température, top_p ou top_k, ni avec l'utilisation forcée d'outils.

      • redacted_thinking — Lorsque le raisonnement interne de Claude est signalé par des systèmes de sécurité automatisés, le bloc de réflexion est crypté et vous est renvoyé sous forme de bloc redacted_thinking.

Les paramètres suivants sont facultatifs.

  • system — (Facultatif) L'invite du système à saisir la demande.

    Une invite du système est un moyen de fournir du contexte et des instructions à Anthropic Claude, par exemple en spécifiant un objectif ou un rôle particulier. Pour plus d'informations, consultez la section Instructions système dans le Anthropic .

    Note

    Vous pouvez utiliser les instructions du système avec Anthropic Claude version 2.1 ou supérieure.

  • stop_sequences — (Facultatif) Séquences de texte personnalisées qui empêchent la génération du modèle. Anthropic Claude les modèles s'arrêtent normalement lorsqu'ils ont naturellement terminé leur tour, dans ce cas, la valeur du champ de stop_reason réponse estend_turn. Si vous souhaitez que le modèle cesse de générer lorsqu'il rencontre des chaînes de texte personnalisées, vous pouvez utiliser le stop_sequences paramètre. Si le modèle rencontre l'une des chaînes de texte personnalisées, la valeur du champ de stop_reason réponse est stop_sequence et la valeur de stop_sequence contient la séquence d'arrêt correspondante.

    Le nombre maximum d'entrées est de 8191.

  • température — (Facultatif) La quantité de caractère aléatoire injectée dans la réponse.

    Par défaut Minimum Maximum

    1

    0

    1

  • top_p — (Facultatif) Utilisez l'échantillonnage du noyau.

    Lors de l'échantillonnage du noyau, Anthropic Claude calcule la distribution cumulée de toutes les options pour chaque jeton suivant dans l'ordre décroissant de probabilité et la coupe une fois qu'il atteint une probabilité particulière spécifiée partop_p. Vous devez modifier l'un temperature ou l'autretop_p, mais pas les deux.

    Par défaut Minimum Maximum

    0,999

    0

    1

  • top_k — (Facultatif) Échantillonnez uniquement les K meilleures options pour chaque jeton suivant.

    top_kÀ utiliser pour supprimer les réponses à faible probabilité à longue queue.

    Par défaut Minimum Maximum

    Désactivé par défaut

    0

    500

  • outils — (Facultatif) Définitions des outils que le modèle peut utiliser.

    Note

    Nécessite un Anthropic Claude Modèle 3.

    Si vous l'incluez tools dans votre demande, le modèle peut renvoyer des blocs de tool_use contenu représentant l'utilisation de ces outils par le modèle. Vous pouvez ensuite exécuter ces outils à l'aide de l'entrée d'outil générée par le modèle, puis éventuellement renvoyer les résultats au modèle à l'aide de blocs de tool_result contenu.

    Vous pouvez transmettre les types d'outils suivants :

    Personnalisé

    Définition d'un outil personnalisé.

    • type (facultatif) : type de l'outil. Si elle est définie, utilisez la valeurcustom.

    • name — Le nom de l'outil.

    • description — (facultatif, mais fortement recommandé) Description de l'outil.

    • input_schema — Schéma JSON de l'outil.

    Ordinateur

    Définition de l'outil informatique que vous utilisez avec l'API d'utilisation de l'ordinateur.

    • type — La valeur doit êtrecomputer_20250212.

    • name — La valeur doit êtrecomputer.

    • (Obligatoire) display_height_px — Hauteur de l'écran contrôlée par le modèle, en pixels.

      Par défaut Minimum Maximum

      Aucun

      1

      Pas de maximum

    • (Obligatoire) display_width_px — Largeur de l'affichage contrôlée par le modèle, en pixels.

      Par défaut Minimum Maximum

      Aucun

      1

      Pas de maximum

    • (Facultatif) display_number — Le numéro d'affichage à contrôler (pertinent uniquement pour les environnements X11). Si cela est spécifié, un numéro d'affichage sera fourni à l'outil dans la définition de l'outil.

      Par défaut Minimum Maximum

      Aucun

      0

      N

    bash

    Définition de l'outil bash que vous utilisez avec l'API d'utilisation de l'ordinateur.

    • type (facultatif) — La valeur doit êtrebash_20250124.

    • nom — La valeur doit êtrebash. l'outil.

    éditeur de texte

    Définition de l'outil d'édition de texte que vous utilisez avec l'API d'utilisation de l'ordinateur.

    • type (facultatif) — La valeur doit êtretext_editor_20250124.

    • nom — La valeur doit êtrestr_replace_editor. l'outil.

  • tool_choice — (Facultatif) Spécifie comment le modèle doit utiliser les outils fournis. Le modèle peut utiliser un outil spécifique, n'importe quel outil disponible, ou décider par lui-même.

    Note

    Nécessite un Anthropic Claude Modèle 3.

    • type — Le type d'outil choisi. Les valeurs possibles sont any (utiliser n'importe quel outil disponible), auto (c'est le modèle qui décide) et tool (utiliser l'outil spécifié).

    • name — (Facultatif) Le nom de l'outil à utiliser. Obligatoire si vous le spécifiez tool dans le type champ.

Response

Le Anthropic Claude le modèle renvoie les champs suivants pour un appel d'inférence de messages.

{ "id": string, "model": string, "type" : "message", "role" : "assistant", "content": [ { "type": string, "text": string, "image" :json, "id": string, "name":string, "input": json } ], "stop_reason": string, "stop_sequence": string, "usage": { "input_tokens": integer, "output_tokens": integer } }
  • id — L'identifiant unique de la réponse. Le format et la longueur de l'identifiant peuvent changer au fil du temps.

  • model — L'ID du Anthropic Claude modèle à l'origine de la demande.

  • stop_reason — La raison pour laquelle Anthropic Claude a arrêté de générer la réponse.

    • end_turn — Le modèle a atteint un point d'arrêt naturel

    • max_tokens — Le texte généré a dépassé la valeur du champ de max_tokens saisie ou a dépassé le nombre maximum de jetons pris en charge par le modèle. '.

    • stop_sequence — Le modèle a généré l'une des séquences d'arrêt que vous avez spécifiées dans le champ de stop_sequences saisie.

  • stop_sequence — La séquence d'arrêt qui a mis fin à la génération.

  • type — Type de réponse. La valeur est toujours message.

  • role — Le rôle conversationnel du message généré. La valeur est toujours assistant.

  • content — Le contenu généré par le modèle. Renvoyé sous forme de tableau. Il existe trois types de contenu : text, tool_use et image.

    • text — Une réponse textuelle.

      • type : type de contenu. Cette valeur est text.

      • text — Si la valeur de type est du texte, contient le texte du contenu.

    • utilisation de l'outil — Demande du modèle d'utiliser un outil.

      • type : type de contenu. Cette valeur est tool_use.

      • id — L'ID de l'outil dont le modèle demande l'utilisation.

      • name — Contient le nom de l'outil demandé.

      • input — Les paramètres d'entrée à transmettre à l'outil.

    • Image — Demande du modèle d'utiliser un outil.

      • type : type de contenu. Cette valeur est image.

  • usage — Conteneur contenant le nombre de jetons que vous avez fournis dans la demande et le nombre de jetons générés par le modèle dans la réponse.

    • input_tokens — Le nombre de jetons d'entrée contenus dans la demande.

    • output_tokens — Le nombre de jetons générés par le modèle dans la réponse.

    • stop_sequence — Le modèle a généré l'une des séquences d'arrêt que vous avez spécifiées dans le champ de stop_sequences saisie.

Claude 3.7 Sonnet possède les paramètres d'inférence suivants pour un appel d'inférence de messages.

{ "anthropic_version": "bedrock-2023-05-31", "anthropic_beta": ["computer-use-2025-01-24"] "max_tokens": int, "system": string, "messages": [ { "role": string, "content": [ { "type": "image", "source": { "type": "base64", "media_type": "image/jpeg", "data": "content image bytes" } }, { "type": "text", "text": "content text" } ] } ], "temperature": float, "top_p": float, "top_k": int, "tools": [ { "type": "custom", "name": string, "description": string, "input_schema": json }, { "type": "computer_20250212", "name": "computer", "display_height_px": int, "display_width_px": int, "display_number": 0 int }, { "type": "bash_20250124", "name": "bash" }, { "type": "text_editor_20250124", "name": "str_replace_editor" } ], "tool_choice": { "type" : string, "name" : string, }, "stop_sequences": [string] }

Les paramètres suivants sont obligatoires.

  • anthropic_version — (Obligatoire) La version anthropique. La valeur doit êtrebedrock-2023-05-31.

  • anthropic_beta — (Obligatoire, si vous utilisez l'API d'utilisation de l'ordinateur) La version bêta anthropique à utiliser. Pour utiliser l'API d'utilisation de l'ordinateur, la valeur doit êtrecomputer-use-2024-10-22. anthropic_betadevrait également avoir le output-128k-2025-02-19 paramètre pour une longueur de contexte étendue.

  • max_tokens — (Obligatoire) Le nombre maximum de jetons à générer avant l'arrêt.

    Notez que Anthropic Claude les modèles peuvent arrêter de générer des jetons avant d'atteindre la valeur demax_tokens. Différent Anthropic Claude les modèles ont des valeurs maximales différentes pour ce paramètre. Pour plus d'informations, consultez la section Comparaison des modèles.

  • messages — (Obligatoire) Les messages d'entrée.

    • rôle — Le rôle du tour de conversation. Les valeurs valides sont user et assistant.

    • content — (obligatoire) Le contenu de la conversation prend la forme d'un ensemble d'objets. Chaque objet contient un champ de type dans lequel vous pouvez spécifier l'une des valeurs suivantes :

      • text— Si vous spécifiez ce type, vous devez inclure un champ de texte et spécifier l'invite de texte comme valeur. Si un autre objet du tableau est une image, cette invite de texte s'applique aux images.

      • image— Si vous spécifiez ce type, vous devez inclure un champ source qui correspond à un objet avec les champs suivants :

        • type — (obligatoire) Type de codage de l'image. Vous pouvez le spécifierbase64.

        • media_type — (obligatoire) Le type de l'image. Vous pouvez définir les formats d'image suivants.

          • image/jpeg

          • image/png

          • image/webp

          • image/gif

        • data — (obligatoire) Les octets de l'image codés en base64 pour l'image. La taille maximale de l'image est de 3,75 Mo. La hauteur et la largeur maximales d'une image sont de 8 000 pixels.

      • réflexion — Claude montrera son processus de raisonnement par le biais de blocs de thinking contenu contenus dans la réponse. thinkingn'est pas compatible avec les modifications de température, top_p ou top_k, ni avec l'utilisation forcée d'outils.

      • redacted_thinking — Lorsque le raisonnement interne de Claude est signalé par des systèmes de sécurité automatisés, le bloc de réflexion est crypté et vous est renvoyé sous forme de bloc redacted_thinking.

Les paramètres suivants sont facultatifs.

  • system — (Facultatif) L'invite du système à saisir la demande.

    Une invite du système est un moyen de fournir du contexte et des instructions à Anthropic Claude, par exemple en spécifiant un objectif ou un rôle particulier. Pour plus d'informations, consultez la section Instructions système dans le Anthropic .

    Note

    Vous pouvez utiliser les instructions du système avec Anthropic Claude version 2.1 ou supérieure.

  • stop_sequences — (Facultatif) Séquences de texte personnalisées qui empêchent la génération du modèle. Anthropic Claude les modèles s'arrêtent normalement lorsqu'ils ont naturellement terminé leur tour, dans ce cas, la valeur du champ de stop_reason réponse estend_turn. Si vous souhaitez que le modèle cesse de générer lorsqu'il rencontre des chaînes de texte personnalisées, vous pouvez utiliser le stop_sequences paramètre. Si le modèle rencontre l'une des chaînes de texte personnalisées, la valeur du champ de stop_reason réponse est stop_sequence et la valeur de stop_sequence contient la séquence d'arrêt correspondante.

    Le nombre maximum d'entrées est de 8191.

  • température — (Facultatif) La quantité de caractère aléatoire injectée dans la réponse.

    Par défaut Minimum Maximum

    1

    0

    1

  • top_p — (Facultatif) Utilisez l'échantillonnage du noyau.

    Lors de l'échantillonnage du noyau, Anthropic Claude calcule la distribution cumulée de toutes les options pour chaque jeton suivant dans l'ordre décroissant de probabilité et la coupe une fois qu'il atteint une probabilité particulière spécifiée partop_p. Vous devez modifier l'un temperature ou l'autretop_p, mais pas les deux.

    Par défaut Minimum Maximum

    0,999

    0

    1

  • top_k — (Facultatif) Échantillonnez uniquement les K meilleures options pour chaque jeton suivant.

    top_kÀ utiliser pour supprimer les réponses à faible probabilité à longue queue.

    Par défaut Minimum Maximum

    Désactivé par défaut

    0

    500

  • outils — (Facultatif) Définitions des outils que le modèle peut utiliser.

    Note

    Nécessite un Anthropic Claude Modèle 3.

    Si vous l'incluez tools dans votre demande, le modèle peut renvoyer des blocs de tool_use contenu représentant l'utilisation de ces outils par le modèle. Vous pouvez ensuite exécuter ces outils à l'aide de l'entrée d'outil générée par le modèle, puis éventuellement renvoyer les résultats au modèle à l'aide de blocs de tool_result contenu.

    Vous pouvez transmettre les types d'outils suivants :

    Personnalisé

    Définition d'un outil personnalisé.

    • type (facultatif) : type de l'outil. Si elle est définie, utilisez la valeurcustom.

    • name — Le nom de l'outil.

    • description — (facultatif, mais fortement recommandé) Description de l'outil.

    • input_schema — Schéma JSON de l'outil.

    Ordinateur

    Définition de l'outil informatique que vous utilisez avec l'API d'utilisation de l'ordinateur.

    • type — La valeur doit êtrecomputer_20250212.

    • name — La valeur doit êtrecomputer.

    • (Obligatoire) display_height_px — Hauteur de l'écran contrôlée par le modèle, en pixels.

      Par défaut Minimum Maximum

      Aucun

      1

      Pas de maximum

    • (Obligatoire) display_width_px — Largeur de l'affichage contrôlée par le modèle, en pixels.

      Par défaut Minimum Maximum

      Aucun

      1

      Pas de maximum

    • (Facultatif) display_number — Le numéro d'affichage à contrôler (pertinent uniquement pour les environnements X11). Si cela est spécifié, un numéro d'affichage sera fourni à l'outil dans la définition de l'outil.

      Par défaut Minimum Maximum

      Aucun

      0

      N

    bash

    Définition de l'outil bash que vous utilisez avec l'API d'utilisation de l'ordinateur.

    • type (facultatif) — La valeur doit êtrebash_20250124.

    • nom — La valeur doit êtrebash. l'outil.

    éditeur de texte

    Définition de l'outil d'édition de texte que vous utilisez avec l'API d'utilisation de l'ordinateur.

    • type (facultatif) — La valeur doit êtretext_editor_20250124.

    • nom — La valeur doit êtrestr_replace_editor. l'outil.

  • tool_choice — (Facultatif) Spécifie comment le modèle doit utiliser les outils fournis. Le modèle peut utiliser un outil spécifique, n'importe quel outil disponible, ou décider par lui-même.

    Note

    Nécessite un Anthropic Claude Modèle 3.

    • type — Le type d'outil choisi. Les valeurs possibles sont any (utiliser n'importe quel outil disponible), auto (c'est le modèle qui décide) et tool (utiliser l'outil spécifié).

    • name — (Facultatif) Le nom de l'outil à utiliser. Obligatoire si vous le spécifiez tool dans le type champ.

ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.