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.
Rubriques
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_tokens
est 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 penser
budget_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 :
-
L'utilisateur envoie le message initial.
-
L'assistant répond par des blocs de réflexion et des demandes d'outils.
-
L'utilisateur envoie un message avec les résultats de l'outil.
-
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).
-
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)
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_use
actions 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)
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-beta
infé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 autonome
text_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
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 être
bedrock-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 être
computer-use-2024-10-22
.anthropic_beta
devrait également avoir leoutput-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 de
max_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
etassistant
.-
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écifier
base64
. -
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.thinking
n'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 lestop_sequences
paramètre. Si le modèle rencontre l'une des chaînes de texte personnalisées, la valeur du champ destop_reason
réponse eststop_sequence
et la valeur destop_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 par
top_p
. Vous devez modifier l'untemperature
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 detool_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 detool_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 valeur
custom
. -
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 être
computer_20250212
. -
name — La valeur doit être
computer
. -
(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 être
bash_20250124
. -
nom — La valeur doit être
bash
. 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 être
text_editor_20250124
. -
nom — La valeur doit être
str_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) ettool
(utiliser l'outil spécifié).
-
name — (Facultatif) Le nom de l'outil à utiliser. Obligatoire si vous le spécifiez
tool
dans letype
champ.
-