Uso estricto de herramientas

Establecer strict: true en una definición de herramienta utiliza muestreo restringido por gramática para garantizar que las entradas de herramientas de Claude coincidan con tu JSON Schema. Esta página cubre por qué el modo estricto es importante para agentes, cómo habilitarlo y casos de uso comunes. Para el subconjunto de JSON Schema compatible, consulta Limitaciones de JSON Schema. Para orientación de esquema no estricto, consulta Definir herramientas.

El uso estricto de herramientas valida los parámetros de la herramienta, asegurando que Claude llame a tus funciones con argumentos correctamente tipados. Usa el uso estricto de herramientas cuando necesites:

• Validar parámetros de herramientas
• Construir flujos de trabajo de agentes
• Garantizar llamadas de función seguras en tipos
• Manejar herramientas complejas con propiedades anidadas

Por qué el uso estricto de herramientas es importante para agentes

Construir sistemas de agentes confiables requiere conformidad de esquema garantizada. Sin modo estricto, Claude podría devolver tipos incompatibles ("2" en lugar de 2) o campos requeridos faltantes, rompiendo tus funciones y causando errores en tiempo de ejecución.

El uso estricto de herramientas garantiza parámetros seguros en tipos:

• Las funciones reciben argumentos correctamente tipados cada vez
• No hay necesidad de validar y reintentar llamadas de herramientas
• Agentes listos para producción que funcionan consistentemente a escala

Por ejemplo, supongamos que un sistema de reservas necesita passengers: int. Sin modo estricto, Claude podría proporcionar passengers: "two" o passengers: "2". Con strict: true, la respuesta siempre contendrá passengers: 2.

Inicio rápido

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-7",
    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)

Formato de respuesta: Bloques de uso de herramientas con entradas validadas en response.content[x].input

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

Garantías:

• La input de la herramienta sigue estrictamente el input_schema
• El name de la herramienta siempre es válido (de herramientas proporcionadas o herramientas del servidor)

Cómo funciona

Casos de uso comunes

Retención de datos

El uso estricto de herramientas compila las definiciones de input_schema de herramientas en gramáticas utilizando el mismo pipeline que salidas estructuradas. Los esquemas de herramientas se almacenan temporalmente en caché durante hasta 24 horas desde el último uso. Los prompts y las respuestas no se retienen más allá de la respuesta de la API.

El uso estricto de herramientas es elegible para HIPAA, pero la PHI no debe incluirse en las definiciones de esquema de herramientas. La API almacena en caché los esquemas compilados por separado del contenido del mensaje, y estos esquemas en caché no reciben las mismas protecciones de PHI que los prompts y las respuestas. No incluyas PHI en los nombres de propiedades de input_schema, valores de enum, valores de const o expresiones regulares de pattern. La PHI solo debe aparecer en el contenido del mensaje (prompts y respuestas), donde está protegida bajo las salvaguardas de HIPAA.

Para la elegibilidad de ZDR e HIPAA en todas las características, consulta Retención de datos y API.