Uso estricto de herramientas

Establecer strict: true en una definición de herramienta garantiza que las entradas de herramientas de Claude coincidan con tu JSON Schema al restringir el muestreo de tokens del modelo a salidas válidas según el esquema (una técnica llamada "grammar-constrained sampling" (muestreo restringido por gramática)). Esta página cubre por qué el modo estricto es importante para los agentes, cómo habilitarlo y casos de uso comunes. Para el subconjunto de JSON Schema compatible, consulta Limitaciones de JSON Schema. Para orientación sobre esquemas no estrictos, consulta Definir herramientas.

El uso estricto de herramientas valida los parámetros de las herramientas, 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 agénticos
• Asegurar llamadas a funciones con tipos seguros
• Manejar herramientas complejas con propiedades anidadas



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

Construir sistemas agénticos confiables requiere conformidad garantizada con el esquema. Sin el modo estricto, Claude podría devolver tipos incompatibles ("2" en lugar de 2) u omitir campos requeridos, rompiendo tus funciones y causando errores en tiempo de ejecución.

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

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

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



Inicio rápido

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-opus-4-8",
    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 tool use con entradas validadas en response.content[x].input

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

Garantías:

• El input de la herramienta sigue estrictamente el input_schema
• El name de la herramienta siempre es válido (de las 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 las herramientas en gramáticas usando el mismo pipeline que las salidas estructuradas. Los esquemas de herramientas se almacenan temporalmente en caché hasta por 24 horas desde su ú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 esquemas de herramientas. La API almacena en caché los esquemas compilados por separado del contenido de los mensajes, 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 de los mensajes (prompts y respuestas), donde está protegida bajo las salvaguardas de HIPAA.

Para la elegibilidad de ZDR y HIPAA en todas las funcionalidades, consulta API y retención de datos.



Próximos pasos