Claude Platform Docs
MessagesOutils

Utilisation d’outils stricte

Imposez la conformité au JSON Schema des entrées d’outils de Claude grâce à l’échantillonnage contraint par grammaire.

Définir strict: true dans une définition d’outil garantit que les entrées d’outils de Claude correspondent à votre JSON Schema en contraignant l’échantillonnage des tokens du modèle à des sorties valides selon le schéma (une technique appelée « grammar-constrained sampling » (échantillonnage contraint par grammaire)). Cette page explique pourquoi le mode strict est important pour les agents, comment l’activer, ainsi que les cas d’utilisation courants. Pour le sous-ensemble de JSON Schema pris en charge, consultez Limitations du JSON Schema. Pour des conseils sur les schémas non stricts, consultez Définir des outils.

L’utilisation stricte des outils valide les paramètres des outils, garantissant que Claude appelle vos fonctions avec des arguments correctement typés. Utilisez l’utilisation stricte des outils lorsque vous devez :

  • Valider les paramètres des outils
  • Construire des workflows agentiques
  • Garantir des appels de fonctions à typage sûr
  • Gérer des outils complexes avec des propriétés imbriquées

Pourquoi l’utilisation stricte des outils est importante pour les agents

Construire des systèmes agentiques fiables exige une conformité garantie au schéma. Sans le mode strict, Claude pourrait renvoyer des types incompatibles ("2" au lieu de 2) ou omettre des champs obligatoires, ce qui casserait vos fonctions et provoquerait des erreurs d’exécution.

L’utilisation stricte des outils garantit des paramètres à typage sûr :

  • Des arguments de fonction correctement typés à chaque fois
  • Aucun besoin de valider et de relancer les appels d’outils
  • Des agents prêts pour la production qui fonctionnent de manière cohérente à grande échelle

Par exemple, supposons qu’un système de réservation ait besoin de passengers: int. Sans le mode strict, Claude pourrait fournir passengers: "two" ou passengers: "2". Avec strict: true, la réponse contient toujours passengers: 2.

Démarrage rapide

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "strict": True,  # Enable strict mode
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA",
                    },
                    "unit": {
                        "type": "string",
                        "enum": ["celsius", "fahrenheit"],
                        "description": "The unit of temperature, either 'celsius' or 'fahrenheit'",
                    },
                },
                "required": ["location"],
                "additionalProperties": False,
            },
        }
    ],
)
print(response.content)

Format de réponse : Blocs d’utilisation d’outils avec des entrées validées dans response.content[x].input

Output
{
  "type": "tool_use",
  "name": "get_weather",
  "input": {
    "location": "San Francisco, CA"
  }
}

Garanties :

  • L’input de l’outil respecte strictement l’input_schema
  • Le name de l’outil est toujours valide (issu des outils fournis ou des outils serveur)

Fonctionnement

  1. Définissez le schéma de votre outil

    Créez un schéma JSON pour l’input_schema de votre outil. Le schéma utilise le format JSON Schema standard avec certaines limitations (consultez Limitations du JSON Schema).

  2. Ajoutez strict: true

    Définissez "strict": true comme propriété de premier niveau dans votre définition d’outil, aux côtés de name, description et input_schema.

  3. Gérez les appels d’outils

    Lorsque Claude utilise l’outil, le champ input du bloc tool_use respecte strictement votre input_schema, et le name est toujours valide.

Les entrées d’ensemble d’outils de l’utilisation de l’ordinateur et de l’utilisation du navigateur (computer_toolset_20260801 et browser_toolset_20260801) n’acceptent pas strict: true ; une requête qui le définit sur l’une ou l’autre de ces entrées est rejetée.

Cas d’utilisation courants

Conservation des données

L’utilisation stricte des outils compile les définitions input_schema des outils en grammaires à l’aide du même pipeline que les sorties structurées. Les schémas d’outils sont temporairement mis en cache pendant 24 heures au maximum depuis leur dernière utilisation. Les prompts et les réponses ne sont pas conservés au-delà de la réponse de l’API.

L’utilisation stricte des outils est éligible HIPAA, mais les informations de santé protégées (PHI) ne doivent pas être incluses dans les définitions de schémas d’outils. L’API met en cache les schémas compilés séparément du contenu des messages, et ces schémas mis en cache ne bénéficient pas des mêmes protections PHI que les prompts et les réponses. N’incluez pas de PHI dans les noms de propriétés de l’input_schema, les valeurs enum, les valeurs const ou les expressions régulières pattern. Les PHI ne doivent apparaître que dans le contenu des messages (prompts et réponses), où elles sont protégées par les garanties HIPAA.

Étapes suivantes

Récupérez et lisez le contenu d’URL spécifiques pour intégrer du contenu web en direct dans le contexte de Claude.

Mettez en cache les définitions d’outils entre les tours pour réduire les coûts et la latence.

Obtenez des réponses JSON validées grâce au même échantillonnage contraint par grammaire.

Spécifiez les schémas d’outils, rédigez des descriptions efficaces et contrôlez quand Claude appelle vos outils.

Disponibilité

Utilisation d’outils stricte
Les conditions de disponibilité de Utilisation d’outils stricte sont les mêmes sur toutes les plateformes prises en charge.
API
  • Messages API
Modèles
  • Tous les modèles

Points de terminaison concernés

  • /v1/messages
Zéro conservation des donnéesÉligible (sous conditions)

Exclut Modèles couverts

Vos prompts et les sorties de Claude ne sont pas stockés. Seul le JSON Schema est mis en cache, pendant 24 heures au maximum après sa dernière utilisation. Cela couvre également l’utilisation d’outils stricte (strict: true sur les outils), qui utilise le même pipeline de grammaire. En savoir plus

HIPAAÉligible

Les PHI ne doivent pas être incluses dans les définitions de JSON Schema ; consultez les consignes de traitement des PHI. En savoir plus

Cette page vous a-t-elle été utile ?